For agents
Note:
You're an agent? Start here. Humans should use For humans and app.molar.it instead.
This path is for AI coding agents (Cursor, Claude Code, Codex, Windsurf, etc.) that need to register, connect MCP, and run scenarios without a human driving the browser first.
What agents can do today
| Capability | Before human verifies | After verify (claimed) |
|---|---|---|
| MCP read/run (scenarios, runs) | ✅ Limited scopes & rate caps | ✅ Full Free-tier scopes |
molar init, scenarios validate/compile | ✅ | ✅ |
Local clones (molar clone …) | ✅ | ✅ |
| Cloud clones via MCP | ❌ | ✅ (within plan entitlements) |
Debugger AI (mcp:debug) | ❌ | ❌ on Free — Team+ or BYOK |
| High-risk explore/act scopes | ❌ | ❌ — requires explicit OAuth consent |
Note:
Agent signup availability: POST https://api.molar.it/api/v1/agent-signup returns 503 when agent signup is disabled in production. If you hit 503, ask your human to sign up at app.molar.it and mint a PAT at Settings → API Tokens instead.
0. Read the index
Fetch docs.molar.it/llms.txt — canonical URLs for every public doc page, agent-first ordering.
1. Self-serve signup
Register without a pre-existing account:
molar agent signup \
--human-email alex@example.com \
--name "QA Assistant" \
--note-to-human "Please verify me so I can run checkout scenarios." \
--harness claude-code
Or via API: POST https://api.molar.it/api/v1/agent-signup
Full request/response reference: Agent self-serve signup.
Before human verification: token scopes are limited to mcp:read and mcp:run. Cloud clones, debugger AI, and high-risk explore/act scopes stay blocked until verify.
2. Human verification
The overseer (human_email) receives a 6-digit code (15-minute expiry). Submit it:
molar agent signup verify --code 483921
# or: POST /api/v1/agent-signup/verify
Check status anytime: molar agent signup status
After verify, scopes expand to the Free tier (mcp:read, mcp:write, mcp:run, mcp:clone:write, mcp:trace:read). The human shares the code from their email — there is no dashboard approval UI yet.
3. Connect MCP
| Transport | Endpoint | When |
|---|---|---|
| Remote HTTP | https://mcp.molar.cloud/mcp | Default — Cursor, Claude Code, Windsurf |
| Local stdio | molar mcp serve | Air-gapped; add --cloud-access for cloud tools via PAT |
One-click install: mcp.molar.cloud/install
Details: MCP server setup
4. Scaffold and run
molar init
molar scenarios validate && molar scenarios compile
molar run # requires Guard runner — run molar doctor first
Generate scenarios from a URL (MCP, not CLI):
molar_generate_scenarios_from_urlmolar_run_scenarios
Project config: .molar.md · Compiler: Scenario compiler
5. Credentials
| Method | Use |
|---|---|
Agent signup api_key | Stored in ~/.config/molar/config.toml after signup |
MOLAR_TOKEN env var | CI and scripts |
| Dashboard PAT | Human-minted at Settings → API Tokens — preferred for CI |
molar login --token molar_pat_xxxx validates against GET /api/v1/me and saves credentials locally.
Shipped CLI commands (today)
| Command | Purpose |
|---|---|
molar agent signup | Self-serve registration |
molar agent signup verify | Submit 6-digit code |
molar agent signup status | Claim status and scope restrictions |
molar init | Scaffold .molar/ project |
molar login | Save PAT to config (prompts if omitted) |
molar scenarios validate / compile | Lint and compile .molar.md |
molar run | Execute compiled scenarios (via Guard runner) |
molar clone <kind> --start|--stop | Local Stripe/Twilio/email/auth/S3 clones |
molar trace open | Open a trace in the browser |
molar mcp serve | Local stdio MCP server |
molar doctor | Dependency health check |
molar upgrade | Self-update |
Full reference: CLI reference
Per-product MCP entry points
| Product | Start with | Key tools |
|---|---|---|
| Cartographer | Cartographer MCP tools | molar_generate_scenarios_from_url, molar_compile_scenario |
| Guard | Guard quick start | molar_run_scenarios, molar_get_guard_status |
| Clones | Clones quick start | molar_clone_spawn, molar_clone_seed |
| Trace | Trace quick start | molar_replay_trace, molar_debug_run |