DexPaprika MCP Server

DexPaprika MCP サーバー

DexPaprika の暗号資産および DEX データ API にオンデマンドでアクセスできる Model Context Protocol（MCP）サーバーです。Claude のような AI アシスタントが、設定不要でトークン、プール、DEX の最新データをプログラムから取得できるように特化して構築されています。

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP は、複数のブロックチェーンにわたるリアルタイムの DEX データを Claude に提供します。無料プランは API キーなしですぐに利用できます。インストール | 設定 | API リファレンス

設定不要ですぐに利用したい場合：mcp.dexpaprika.com のホスト型 MCP サーバーをご利用ください。インストール不要で、キーなしですぐに利用でき、同じデータツールに加えて submitFeedback も使用できます。トランスポートのエンドポイントについては、ホスト型サーバーをご覧ください。

最新リリース

リリースノートと移行ガイドについては、CHANGELOG.mdをご覧ください。

何を構築できますか？

• トークン分析ツール：価格変動、流動性の深さの変化、取引量のパターンを追跡します
• DEX 比較：さまざまな DEX の手数料体系、取引量、利用可能なプールを分析します
• 流動性プール分析：TVL の変化、インパーマネントロスの計算、価格への影響を監視します
• 市場分析：チェーンをまたいだトークン比較、取引量の傾向、取引活動の指標を分析します
• ポートフォリオトラッカー：現在価値の追跡、過去のパフォーマンス分析、利回りの機会を確認します
• テクニカル分析：過去の OHLCV データを使用して、トレンドの特定、パターン認識、インジケーターの計算など、高度なテクニカル分析を実行します

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に DexPaprika を自動インストールするには：

npx -y smithery mcp add coinpaprika/dexpaprika

手動インストール

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

これは stdio サーバーです。stdin と stdout を介して MCP で通信し、ポートはバインドしません。起動すると、stderr に DexPaprika MCP server v<version> (tool contract v<contract>) is running... と出力してから、クライアントを待機します。ブラウザーで URL を開くことを想定せず、MCP クライアント（Claude Desktop、Cursor、Claude Code）から実行してください。

動画チュートリアル

DexPaprika MCP サーバーの設定方法と使い方を順を追って解説するチュートリアルをご覧ください。

Claude Desktop との連携

Claude Desktop の設定ファイルに以下を追加してください。

macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

Claude Desktop を再起動すると、DexPaprika のツールが自動的に Claude で利用可能になります。

任意：API キーを使用する

キーなしで動作し、今後もそのままお使いいただけます。 サインアップも、クレジットカードも、設定も不要です。上記の方法が、サポートされている実行方法です。

無料のキーを使うと月間の利用枠が増え、公開ショーケース対象のトークンに限らず、すべてのトークンでストリーミングを利用できます。ただし、1 分あたりのリクエスト制限は増えません。どちらのプランも同じ制限です。console.dexpaprika.com でキーを取得できます。現在の制限はレート制限のページをご覧ください。

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

キーは単独で、Authorization の値全体として入力します。 発行されたとおりに、その前に何も付けずに貼り付けてください。ほとんどの API ではキーの前に何かを付ける必要があるため、キーが有効なのに動作しないように見える原因として最もよくあるのがこれです。

知っておくとよい点が 2 つあります。

• 読み取れないキーを指定しても、エラーにはなりません。 データエンドポイントは読み取れないキーを無視し、匿名の呼び出し元として通常の 200 と実際のデータを返すため、タイプミスが成功したように見えてしまいます。キーを設定した後、アシスタントに getKeyStatus を実行するよう依頼してください。API が実際に認識しているプランを報告し、キーが反映されていない場合は原因の候補を示します。
• Dev および Pro のお客様は、DEXPAPRIKA_API_BASE_URL に加えて https://api-pro.dexpaprika.com を設定してください。getTokenOHLCV にもこの設定が必要です。無料のキーをこのホストに送信すると 403 が返されるため、ホストは自動では変更されません。

ホスト型サーバー（インストール不要）

