CryptoQuant | On-chain intelligence, natively in your agent.

CryptoQuant MCP

Model Context Protocol を通じて、AI エージェントが CryptoQuant のオンチェーン、マーケット、デリバティブデータに加え、CryptoQuant Research と QuickTake のインサイトを利用できます。

このリポジトリには、次のものが含まれています。

• リモートサーバーのセットアップ（https://mcp.cryptoquant.com/mcp 用。推奨。OAuth でサインインします）
• Agent Plugins / Cursor プラグイン（plugin.json、mcp.json、skills/）。リモートサーバーに接続し、どの指標がどの質問への回答に適しているかをエージェントに教えます
• ローカル stdio プロキシ（npx cryptoquant-mcp）。リモート MCP サーバーに接続できないクライアント向けです。すべてのメッセージを変更せずにリモートサーバーへ転送します。

リモートサーバー（推奨）

サーバー URL：https://mcp.cryptoquant.com/mcp（Streamable HTTP、OAuth）

設定に API キーは不要です。初回接続時に、クライアントから CryptoQuant のサインインページが開きます。セットアップの詳細については、CryptoQuant ユーザーガイドをご覧ください。

Claude（claude.ai と Claude Desktop）

Settings → Connectors → Add custom connector を開き、サーバー URL を貼り付けます。

ChatGPT

サーバー URL を使ってカスタムコネクターを追加します（開発者モード）。利用可能かどうかは ChatGPT のプランによって異なります。

Cursor

Cursor マーケットプレイスから CryptoQuant プラグインをインストールします（掲載後）。リモートサーバーと cryptoquant-onchain スキルが追加されます。

または、.cursor/mcp.json（プロジェクト用）か ~/.cursor/mcp.json（グローバル用）でサーバーを手動で追加します。

{
  "mcpServers": {
    "cryptoquant": {
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "cryptoquant": {
      "type": "http",
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http cryptoquant https://mcp.cryptoquant.com/mcp

次に、Claude Code で /mcp を実行してサインインします。

ローカルインストール（npx プロキシ）

ローカル（stdio）サーバーのみをサポートするクライアント向けです。Node.js 18 以降と CryptoQuant API キーが必要です。

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

アプリ	設定ファイル
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json または ~/.cursor/mcp.json
Claude Code	プロジェクトの .mcp.json

変数	必須	説明
CRYPTOQUANT_API_KEY	はい	リモートサーバーにベアラートークンとして送信される API キーです。設定されていない場合は、0.x で ~/.cryptoquant/credentials に保存されたキーが使用されます。
CRYPTOQUANT_MCP_URL	いいえ	サーバー URL を上書きします（デフォルトは https://mcp.cryptoquant.com/mcp）。https が必要です。通常の http はループバックアドレス（localhost、127.0.0.1、[::1]）でのみ使用できます。

キーがない場合、プロキシは stderr にセットアップ手順を表示して終了します。

ツール

ツールはリモートサーバーから提供されます。この一覧は参考用であり、変更される場合があります。

ツール	説明
discover_endpoints	資産とカテゴリーからデータエンドポイントを検索します
get_endpoint_info	エンドポイントのパラメーター（期間、取引所、トークンなど）を取得します
query_data	オンチェーン、マーケット、デリバティブデータを照会します
describe_metric	指標の定義、しきい値、解釈を取得します
list_assets	対応している資産を一覧表示します
recent_research	CryptoQuant Research の最新記事を取得します
recent_quicktake	CryptoQuant Verified Authors による最新の QuickTake 記事を取得します
query_research	トピックを指定して Research の記事を検索します
query_quicktake	トピックを指定して QuickTake の記事を検索します

資産、日付、レート制限

• 資産： BTC、ETH、XRP、TRX、ステーブルコイン、ERC-20 トークン、その他のアルトコイン。list_assets で現在の一覧を取得できます。
• 日付： window=day の場合は yyyyMMdd（例：20260115）、その他の期間では yyyyMMddTHHmmss（例：20260115T000000）を使用します。
• レート制限と履歴： CryptoQuant のプランによって異なります。接続時に、サーバーからエージェントへプランの制限が通知されます。プランをご覧ください。

0.x からの移行

1.0 では npm パッケージがリモートサーバーへのプロキシになるため、ローカルサーバーとリモートサーバーで同じツールが利用できるようになりました。

• initialize ツールと reset_session ツールは削除されました。代わりに、MCP 設定で CRYPTOQUANT_API_KEY を設定してください。0.x で initialize(api_key=...) を使って保存したキーは引き続き使用できます。キーは ~/.cryptoquant/credentials から読み込まれます。
• QuickTake と Research のツールをローカルで利用できるようになりました。
• このパッケージでは、JavaScript ライブラリ API をエクスポートしなくなりました。
• CRYPTOQUANT_API_URL（0.x の API ベース URL の上書き設定）は使用されなくなりました。別の MCP サーバーを指定するには CRYPTOQUANT_MCP_URL を使用してください。
• npx -y cryptoquant-mcp は常に最新バージョンを取得するため、既存の設定は次回の起動時に 1.0 に切り替わります。initialize を呼び出すプロンプトやワークフローは更新が必要です。

CHANGELOG.md を参照してください。

開発

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

CONTRIBUTING.md を参照してください。

ライセンス

MIT です。LICENSE を参照してください。