The CryptoQuant MCP Server provides on-chain cryptocurrency analytics and market insights to AI assistants through natural language queries and structured API tools.
Natural Language Queries: Ask questions in any language (e.g., "Is BTC overvalued?", "비트코인 가격 전망?") and Claude automatically routes them to the appropriate on-chain metrics for AI-powered interpretation.
Session Management: Authenticate via environment variable (CRYPTOQUANT_API_KEY) or direct parameter using initialize() to unlock your plan details. Use reset_session to clear credentials or switch accounts.
Data Discovery:
discover_endpoints— Browse 245+ API endpoints filtered by asset and category (market-data, exchange-flows, network-data, miner-flows, etc.)get_endpoint_info— Retrieve detailed parameter options for any endpointlist_assets— View all supported assets (BTC, ETH, ALT, Stablecoin, ERC20, TRX, XRP) and their data categories
Data Access:
query_data— Fetch real-time or historical on-chain data with flexible parameters (time range, exchange, market type, granularity, up to 1000 data points)describe_metric— Get in-depth explanations, thresholds, and interpretation guidance for metrics like MVRV, SOPR, funding rates, exchange flows, and whale activity
Integrations: Works with Claude Desktop, Claude Code, Cursor, and other MCP-compatible applications.
Provides tools for accessing on-chain analytics for XRP, enabling AI agents to monitor real-time metrics, track whale activity, and analyze market valuation data.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CryptoQuant MCP ServerIs Bitcoin overvalued right now based on the MVRV ratio?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CryptoQuant MCP Server
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) |
|
Claude Desktop (Windows) |
|
Claude Code |
|
Cursor | Project |
{
"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 buildMCP Tools
The MCP server provides these tools for API access:
Tool | Description |
| Start session with API key, returns plan info |
| Browse 245+ available endpoints |
| Get endpoint parameter details |
| Query raw API data |
| Get metric descriptions and thresholds |
| List supported assets |
| 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 |
License
MIT License - see LICENSE
Development
Setup
After cloning the repository, install dependencies to set up git hooks:
npm installThis 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 stagedCommit is blocked if lint errors are found
Fix errors before committing:
npm run lint
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.