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_official/mcp"]
}
}
}
Step 2: Restart your app
Step 3: Call initialize() to verify connection. Done!
Local Development
For contributors:
git clone https://github.com/CryptoQuantOfficial/mcp.git
cd 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_official/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