MKT CAP$2.23T-0.3%
24H VOL$71.6B
BTC DOM57.7%
HEALTH34BEARISH
SHORT-TERM50NEUTRAL
LONG-TERM19BEARISH
OI$46.9B-0.5%
24H LIQ$147M
LONG/SHORT58.8% / 41.2%
REGIME (LT)ESTABLISHED BEAR MARKET
REGIME (ST)SQUEEZE
HL OI$7.3B
WHALESSHORT 46.3%
MKT CAP$2.23T-0.3%
24H VOL$71.6B
BTC DOM57.7%
HEALTH34BEARISH
SHORT-TERM50NEUTRAL
LONG-TERM19BEARISH
OI$46.9B-0.5%
24H LIQ$147M
LONG/SHORT58.8% / 41.2%
REGIME (LT)ESTABLISHED BEAR MARKET
REGIME (ST)SQUEEZE
HL OI$7.3B
WHALESSHORT 46.3%
Plug real-time crypto data into your AI agent — one command: Get your free API key →
Get API KeyLogin

MCP Server

Core docs

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.

Vendor · CryptoDataAPI MCP · http (streamable, recommended) + stdio (npx bridge) Config · https://cryptodataapi.com/mcp Agent docs →
1

Connect the remote server

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.

Remote HTTP (Claude Code shown)
claude mcp add --transport http cryptodataapi \
  https://cryptodataapi.com/mcp \
  --header "X-API-Key: cdk_live_YOUR_KEY"
Generic client config (url + headers)
{
  "mcpServers": {
    "cryptodataapi": {
      "url": "https://cryptodataapi.com/mcp",
      "headers": { "X-API-Key": "cdk_live_YOUR_KEY" }
    }
  }
}
2

Or run the local stdio bridge

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).

Stdio bridge (npm, published)
CRYPTODATA_API_KEY=cdk_live_YOUR_KEY \
  claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
Client config file (stdio)
{
  "mcpServers": {
    "cryptodataapi": {
      "command": "npx",
      "args": ["-y", "cryptodataapi-mcp"],
      "env": { "CRYPTODATA_API_KEY": "cdk_live_YOUR_KEY" }
    }
  }
}
3

Get a key (or let the agent mint one)

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.

Free key, no signup
curl -X POST https://cryptodataapi.com/api/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'
4

What tools you get

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.

Example prompts

“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.”

FAQ

How does authentication work?

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.

Remote HTTP or local stdio — which should I use?

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.

What are the rate limits and tiers?

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.

Which tools need Pro?

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.

Does it work with my client (Cursor, Codex, Gemini, Windsurf, Copilot…)?

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.

Can I call endpoints that aren't wrapped as tools?

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.

Was this page helpful?

Missing an agent, a config that changed, or a step that didn't work? Tell us and we'll fix it.