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 |
Step 2: Restart your app
Step 3: Call initialize() to verify connection. Done!
Local Development
For contributors:
MCP 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:
Option B. Direct Parameter
Call initialize() with 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
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:
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 stagedCommit is blocked if lint errors are found
Fix errors before committing:
npm run lint