DexPaprika

DexPaprika MCP Server: AIエージェント向けリアルタイムDEX・暗号資産データ

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通信を行い、ポートはバインドしません。起動時にDexPaprika MCP server v<version> (tool contract v<contract>) is running...をstderrに出力し、その後クライアントからの接続を待ちます。ブラウザーで開く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	主要ツール。ネットワーク上の流動性上位プールを取得	network
getDexPools	特定のDEXのプールを取得（results以下の行、カーソルページネーション。2ページ目以降の取得にはキーが必要）	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とカーソルページネーション。2ページ目以降の取得にはキーが必要）	network、token_address
getTokenOHLCV	トークンの過去のUSD建てOHLCVローソク足。取引対象となるすべてのプールの出来高加重平均。api-pro.dexpaprika.comでDevまたはProプランが必要。キーなしおよび無料キーでは403が返ります	network、token_address、start
getTokenIndicator	取引対象となるすべてのプールにおける、トークンのUSD建てローソク足の同じインジケーター。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トークンを含むすべてのプールを検索して、出来高順に並べて。」
• 「Ethereum上で24時間の出来高が10万ドルを超え、過去1週間に作成されたプールを絞り込んで。」
• 「まず利用可能なネットワークをすべて取得してから、主要ネットワークごとに上位プールを表示して。」

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

• 無料プラン：キーなし、登録不要で、1分あたり15リクエスト。無料APIキーを使うと、1分あたり30リクエストに増え、月間利用枠も増加し、ストリーミングが利用可能になります。登録先：https://console.dexpaprika.com. Proは月額99ドルで1分あたり500リクエスト、Devは30ドルで1分あたり120リクエストです。1リクエストにつき1クレジットを消費し、バッチエンドポイントは項目ごとに1クレジットを消費します。ドキュメント全文：https://docs.dexpaprika.com. 月間利用枠は変更されるため、このページではなくこちらで確認してください：https://dexpaprika.com/api/pricing
• 検索結果のページ送りにはキーが必要：getNetworkPools、getDexPools、getNetworkPoolsFilter、getTokenPools、filterNetworkTokens、getTopTokensでは、最初のページはキーなしで利用できますが、後続ページを取得するためにcursorを渡すにはAPIキーが必要です。無料キーなら制限なくページ送りできます。
• データの遅延：無料プランでは最大60秒、有料プランではリアルタイム
• 検索結果における新しいプールとトークン：Devプラン以上でない場合、getNetworkPools、getDexPools、getTokenPools、getNetworkPoolsFilter、getTopTokens、filterNetworkTokensでは、過去1時間以内に作成されたプールとトークンが除外されます。そのため、1時間未満のcreated_after期間や、過去1時間以内にローンチされたトークンのプールは、結果が空になります。getPoolDetailsとgetTokenDetailsは、作成時期を問わず結果を返します。api-pro.dexpaprika.comのDev、Pro、Enterpriseキーでは、インデックス化され次第、これらを確認できます。詳細：https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• 応答時間：ほとんどのエンドポイントで100～500ミリ秒（ネットワークに依存）
• エラー処理：コード、提案、再試行の案内を含む構造化エラー
• 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 - 包括的な暗号資産市場データ