Skip to main content
This walks through Level 1 — commits only. It’s the fastest path to seeing real XP, and everything here still works once you add Level 2 or Level 3 later.
1

Mint an API key

Go to app.conquoreum.com/deck/setup and sign in. The setup wizard mints a scoped key for you — see Minting your first API key if you want the full walkthrough. The key looks like cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx and is shown to you exactly once — copy it before you continue.
2

Install the Reality Harness MCP

git clone <your reality-harness-mcp repo>
cd reality-harness-mcp
npm install
npm run build
Requires Node 18 or newer.
3

Add it to your MCP client

Paste into claude_desktop_config.json (Claude Desktop) or your project’s .mcp.json (Claude Code), replacing the path with your actual clone’s dist/index.js:
{
  "mcpServers": {
    "reality-harness": {
      "command": "node",
      "args": ["/absolute/path/to/reality-harness-mcp/dist/index.js"],
      "env": {
        "CONQUOREUM_CONVEX_URL": "https://api.conquoreum.com",
        "CONQUOREUM_API_TOKEN": "cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
Or, with the Claude Code CLI:
claude mcp add reality-harness node \
  /absolute/path/to/reality-harness-mcp/dist/index.js \
  -e CONQUOREUM_CONVEX_URL='https://api.conquoreum.com' \
  -e CONQUOREUM_API_TOKEN='cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
4

Connect a folder and see your first XP

Ask your MCP client to call reality_harness_connect_folder on a repo you work in (must have a .git or docs/ folder, and live under your home directory). From there, reality_harness_submit_progress reports your commits and completed planning checkboxes to Conquoreum, and XP shows up in the Throne Room.
If CONQUOREUM_CONVEX_URL or CONQUOREUM_API_TOKEN is unset, the MCP runs in mock mode — every tool still works, but nothing is sent to Conquoreum. Good for trying it out before you mint a real key.

​
Go further

Level 2 — + Outcomes

Submit a real payment, release, or evaluation for bonus XP.

Level 3 — + Board sync

Sync an Obsidian task board into the Throne Room checklist.

Tool reference

All 8 MCP tools, in detail.

Scopes reference

What each API key scope unlocks.