Model Context Protocol

On-chain intelligence, inside your AI.

Name: CryptoQuant MCP Server
Author: CryptoQuant

Connect CryptoQuant to Claude, Cursor, or any MCP client — and ask about the market in plain language.

CryptoQuant MCP

Is Bitcoin overvalued right now?

describe_metric → query_data

→ query_data  /btc/market-indicator/mvrv
  { "window": "day", "limit": 30 }
← { "status": { "code": 200, "message": "success" },
    "result": { "window": "day", "data": [ { "date": "…", "mvrv": … }, … ] } }

Illustrative call shape — parameter and field names from the metric catalog; values are not live data.

MVRV sits in the upper band of its historical range — the zone that has preceded cooling in past cycles. Here's the trend.

MVRV ratio · trend shape only

Ask anything

Illustrative example — figures shown are not live data.

Nine tools your assistant can reach for

Five for the data, four for the research. Your AI picks the right one on its own — you just ask the question.

discover_endpoints
Find the right metric for a question, across every asset and category.
query_data
Pull on-chain and market time series — daily down to per-block.
get_endpoint_info
Check an endpoint's parameters before you query it.
describe_metric
Get a metric's definition and its interpretation thresholds.
list_assets
See every supported asset and the data behind it.
query_research
Search CryptoQuant's official research.
query_quicktake
Search Quicktake posts from CryptoQuant Verified Authors.
recent_research
Read the latest official research.
recent_quicktake
Read the latest Quicktake commentary.

The data behind the answers

The same on-chain dataset professional desks run on — 200+ on-chain metrics across 490+ assets, now reachable in a sentence.

Assets

Bitcoin
Ethereum
XRP
TRON
Stablecoins
ERC-20 tokens
Alts

Endpoints are grouped by family — ERC-20 tokens, stablecoins, and alts each share one endpoint set.

Resolution & content

Daily, hourly, 10-minute, minute, and per-block resolution
CryptoQuant official Research
QuickTake from Verified Authors

Want the exact endpoints, parameters, and response fields? They're all in the catalog, along with the assets each endpoint family covers.

Browse the metric catalog

Connect it to your assistant

It's a standard remote MCP server over Streamable HTTP, so any MCP-capable client can connect. Sign-in uses OAuth 2.0 with PKCE — choose your API key for a dedicated rate limit, or go keyless on a shared pool.

Server URL

https://mcp.cryptoquant.com/mcp

Client setup

Terminal

claude mcp add --transport http CryptoQuant https://mcp.cryptoquant.com/mcp

Then complete the sign-in flow the first time the server is used.

In Claude, click "Add connectors", then "Add custom connector".
Name: CryptoQuant · Remote MCP Server URL: the address below.
Click "Add", then "Connect".
Choose API Key (dedicated rate limit) or Keyless (shared rate limit pool).

Remote MCP Server URL

https://mcp.cryptoquant.com/mcp

.cursor/mcp.json

{
  "mcpServers": {
    "CryptoQuant": {
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

After saving, restart the app and complete the sign-in flow.

~/Library/Application Support/Claude/claude_desktop_config.json · %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "CryptoQuant": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.cryptoquant.com/mcp"
      ]
    }
  }
}

Requires Node.js v18 or higher. After saving, restart the app.

Setup guide for AI agents

Get an API key

Plans and credits

MCP access follows the same plan rules as the API — the same credit balance, the same resolution and history limits. Start free on Basic.

Plan	Monthly credits	Rate limit	History	On-chain data
Basic (free)	10,000	10/min	30 days	Not included
Advanced	300,000	60/min	1 year	Not included
Professional	500,000	120/min	1 year	Included
Premium	Unlimited	800/min	Full history	Included

One MCP data tool call is one API call against your plan: credits are deducted per successful call and scale with the rows and data type returned — failed calls are not charged. When credits run out, calls return 402 payment_required until you top up or the monthly reset.
Research and Quicktake tools are free while the MCP server is in beta.
Rate limits are per plan. On 429 too_many_requests, back off and retry after a short delay. Signing in with an API key gives a dedicated limit; keyless access shares a pool.

See the Data API

Compare plans

FAQ

Frequently Asked Questions

What is the CryptoQuant MCP server?

It's a Model Context Protocol server that gives AI assistants direct access to CryptoQuant's on-chain analytics. Once connected, your assistant can look up exchange flows, miner activity, market indicators, and CryptoQuant research on its own — you just ask the question.

Which AI clients can connect?

It is a standard remote MCP server, so any MCP-capable client can connect.

Do I need a paid plan?

MCP access follows the same plan rules as the API — the same credit balance, the same resolution and history limits. See the API plans and credits for details.

Is the data live?

Yes. The server queries the same endpoints the REST API serves, so answers reflect current data. Any charts or figures shown on this page are illustrative examples, not live readings.

For AI agents

Machine-readable entry points

Everything an agent needs to discover and consume CryptoQuant data, as plain URLs — no page parsing required.

MCP server: https://mcp.cryptoquant.com/mcp
OAuth authorization server metadata: https://mcp.cryptoquant.com/.well-known/oauth-authorization-server
Guide for AI agents: https://docs.cryptoquant.com/guides/for-ai-agents
Metric catalog (JSON): https://docs.cryptoquant.com/catalog/catalog.json
OpenAPI v1 (JSON): https://docs.cryptoquant.com/openapi/v1.json
Docs llms.txt: https://docs.cryptoquant.com/llms.txt
Site llms.txt: https://cryptoquant.com/llms.txt

Append .md to any docs page URL to read it as Markdown.