CryptoQuant MCP Server

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:

{
  "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:

Supported Assets

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

Natural Language Queries

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

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

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