Metadata-Version: 2.4
Name: moveo-one-mcp
Version: 0.1.0
Summary: Moveo One MCP server — integrate, verify, analyze, and simulate from your AI assistant.
Project-URL: Homepage, https://www.moveo.one
Project-URL: Documentation, https://docs.moveo.one
Project-URL: Changelog, https://github.com/divstechnologydev/hound-moveo-one-mcp/releases
Author: Moveo One / DIVS Technology
License: Proprietary
License-File: LICENSE
Keywords: analytics,mcp,model-context-protocol,moveo
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: mcp<2,>=1.12.0
Requires-Dist: pydantic-settings>=2.5.0
Requires-Dist: pydantic>=2.9.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Provides-Extra: remote
Requires-Dist: gunicorn>=23.0.0; extra == 'remote'
Requires-Dist: starlette>=0.41.0; extra == 'remote'
Requires-Dist: uvicorn>=0.32.0; extra == 'remote'
Description-Content-Type: text/markdown

# Moveo One MCP

A [Model Context Protocol](https://modelcontextprotocol.io) server for
[Moveo One](https://www.moveo.one) — behavioural intelligence for digital products.

Point Claude Desktop, Claude Code, Cursor, or any MCP client at your Moveo One
workspace and it can integrate the SDK into your codebase, verify events are
arriving, answer questions about your analytics, and build cohorts to run Quantum
simulations against your app.

## Install

```bash
uvx moveo-one-mcp login
```

That opens your browser to approve access. Credentials are cached in your OS
keychain (falling back to a `0600` file at `~/.moveo/credentials.json`).

Then register the server with your MCP client. Claude Desktop
(`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "moveo-one": {
      "command": "uvx",
      "args": ["moveo-one-mcp"]
    }
  }
}
```

Claude Code:

```bash
claude mcp add moveo-one -- uvx moveo-one-mcp
```

You need a Moveo One account — sign up at [app.moveo.one](https://app.moveo.one).

## What it can do

**Integrate** — `detect_stack` scans your project and recommends an approach;
`add_sdk_snippet` inserts the SDK for script-tag and npm projects; `advise_gtm`,
`advise_segment` and `advise_posthog` return exact configuration for tools that
live outside your codebase. `get_integration_guide` links the right docs page.

**Verify** — `check_events_arriving` confirms data is reaching Moveo One;
`watch_events` and `get_watch_status` wait for the first event after you deploy.

**Analyze** — `get_overview`, `list_dashboard_plots`, `get_plot`, `refresh_plot`,
and `ask_analytics` for natural-language questions over your data.

**Simulate** — `create_cohort`, `discover_for_cohort`, `calibrate_cohort`, then
`run_simulation` to drive synthetic behavioural cohorts against your app.
`list_runs`, `get_simulation_status`, `list_sessions` and `get_session_screenshots`
follow a run; simulations take hours, so the assistant polls.

**Models** — `list_prediction_models`, `get_prediction_model`,
`get_prediction_model_metrics`.

Two guided prompts, `onboard` and `test_my_app`, walk through the common flows.

Run `whoami` to check your connection and `list_projects` to see what you can
reach. Most tools require a connected account; `detect_stack` and
`get_integration_guide` work offline.

## Configuration

| Variable | Default | Meaning |
|---|---|---|
| `MOVEO_ENV` | `prod` | `prod`, `dev`, or `local` — selects backend and app URLs |
| `MOVEO_API_BASE_URL` | derived from `MOVEO_ENV` | Override the backend URL |
| `MOVEO_REQUEST_TIMEOUT_SECONDS` | `75` | Per-request HTTP timeout |

Set these in the `env` block of your MCP client's server entry.

`moveo-one-mcp logout` clears stored credentials for the current environment.

## Hosted server

A hosted version is available at `https://hound.moveo.one` for clients that
support remote MCP servers over streamable HTTP with OAuth 2.1. It offers the
same tools minus the ones that read and write your local filesystem.

## Links

- [Documentation](https://docs.moveo.one)
- [Moveo One](https://www.moveo.one)

## License

Proprietary — see [LICENSE](LICENSE).
