Plug Claude into the live
Clanker & Base token terminal.

Installation

# 1. install runtime deps (one-time)
pip install mcp httpx python-dotenv

# 2. download the proxy (drop it anywhere on disk)
curl -fsSL -o compass_mcp.py https://compassterminal.com/install/compass_mcp.py

{
  "mcpServers": {
    "compass": {
      "command": "python",
      "args": ["/absolute/path/to/compass_mcp.py"],
      "env": {
        "COMPASS_API_KEY": "cmp_your_key_here",
        "COMPASS_BACKEND_URL": "https://compassterminal.com"
      }
    }
  }
}

{
  "mcpServers": {
    "compass": {
      "command": "python",
      "args": ["/absolute/path/to/compass_mcp.py"],
      "env": {
        "COMPASS_API_KEY": "cmp_your_key_here",
        "COMPASS_BACKEND_URL": "https://compassterminal.com"
      }
    }
  }
}

claude mcp add compass \
  --env COMPASS_API_KEY=cmp_your_key_here \
  --env COMPASS_BACKEND_URL=https://compassterminal.com \
  -- python /absolute/path/to/compass_mcp.py

curl -X POST https://compassterminal.com/api/mcp/playground/execute \
  -H "Authorization: Bearer cmp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "compass_get_price",
    "arguments": {"symbol": "BTC"}
  }'

COMPASS_API_KEY=cmp_your_key_here \
COMPASS_BACKEND_URL=https://compassterminal.com \
python /absolute/path/to/compass_mcp.py

SIWE-Issued API Keys

Authorization: Bearer cmp_live_xxxxxxxxxxxxxxxxxxxxxxxx

Try It: Morning Briefing

Use compass_full_briefing to give me a 30-second
read on the Base desk this morning.

Claude will call compass_full_briefing, which fans out to compass_quick_scan + compass_get_positions + compass_onchain + compass_news in parallel and asks COMPASS AI to summarise.

Parallel fan-out tools

High-level tools that call several primitives in parallel and stitch the result through COMPASS AI.

Clanker & Base Token Tools (11)

Live Base data via Base RPC + indexer. Most need a mint param (Base contract address).

Portfolio & Account (11)

Tools touching account state need a logged-in wallet. Read-only data tools work for any auth'd key.

Pulled from /api/mcp/tools

Loaded at MCP boot from GET /api/mcp/tools. Names rebranded bastion_* → compass_* for the agent UI; backend still called by original name.

Derivatives (9)

Macro (6)

Strategy (6)

Analytics (5)

Research (4)

Other (13)

Rate Limits

Error Codes

Recent Changes

• 2026-05-12Boot banner glow-up — Phase 02 now probes 6 global data regions live (Helsinki, Frankfurt, Singapore, Tokyo, New York, São Paulo) and Phase 03 lists every one of the 73 tools by name on startup.
• 2026-05-12compass_chat now falls back gracefully when COMPASS_MODEL_URL is unset — routes through the same /api/neural/chat path the web AI Terminal uses (auto-injects 30+ live data feeds).
• 2026-05-12Clanker / Base CA viewer on /lab — paste a contract address, see a Dexscreener chart in the chart-card slot. window.compassLoadCaChart(mint) exposed for quickbuy integrations.
• 2026-05-12Dynamic backend catalog folded into boot — /api/mcp/tools auto-registers 47 derivatives / macro / analytics tools on top of the 26 hardcoded compass_* tools (= 73 total).
• 2026-05-12Install docs now show the real stdio config — command + args + env. Previous url shape returned 404.
• 2026-05-08Token-bucket rate limiter shipped. Per-key 60/min, anon 10/min.
• 2026-05-08Wallet SIWE-issued cmp_* keys now recommended. bst_* still accepted.
• 2026-05-07/api/neural/chat graceful-degradation wrapper — 200 + degraded:true instead of 500.
• 2026-05-06Base mint-feed filter relaxed — Clanker launches with dev pre-buys no longer dropped.
• 2026-05-01Lab promoted to canonical /lab. /terminal 301-redirects.