MCP server setup

Connect Cursor, Claude Code, and other MCP clients to Molar — remote Streamable HTTP and local stdio.

MCP server setup

╭────────────────────────────╮
│  🔌 Molar MCP              │
│  One install · all products │
╰────────────────────────────╯

Molar exposes Cartographer, Guard, Clones, and Trace as MCP tools so coding agents can generate scenarios, run tests, drive clones, and read traces without a custom integration.

No account yet? Agent self-serve

Coding agents can register without a dashboard login:

  1. Agent self-serve signup — POST /api/v1/agent-signup or molar agent signup
  2. Human verifies with a 6-digit email code
  3. Connect here via mcp.molar.cloud/install

Pre-verify tokens get mcp:read + mcp:run only. After verify, scopes expand to mcp:read, mcp:write, mcp:run, and mcp:trace:read on the Free tier. High-risk scopes (mcp:explore, mcp:act, mcp:identity, mcp:clone:write, mcp:debug) require explicit OAuth consent or a higher plan.

Human engineers should still use app.molar.it for billing, GitHub App install, and team invites.

TransportEndpointBest for
Remotehttps://mcp.molar.cloud/mcpCursor, Claude Desktop, Claude Code, Windsurf
Local stdiomolar mcp serveAir-gapped, local Clones, custom surfaces

One-click install

Visit mcp.molar.cloud/install.

ClientDeep link
Claude Desktopclaude://mcp/install?name=molar&url=https://mcp.molar.cloud/mcp
Cursorcursor://anysphere/mcp/install?name=molar&url=https://mcp.molar.cloud/mcp
Windsurfwindsurf://mcp/install?name=molar&url=https://mcp.molar.cloud/mcp

Manual JSON:

{
  "mcpServers": {
    "molar": { "url": "https://mcp.molar.cloud/mcp" }
  }
}

Cursor

Settings → MCP → add https://mcp.molar.cloud/mcp. Complete OAuth 2.1 + PKCE on first tool call.

Claude Code

claude mcp add --transport http molar https://mcp.molar.cloud/mcp

Local stdio

molar mcp serve

Optional flags: --cloud-access, --surfaces=cartographer,clones,guards,trace, --transport=http, --port=4200.

Client config:

{
  "mcpServers": {
    "molar-local": {
      "command": "molar",
      "args": ["mcp", "serve"]
    }
  }
}

Use --cloud-access for cloud-backed tools (failures, incidents, debugger) using credentials from ~/.config/molar/config.toml.

OAuth scopes

Nine scopes are defined in the auth layer. The consent screen lists all requested scopes.

ScopeAllows
mcp:readList/get scenarios, runs, guard status, clone sessions
mcp:writeGenerate, compile, review Mender PRs, monitor/repair flows
mcp:runExecute Guard scenario runs
mcp:clone:writeSpawn, seed, route, snapshot/restore, and stop cloud clones
mcp:trace:readReplay traces, read run trace resources
mcp:debugDebugger AI (molar_debug_run — billed per token)
mcp:exploreBrowse/map external sites (molar_explore_target, molar_map_site, …)
mcp:actState-changing actions on external sites (molar_run_task, molar_fill_form, …)
mcp:identityProvision test identities and read OTP/messages

Authorization server: https://api.molar.it. Protected resource: https://mcp.molar.cloud.

Tool catalog (sample)

ToolScopeDescription
molar_generate_scenarios_from_urlmcp:writeCartographer crawl
molar_run_scenariosmcp:runRun scenarios by glob
molar_replay_tracemcp:trace:readTrace replay
molar_clone_spawnmcp:clone:writeStart a cloud clone session
molar_get_guard_statusmcp:readProd monitoring health
molar_debug_runmcp:debugDebugger AI Q&A

Full manifest: 67 tools across Cartographer (46), Guard (12), Clones (7), and Trace (2) — one MCP install covers all four surfaces. High-risk tools (molar_explore_target, molar_run_task, molar_provision_identity, …) require the matching high-risk scope via OAuth consent.

Resources & prompts

Resources: molar://scenarios/{slug}, molar://runs/{id}, molar://runs/{id}/trace, molar://traces/{id}, molar://incidents/{id}, molar://mender/prs/{id}, molar://flows/{id}, molar://pages/{url}, molar://context-index

Prompts: fix_failing_tests, investigate_incident, summarize_guard_24h, generate_scenarios_feature

Rate limits

100 requests per 60 seconds per access token on the hosted MCP server. Org usage is also metered as mcp_call — see Billing at app.molar.it.