CryptoQuant MCP

CryptoQuant on-chain, market, and derivatives data, plus CryptoQuant Research and QuickTake insights, for AI agents through the Model Context Protocol.

This repository contains:

• Remote server setup for https://mcp.cryptoquant.com/mcp (recommended; you sign in with OAuth)
• An Agent Plugins / Cursor plugin (plugin.json, mcp.json, skills/) that connects to the remote server and teaches the agent which metric answers which question
• A local stdio proxy (npx cryptoquant-mcp) for clients that cannot connect to remote MCP servers. It forwards every message to the remote server unchanged.

Remote server (recommended)

Server URL: https://mcp.cryptoquant.com/mcp (Streamable HTTP, OAuth)

No API key is needed in your config. The first time you connect, your client opens a CryptoQuant sign-in page. More setup details: CryptoQuant user guide.

Claude (claude.ai and Claude Desktop)

Open Settings → Connectors → Add custom connector and paste the server URL.

ChatGPT

Add a custom connector with the server URL (developer mode). Availability depends on your ChatGPT plan.

Cursor

Install the CryptoQuant plugin from the Cursor marketplace (once listed). It adds the remote server and the cryptoquant-onchain skill.

Or add the server yourself in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

VS Code

.vscode/mcp.json:

{
  "servers": {
    "cryptoquant": {
      "type": "http",
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

Claude Code

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

Then run /mcp in Claude Code to sign in.

Local install (npx proxy)

For clients that only support local (stdio) servers. Requires Node.js 18+ and a CryptoQuant API key.

{
  "mcpServers": {
    "cryptoquant": {
      "command": "npx",
      "args": ["-y", "cryptoquant-mcp"],
      "env": {
        "CRYPTOQUANT_API_KEY": "your-api-key"
      }
    }
  }
}

App	Config file
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json or ~/.cursor/mcp.json
Claude Code	project .mcp.json

Variable	Required	Description
CRYPTOQUANT_API_KEY	Yes	Your API key, sent to the remote server as a bearer token. If it is not set, the key saved by 0.x in ~/.cryptoquant/credentials is used.
CRYPTOQUANT_MCP_URL	No	Overrides the server URL (default https://mcp.cryptoquant.com/mcp). Must be https; plain http is accepted only for loopback addresses (localhost, 127.0.0.1, [::1]).

Without a key, the proxy prints setup instructions to stderr and exits.

Tools

The tools come from the remote server. This list is for reference and may change.

Tool	Description
discover_endpoints	Find data endpoints by asset and category
get_endpoint_info	Parameters of an endpoint (window, exchange, token, ...)
query_data	Query on-chain, market, and derivatives data
describe_metric	Definition, thresholds, and interpretation of a metric
list_assets	Supported assets
recent_research	Latest CryptoQuant Research articles
recent_quicktake	Latest QuickTake articles from CryptoQuant Verified Authors
query_research	Search Research articles by topic
query_quicktake	Search QuickTake articles by topic

Assets, dates, and rate limits

• Assets: BTC, ETH, XRP, TRX, stablecoins, ERC-20 tokens, and other altcoins. list_assets returns the current list.
• Dates: yyyyMMdd for window=day (e.g. 20260115), yyyyMMddTHHmmss for other windows (e.g. 20260115T000000).
• Rate limits and history: depend on your CryptoQuant plan. The server tells the agent your plan's limits when it connects. See plans.

Migrating from 0.x

1.0 turns the npm package into a proxy to the remote server, so the local and remote servers now offer the same tools.

• The initialize and reset_session tools are removed. Set CRYPTOQUANT_API_KEY in your MCP config instead. A key you saved in 0.x with initialize(api_key=...) keeps working; it is read from ~/.cryptoquant/credentials.
• QuickTake and Research tools are now available locally.
• The package no longer exports a JavaScript library API.
• CRYPTOQUANT_API_URL (the 0.x API base URL override) is no longer used; use CRYPTOQUANT_MCP_URL to point at another MCP server.
• npx -y cryptoquant-mcp always fetches the latest version, so existing configs switch to 1.0 on the next start. Prompts or workflows that call initialize need to be updated.

See CHANGELOG.md.

Development

git clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git
cd cryptoquant-mcp
npm install
npm test
npm run build

See CONTRIBUTING.md.

License

MIT. See LICENSE.