セットアップを一切行わずに利用する場合は、MCP 対応クライアントをホスト型サーバーの mcp.dexpaprika.com に直接接続してください。ランディングページには、セットアップ手順とドキュメントが掲載されています。利用可能なトランスポートエンドポイントは次のとおりです。

トランスポート	エンドポイント	用途
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	ほとんどのクライアントに推奨
SSE	https://mcp.dexpaprika.com/sse	従来の SSE トランスポート
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	直接 JSON-RPC

注：これらは MCP プロトコルのエンドポイントです。ブラウザーで開いても何も表示されません。ランディングページは mcp.dexpaprika.com をご覧ください。

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

利用可能なツール（20）

このセルフホスト版では、読み取り専用ツールを 20 個登録しています。内訳はマーケットデータツール 19 個と getKeyStatus です。mcp.dexpaprika.com のホスト型サーバーでは、submitFeedback を含む独自のツールセットが登録されています。いずれも、実際に tools/list を実行して確認してください。

検索と検出

ツール	説明
getCapabilities	サーバーの機能、ワークフローパターン、ネットワークの別名、ベストプラクティス。まずはこちらから。
getNetworks	サポートされているすべてのブロックチェーンネットワーク（36 個）を一覧表示
getStats	エコシステムの概要統計（ネットワーク、DEX、プール、トークンの合計数）
search	すべてのネットワークを対象に、名前、シンボル、アドレスからトークン、プール、DEX を検索
getKeyStatus	キーが送信されているか、API がどのプランを認識しているかを確認します。マーケットデータは読み取りません。

DEX 操作

ツール	説明	必須パラメーター
getNetworkDexes	指定したネットワーク上の DEX を一覧表示	network

プール操作

ツール	説明	必須パラメーター
getNetworkPools	PRIMARY。ネットワーク上の流動性上位プールを取得します	network
getDexPools	特定のDEXのプールを取得します（results の下に行があり、カーソルによるページネーションを使用します。最初のページを超えてページを取得するにはキーが必要です）	network、dex
getNetworkPoolsFilter	出来高、トランザクション数、作成時刻でプールを絞り込みます	network
getPoolDetails	プールの詳細情報（価格、出来高、TVL、トークン）	network、pool_address
getPoolOHLCV	過去のOHLCVローソク足データ	network、pool_address、start
getPoolIndicator	プールのRSI、EMA、MACD、ボリンジャーバンド、またはVWAPを、ローソク足データからサーバー側で計算します。履歴と間隔に関するプランの上限はgetPoolOHLCVと同じです	network、pool_address、indicator
getPoolTransactions	プールの最近のトランザクション／取引	network、pool_address

トークン操作

ツール	説明	必須パラメーター
getTokenDetails	トークンの詳細情報	network、token_address
getTokenPools	トークンを含む流動性プール（ネットワーク単位のフィルター、resultsとカーソルによるページネーションを使用します。最初のページを超えてページを取得するにはキーが必要です）	network、token_address
getTokenOHLCV	トークンが取引されるすべてのプールの出来高加重平均による、トークンの過去の米ドル建てOHLCVローソク足。api-pro.dexpaprika.comでDevまたはProプランが必要です。キーなしおよび無料キーでは403が返されます	network、token_address、start
getTokenIndicator	トークンが取引されるすべてのプールの米ドル建てローソク足に対する同じ指標。api-pro.dexpaprika.comでDevまたはProプランが必要です。キーなしおよび無料キーでは403が返されます	network、token_address、indicator
getTokenMultiPrices	最大10個のトークンの価格をまとめて取得します	network、tokens[]
getTopTokens	出来高、流動性、FDV、または24時間の価格変動率で順位付けした、ネットワーク上の上位トークン	network
filterNetworkTokens	出来高、流動性、FDV、トランザクション数、作成時刻でトークンを絞り込みます	network

使用例

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (first page, returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data for a pool:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
  network: "ethereum",
  token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  start: "-24h",
  interval: "1h",
  limit: 24
});

// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  indicator: "rsi",
  interval: "1h",
  start: "-24h"
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Claude 向けのプロンプト例

• 「Solana上のJUPトークンを分析してください。価格、出来高、流動性上位のプールを取得してください。」
• 「Ethereum上のUniswap V3とSushiSwapの取引量を比較してください。」
• 「Raydium上のSOL/USDCについて、過去1日分の1時間ごとのOHLCVを取得し、価格チャートを描画してください。」
• 「Fantomネットワークで流動性上位のプールを5つ見つけ、その手数料体系を分析してください。」
• 「Uniswap上のETH/USDTプールの最近のトランザクションを取得し、買い圧力と売り圧力を分析してください。」
• 「Ethereum上の24時間出来高上位10プールを表示してください。」
• 「ARBトークンを含むすべてのプールを検索し、出来高順に並べてください。」
• 「過去1週間に作成され、24時間出来高が10万ドルを超えるEthereumのプールを絞り込んでください。」
• 「まず利用可能なネットワークをすべて取得し、次に主要ネットワークごとの上位プールを表示してください。」

レート制限とパフォーマンス

• 無料プラン：キー不要で登録も不要です。1 分あたり 15 リクエストまで利用できます。無料の API キーを取得すると、1 分あたり 30 リクエストまで利用でき、月間クォータが増え、ストリーミングも利用可能になります。https://console.dexpaprika.com で登録してください。Pro は月額 99 ドルで 1 分あたり 500 リクエストまで、Dev プランは月額 30 ドルで 1 分あたり 120 リクエストまで利用できます。リクエスト 1 件につきクレジット 1 件を消費します。バッチエンドポイントはアイテム 1 件につきクレジット 1 件を消費します。ドキュメント全文は https://docs.dexpaprika.com をご覧ください。月間クォータは変更されるため、このページではなく、こちらでご確認ください：https://dexpaprika.com/api/pricing
• 検索結果のページ送りにはキーが必要です：getNetworkPools、getDexPools、getNetworkPoolsFilter、getTokenPools、filterNetworkTokens、getTopTokens では、最初のページはキーなしで利用できますが、後続ページを取得するために cursor を渡すには API キーが必要です。無料キーでは、制限なくページ送りできます。
• データの遅延：無料プランでは最大 60 秒、有料プランではリアルタイムです
• 応答時間：ほとんどのエンドポイントで 100～500ms（ネットワークにより異なります）
• エラー処理：コード、提案、再試行に関するガイダンスを含む構造化エラー
• OHLCV データの利用可能期間：通常、トークン／プールの作成日以降の履歴データを利用できます

トラブルシューティング

よくある問題：

• レート制限：DP429_RATE_LIMIT エラーが発生した場合は、指数バックオフを実装してください
• データが見つからない：新しいトークン／プールの中には、過去データが不完全なものがあります
• タイムアウトエラー：大量のデータをリクエストすると時間がかかることがあります。ページネーションの利用を検討してください
• ネットワークエラー：ネットワーク接続を確認してください。このサービスにはインターネットアクセスが必要です
• OHLCV の制限：1 回のリクエストで取得できるローソク足は最大 1000 本（limit）です。より長い期間を取得するには、start を先に進めて再度リクエストしてください。キーなしの場合、OHLCV は 1h では直近 24 時間分まで利用でき、それより長い間隔では（start: "-24h"）となります。無料キーを使用すると、10m では 7 日分まで利用でき、それより長い間隔でも取得できます。プラン別の OHLCV 制限をご覧ください
• OHLCV が空：プールが新しすぎる可能性があります。代わりに getPoolTransactions を使用してください

開発

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

変更履歴

詳細なリリースノートと移行ガイドについては、CHANGELOG.md をご覧ください。

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。

その他のリソース

• DexPaprika API ドキュメント
• ホスト型 MCP サーバー、セットアップ不要のオプション
• Model Context Protocol 仕様
• DexPaprika - オンチェーン分析の包括的な市場データ
• CoinPaprika - 暗号資産市場の包括的なデータ