CryptoQuant MCP Server

On-Chain Analytics for Claude and AI Coding Agents

Installation • MCP Tools • Authentication

What is this?

CryptoQuant MCP Server brings on-chain analytics directly into your AI assistant:

Natural language queries: Ask in any language - "비트코인 가격 전망?" or "Is BTC overvalued?"
Real-time metrics: MVRV, SOPR, Exchange Flows, Funding Rates
Market insights: AI-powered interpretation of on-chain data
Whale tracking: Monitor large holder movements

Installation

Quick Start (Claude Desktop, Cursor, etc.)

Step 1: Add to your MCP config file:

App	Config File
Claude Desktop (Mac)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Claude Code	`~/.claude/mcp.json` or project `.mcp.json`
Cursor	Project `.cursor/mcp.json`

{
  "mcpServers": {
    "cryptoquant": {
      "command": "npx",
      "args": ["-y", "cryptoquant-mcp"]
    }
  }
}

Step 2: Restart your app

Step 3: Call initialize() to verify connection. Done!

Local Development

For contributors:

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

MCP Tools

The MCP server provides these tools for API access:

Tool	Description
`initialize`	Start session with API key, returns plan info
`discover_endpoints`	Browse 245+ available endpoints
`get_endpoint_info`	Get endpoint parameter details
`query_data`	Query raw API data
`describe_metric`	Get metric descriptions and thresholds
`list_assets`	List supported assets
`reset_session`	Clear session (logout)

Supported Assets

BTC, ETH, ALT, Stablecoin, ERC20, TRX, XRP

Natural Language Queries

Ask questions in any language - Claude will route to the right metrics:

Query	Intent	Metric
"비트코인 가격 전망이 어때?"	VALUATION	MVRV
"Is BTC overvalued?"	VALUATION	MVRV
"고래들 움직임 보여줘"	WHALE_ACTIVITY	whale-ratio
"What's the funding rate?"	LEVERAGE	funding-rates
"익절/손절 상황?"	PROFIT_BEHAVIOR	SOPR

Authentication

Option A. Environment Variable (Recommended)

Add your API key to the MCP config:

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

Option B. Direct Parameter

Call initialize() with your API key:

initialize(api_key="your-api-key")

The key will be saved to ~/.cryptoquant/credentials for future sessions.

Get your API key: https://cryptoquant.com/settings/api

Managing Credentials

# Switch accounts
reset_session(clear_stored=true)
initialize(api_key="new-api-key")

Requirements

Component	Requirement
Node.js	v18+
API Access	CryptoQuant API key

License

MIT License - see LICENSE

Development

Setup

After cloning the repository, install dependencies to set up git hooks:

npm install

This automatically configures husky for pre-commit hooks.

Pre-commit Hooks

When committing changes to src/, ESLint runs automatically:

Lint check runs only when files in src/ are staged
Commit is blocked if lint errors are found
Fix errors before committing: npm run lint

CryptoQuant • Docs • Issues

CryptoQuant MCP Server