The CryptoDataAPI MCP server turns our whole REST API into native tools your AI agent can call: live prices, cross-exchange funding and open interest, liquidations, market-health and regime reads, Fear & Greed, macro, ETF and stablecoin flows, Hyperliquid perp prices, dealer gamma, whale activity and 2,000+ coin profiles — all behind a single API key.
Model Context Protocol (MCP) is an open standard that lets an agent discover and call external tools at runtime. Point any MCP client at https://cryptodataapi.com/mcp and it gets the full toolset automatically — no per-endpoint glue code.
Two ways to connect: the remote HTTP server (recommended — nothing to install, all logic runs on our side) or a local stdio bridge (the cryptodataapi-mcp npm package) for clients that only speak stdio. Pair the server with the Agent Skill — the skill teaches your agent *when and how* to use the data, the MCP server *provides* the live data.
https://cryptodataapi.com/mcp
Agent docs →
The remote server speaks streamable HTTP at https://cryptodataapi.com/mcp and authenticates with an X-API-Key: cdk_live_YOUR_KEY header. This is the recommended path — no Node, no package, and every tool call runs against our live stack (auth, tier gating, caching and rate limits all included).
Most clients take a one-line add command. Here it is for Claude Code; the exact form for each client is on its own page: Claude Code, Claude Desktop, Claude (web), Cursor, OpenAI Codex, Gemini CLI, Windsurf and GitHub Copilot.
claude mcp add --transport http cryptodataapi \ https://cryptodataapi.com/mcp \ --header "X-API-Key: cdk_live_YOUR_KEY"
{
"mcpServers": {
"cryptodataapi": {
"url": "https://cryptodataapi.com/mcp",
"headers": { "X-API-Key": "cdk_live_YOUR_KEY" }
}
}
}
If your client only supports stdio MCP servers, install the published cryptodataapi-mcp npm package. It is a thin bridge that forwards to the same hosted server — all tool logic still runs server-side, so you get identical behavior. It needs Node.js and reads your key from the CRYPTODATA_API_KEY environment variable.
Add it via CLI, or drop the block below into your client's config file (Claude Desktop, Cursor, Windsurf, and others use this exact mcpServers shape).
CRYPTODATA_API_KEY=cdk_live_YOUR_KEY \ claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": { "CRYPTODATA_API_KEY": "cdk_live_YOUR_KEY" }
}
}
}
Every data tool needs a key in the X-API-Key header. The Free tier needs no card and covers the whole market picture (see tiers below). Grab one at cryptodataapi.com/login, or POST an email to the auth endpoint — the key is returned once.
Agents can also bootstrap themselves: the server exposes a create_free_api_key tool that mints a free key from an email with no signup. And a few discovery tools (create_free_api_key, list_capabilities, get_exchange_links) need no key at all, so an agent can orient before it has one.
For autonomous upgrades, agents can self-subscribe over x402 (gasless USDC) via POST /api/v1/payments/agent-subscribe — no human in the loop.
curl -X POST https://cryptodataapi.com/api/v1/auth/keys \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]"}'
The server exposes ~24 curated, read-only tools (the heavy /backtesting/* bulk endpoints are intentionally left off — use the REST API for those). Grouped:
Prices & coins: get_price, get_coin_profile, get_top_coins, search_coins, get_hyperliquid_prices.
Market intelligence: get_daily_snapshot (one-call overview), get_market_health, get_market_regime (Pro), get_cycle_regime, get_fear_greed, get_macro, get_stablecoins, get_etf_flows.
Derivatives & positioning: get_funding_rates, get_open_interest, get_liquidations, get_order_book, get_positioning (Pro), get_gamma_exposure (Pro), get_whale_activity (Pro).
Utility & discovery: create_free_api_key, list_capabilities, get_exchange_links, and query_api — an escape hatch that calls any other GET endpoint across the 180+ endpoint REST surface. Start a session with get_daily_snapshot or list_capabilities.
“What's the current crypto market regime, and which strategy baskets fit it?”
“Compare BTC funding rates across Binance and Hyperliquid and flag crowded positioning.”
“Give me a one-call market snapshot: health score, Fear & Greed, and top movers.”
“Which coins have the highest liquidation risk right now?”
“Is dealer gamma amplifying or dampening BTC moves today?”
“Mint me a free API key for [email protected], then pull the daily snapshot.”
Every data tool forwards your X-API-Key to our REST API, which is the single checkpoint for auth, tier gating, caching and rate limiting. On the remote server the key is a request header, fixed when you add the server; on the stdio bridge it comes from the CRYPTODATA_API_KEY env var. A handful of discovery tools (create_free_api_key, list_capabilities, get_exchange_links) work with no key.
Prefer remote HTTP if your client supports it: nothing to install, no Node, and you always get the latest tools. Use the stdio bridge (npx cryptodataapi-mcp) only for clients that can't reach a remote HTTP MCP server — it forwards to the same hosted endpoint, so behavior is identical.
Free (no card): market-health scores, short/long-term regime reads, Fear & Greed, macro, ETF & stablecoin flows, BTC cycle indicators, 2,000+ coin profiles, and full-universe Hyperliquid funding + open interest — plus BTC order book & liquidations. Pro (from $39/mo): the per-coin proprietary signals for every coin — quant regimes & probabilities, dealer gamma (GEX), whale activity, positioning, liquidation heatmaps and L2 books universe-wide — plus 6× rate limit. Pro Plus (from $149/mo): historical & bulk — the 2020→now regime archive (Parquet), a probability audit trail, and backtesting data.
Request budgets: Free 5/min, Pro 30/min, Pro Plus 60/min. A 429 means back off. Responses carry Cache-Control; data refreshes on 1–30 minute cadences, so poll accordingly.
get_market_regime, get_positioning, get_gamma_exposure and get_whale_activity are Pro/Pro Plus. get_liquidations and get_order_book return BTC on Free and the full coin universe on Pro. Everything else — health, cycle regime, Fear & Greed, macro, flows, prices, funding and open interest (full-universe) — is on Free.
Yes — any MCP-compatible client works. We keep a copy-paste setup page for each: Claude Code, Claude Desktop, Claude on the web, Cursor, OpenAI Codex, Gemini CLI, Windsurf, GitHub Copilot, plus platforms like n8n, LangChain, elizaOS and OpenClaw.
Yes. The query_api tool is a read-only escape hatch to any other GET endpoint on the /api/v1 surface (180+ endpoints). The heavy backtesting and any account/mutating routes are deliberately not reachable through it — use the REST API directly for those.
Missing an agent, a config that changed, or a step that didn't work? Tell us and we'll fix it.