MCP

The explore agent (momentic ai explore) is deprecated. Mo now does the autonomous bug finding. Mo is in private beta, so sign up to get onboarded. To write tests from a code diff, use the MCP server with the momentic-spec skill.

Momentic’s MCP server is a local process that gives a coding agent a live browser or device and tools to browse, edit, run, and triage tests. This page covers the server: installation, the config for each client, and usage tips. The skills teach the agent which tools to call and in what order. Install both.

Requires Momentic CLI 2.54.0 or later.

Prerequisites

Momentic CLI installed locally (MCP runs on your machine)
A project with a valid momentic.config.yaml
A MOMENTIC_API_KEY available to the MCP process (most editors do not inherit your shell environment)

Setup instructions

The fastest path is install-mcp. It detects the coding agents on your machine and writes the server entry into each one’s config. Use momentic-mobile install-mcp for mobile projects; it registers a separate momentic-mobile server, so web and mobile can live in the same config.

npx momentic install-mcp

See momentic install-mcp for --client, --scope, and noninteractive use. The tabs below show the command for each client and the manual config it writes. Momentic’s MCP is a local stdio server. Every client ultimately runs one of these commands:

Web

npx momentic mcp --config /absolute/path/to/momentic.config.yaml

Mobile

npx momentic-mobile mcp --config /absolute/path/to/momentic.config.yaml

The tabs below show the web command. For a mobile project, replace momentic with momentic-mobile in the command and use momentic-mobile as the server name. See momentic mcp and momentic-mobile mcp for every supported flag (headful browser, pixel ratio, daemon mode, etc.).

After the server is registered, restart the client and start a new chat. Ask the agent which MCP tools are available. You should see momentic_* tools such as momentic_get_artifacts. If they do not appear, fully restart the client.

npx momentic install-mcp --client claude-code

Or register the server with the Claude Code CLI:

claude mcp add --transport stdio momentic -- npx momentic mcp --config /absolute/path/to/momentic.config.yaml

Verify with claude mcp list. On native Windows, wrap with cmd /c:

claude mcp add --transport stdio momentic -- cmd /c npx momentic mcp --config C:\path\to\momentic.config.yaml

Pass MOMENTIC_API_KEY via the CLI’s --env flag or by running the command from a shell that already has it exported. See Claude Code MCP docs for scoping and auth options. Run /mcp to confirm the server is active.

npx momentic install-mcp --client cursor

Or open the command palette, select View: Open MCP Settings, click Add a new Custom MCP server, then paste and restart Cursor:

{
  "mcpServers": {
    "momentic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "momentic",
        "mcp",
        "--config",
        "/absolute/path/to/momentic.config.yaml"
      ],
      "env": { "MOMENTIC_API_KEY": "your-api-key" }
    }
  }
}

npx momentic install-mcp --client vscode

Or open the command palette, select MCP: Add Server, pick Command (stdio), then paste:

npx momentic mcp --config /absolute/path/to/momentic.config.yaml

Name the server momentic when prompted. Then add MOMENTIC_API_KEY to the generated entry in mcp.json:

"momentic": {
  "env": { "MOMENTIC_API_KEY": "your-api-key" }
}

Your org may need to allow MCP. Copilot only exposes MCP in agent mode.

npx momentic install-mcp --client codex

Or register the server with the Codex CLI:

codex mcp add momentic -- npx momentic mcp --config /absolute/path/to/momentic.config.yaml

The command saves the entry to ~/.codex/config.toml. For project-scoped configs, edit .codex/config.toml in a trusted project. See Codex MCP docs for env vars and timeouts. Restart Codex, then run /mcp in the TUI to verify.

npx momentic install-mcp --client opencode

Or edit opencode.json in your project root or ~/.config/opencode/:

{
  "mcp": {
    "momentic": {
      "type": "local",
      "command": [
        "npx",
        "momentic",
        "mcp",
        "--config",
        "/absolute/path/to/momentic.config.yaml"
      ],
      "environment": { "MOMENTIC_API_KEY": "your-api-key" },
      "enabled": true
    }
  }
}

Follow the dedicated Devin integration page. Devin requires additional machine-configuration steps so it can install browsers, set ANDROID_HOME / JAVA_HOME, and pre-install skills before MCP starts.

install-mcp also supports gemini-cli, windsurf, zed, antigravity, and claude-desktop. Any other MCP-compatible client can launch the server with:

Command: npx
Arguments: momentic mcp --config /absolute/path/to/momentic.config.yaml (mobile: momentic-mobile mcp --config /absolute/path/to/momentic.config.yaml)
Env: MOMENTIC_API_KEY=your-api-key

Example prompts

After the server is registered, ask the agent for work that needs a live browser or device:

Which Momentic MCP tools are available?
Preview the steps in checkout.test.yaml and show me the screenshots
Run the login test and fix the failing step
Show the artifacts for run <run-id>

For longer jobs, invoke a skill by name. The skill tells the agent which tools to call and in what order.

Usage tips

Model: use the newest model your editor offers. High reasoning gives the best results; Medium is about 20% faster with some quality loss.
Invoke the relevant skill by name when authoring, maintaining, or changing product behavior.
Be specific in prompts. For exploratory runs, include a step limit.
Let sessions terminate: the agent calls momentic_session_terminate to close the browser. Hard-stopping your editor leaks browser processes.
Gitignore .momentic-mcp/. MCP stores screenshots, videos, and traces there.
Long-running steps: momentic_preview_step, momentic_preview_steps, and momentic_run_step wait 30 seconds by default, which you can change with timeoutSeconds. Work that takes longer continues in the background and the tool returns a stepRunnerId. Collect the result with momentic_poll_runner, and pass its own timeoutSeconds (0-30, default 0) to hold the poll open instead of busy-polling. Only one preview or run executes per session at a time.

Get started

Building with AI

Author

Run

Learn

Platforms

Integrations

Advanced

Migrations

Account

Prerequisites

Setup instructions

Example prompts

Usage tips

​Prerequisites

​Setup instructions

​Example prompts

​Usage tips

​Related

Prerequisites

Setup instructions

Example prompts

Usage tips

Related