Claude Code

Claude Code is the reference MCP host. Install all three servers with claude mcp add:

claude mcp add context --env PROMETHEUS_API_KEY=prom_live_… -- npx -y @prom.codes/context-mcp@latest
claude mcp add memory  --env PROMETHEUS_API_KEY=prom_live_… -- npx -y @prom.codes/memory-mcp@latest
claude mcp add saver -- npx -y @prom.codes/saver@latest

The -- separator is required before the command. Repeat --env KEY=val per variable. The context and memory servers need your PROMETHEUS_API_KEY; the saver needs no key.

Get a key

Both context (managed code embeddings via the api.prom.codes proxy) and memory are unlocked by one prom_live_… key. Sign in at app.prom.codes → /app/api-keys → mint a key, then paste it into the commands above.

Run setup for the saver

The saver builds no index and needs no key. Once it's registered, ask the agent to run setup once per workspace — see Token Saver.

Optional: .mcp.json

Instead of the CLI you can drop a committable .mcp.json at the project root (this is not claude_desktop_config.json):

{
  "mcpServers": {
    "context": { "type": "stdio", "command": "npx", "args": ["-y", "@prom.codes/context-mcp@latest"], "env": { "PROMETHEUS_API_KEY": "prom_live_…" } },
    "memory":  { "type": "stdio", "command": "npx", "args": ["-y", "@prom.codes/memory-mcp@latest"],  "env": { "PROMETHEUS_API_KEY": "prom_live_…" } },
    "saver":   { "type": "stdio", "command": "npx", "args": ["-y", "@prom.codes/saver@latest"] }
  }
}

Cursor uses .cursor/mcp.json and VS Code uses .vscode/mcp.json — same JSON shape.

Scopes

claude mcp add writes to local scope by default (just you). Add --scope project to write the committable .mcp.json above (shared with the team), or --scope user to enable the server across all your projects.

Manage servers with claude mcp list, claude mcp get <name>, claude mcp remove <name>, or /mcp inside a session.

No workspace root needed

PROMETHEUS_WORKSPACE_ROOT is auto-detected and optional — Claude Code passes the open project automatically. Set it only to point a server at a different folder. The databases are auto-defaulted too: the code index lives at ~/.prometheus/<workspace-hash>.db and memory at ~/.prometheus/memory.db; PROMETHEUS_DB_PATH / PROMETHEUS_MEMORY_DB_PATH are optional overrides.

What tools become available

The context server exposes ten tools (search_code, get_symbol, find_references, …) — see MCP tools. The memory server exposes seven (memory_read, memory_write, memory_capture, memory_search, memory_list, memory_delete, memory_setup) — see Agent Memory. The saver exposes one (setup) — see Token Saver.