Skip to main content
This walks through Level 1, the commits-only level. 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, so copy it before you continue.
2

Install the Reality Harness MCP

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:
Or, with the Claude Code CLI:
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 (it 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.

Remote MCP endpoint

Skip the install entirely and connect any MCP client straight to api.conquoreum.com/mcp.

Tool reference

All 8 local MCP tools, in detail.

Scopes reference

What each API key scope unlocks.