Skip to content
Spec{0}

Connect Claude Code

Add Spec0

In a terminal:

Terminal window
claude mcp add --transport http spec0 http://127.0.0.1:7474/mcp

That’s it. Claude Code writes the entry to ~/.claude.json and the next session you start will pick it up.

Or edit the JSON

If you prefer to edit the config directly, add this under mcpServers in ~/.claude.json (or in a project-scoped .mcp.json):

{
  "mcpServers": {
    "spec0": {
      "type": "http",
      "url": "http://127.0.0.1:7474/mcp"
    }
  }
}

streamable-http is also accepted as an alias for type if you’re copying from MCP spec docs.

Verify the connection

Inside a Claude Code session, ask the agent to run spec0_whoami. You should see:

{
  "ok": true,
  "agent": {
    "id": "agn_…",
    "kind": "claude-code",
    "displayName": "Claude"
  },
  "session": { "id": "…" },
  "claim": null
}

If whoami works, every other Spec0 tool will too.

Use it

Tell the agent what you want — “claim one card from the spec0 project”, “author a feature card for X” — and it will discover the right tool itself. The full catalog (spec0_list_claimable, spec0_claim, spec0_update_progress, spec0_record_commit, spec0_submit_result, …) appears in tools/list.

Manage and inspect

Terminal window
claude mcp list           # all configured servers
claude mcp get spec0      # details for the spec0 entry
claude mcp remove spec0   # disconnect