Model Context Protocol (MCP) Quickstart

Connect your local AI agents (Claude Desktop, Cursor, AutoGPT) directly to live exchange order flow via the official BitCLI MCP Server.

---

1. Agentic Economy (HTTP 402)

BitCLI implements a Machine-to-Machine (M2M) billing model using the HTTP 402 Payment Required standard. Your AI agent is charged in micro-cents (via Lightning Network or TON) per individual API call. You don't need a monthly subscription—your agent pays only for the exact data it consumes during its trading loop.

---

2. Core Tools Exposed

get_market_intel

Returns institutional market state (Aggregated OI, RVOL, CVD, Funding) for any ticker:

{
  "command": "get_market_intel",
  "coin": "BTC"
}

get_top_radars

Allows your agent to scan the entire market for anomalies without downloading raw candle data.

{
  "command": "get_top_radars",
  "category": "squeeze" // or "whales", "heat", "volatility"
}

create_alert

Allows your agent to programmatically set real-time triggers on the C++ core:

{
  "command": "btc 95k"
}

---

3. System Prompt Recipe

Paste this into your trading agent or Cursor system prompt:

You are an institutional crypto quantitative trader.
Before suggesting any perp trade setup, ALWAYS call the `get_market_intel` tool to check the asset's RVOL and CVD slope.
To find daily opportunities, query the `get_top_radars` tool with category "whales" or "squeeze".
Never calculate position size manually; use the `calculate_position_size` tool.