CoinPaprika

CoinPaprika MCP サーバー

CoinPaprika の暗号資産市場データ API にオンデマンドでアクセスできる Model Context Protocol（MCP）サーバーです。Claude のような AI アシスタントが、設定不要でリアルタイム価格、ティッカー、取引所データ、OHLCV ローソク足などをプログラムから取得できるように構築されています。

TL;DR

# Install globally
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

# Or run directly without installation
npx @coinpaprika/mcp@latest

CoinPaprika MCP は、12,000 以上の暗号資産のライブ市場データに Claude を接続します。無料プランでは API キーは不要です。インストール | 設定 | API リファレンス

設定なしですぐに使いたいですか？ mcp.coinpaprika.com のホスト型 MCP サーバーをご利用ください。インストール不要で、API キーなしですぐに使えます。ツールは 31 個（ここにある 30 個と submitFeedback）です。トランスポートエンドポイントについてはホスト型サーバーをご覧ください。

何を構築できますか？

• 市場ダッシュボード：グローバル統計、上位コイン、取引高の推移を含むリアルタイムの市場概要
• コイン分析ツール：あらゆる暗号資産を詳細に分析：価格、チーム、イベント、取引所、市場
• 価格トラッカー：複数の表示通貨で価格を追跡し、過去の OHLCV データを確認
• 取引所比較：350 以上の取引所で取引ペアと取引高を比較
• ポートフォリオ評価：通貨間で金額を換算（「0.5 BTC を USD に」など）し、価格の推移を追跡
• コントラクト検索：複数のプラットフォームからスマートコントラクトアドレスでトークンを検索

インストール

Smithery 経由でインストール

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

npx -y smithery mcp add coinpaprika/coinpaprika

手動インストール

# Install globally (recommended for regular use)
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

Claude Desktop との連携

次の内容を Claude Desktop の設定ファイルに追加してください：

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

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"]
    }
  }
}

API キーを使用する場合（有料プランの機能向け）

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"],
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code との連携

# Add as MCP server in Claude Code
claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

# With API key
COINPAPRIKA_API_KEY=your-key claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

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

設定なしですぐに使いたい場合は、MCP 互換クライアントから mcp.coinpaprika.com のホスト型サーバーに直接接続してください。ランディングページに設定手順とドキュメントが掲載されています。利用可能なトランスポートエンドポイントは次のとおりです：

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

注：これらは MCP プロトコルのエンドポイントです。ブラウザーでは何も表示されません。ランディングページは mcp.coinpaprika.com にアクセスしてください。

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

利用可能なツール（30 個）

検索とシステム

ツール	説明
getCapabilities	サーバーの機能、ワークフローパターン、検証ルール、ベストプラクティス。まずはこちらから。
status	サーバーの状態と設定
getGlobal	世界市場の概要：時価総額合計、24 時間取引高、BTC ドミナンス（「市場の状況は？」）

コイン

ツール	説明	必須パラメーター
getCoins	すべてのコインを一覧表示（ID、名前、シンボル、順位）。価格は含まれません。価格には getTickers を使用してください	なし
getCoinById	コインプロジェクトの詳細（説明、チーム、リンク）。価格は含まれません。価格には getTickersById を使用してください	coinId
getCoinEvents	コインの今後のイベント	coinId
getCoinExchanges	コインを取り扱う取引所	coinId
getCoinMarkets	コインが取引されている市場／取引所（「X はどこで買える？」「Binance での X の価格は？」）	coinId

ティッカーと価格

ツール	説明	必須パラメーター
getTickers	時価総額上位コインの現在価格と時価総額（「時価総額上位5コイン」「市場のスナップショット」）	なし
getTickersById	1つのコインの現在価格、時価総額、24時間の変動率（「BTCの価格」「ETHはいくら」）	coinId
getCoinOHLCVLatest	最新の1日分のOHLCローソク足（リアルタイム価格ではありません）	coinId
getCoinOHLCVToday	本日の進行中のOHLCローソク足	coinId
priceConverter	通貨間の金額換算（「0.5 BTCをUSDに換算」）	baseCurrencyId、quoteCurrencyId

取引所

ツール	説明	必須パラメーター
getExchanges	すべての取引所の一覧	なし
getExchangeByID	取引所の詳細	exchangeId
getExchangeMarkets	特定の取引所のマーケット	exchangeId

タグと人物

ツール	説明	必須パラメーター
getTags	すべてのタグ／カテゴリーの一覧	なし
getTagById	タグの詳細	tagId
getPeopleById	人物／チームメンバーの詳細	personId

コントラクト

ツール	説明	必須パラメーター
getPlatforms	コントラクトプラットフォームの一覧	なし
getContracts	プラットフォーム上のコントラクト	platformId
getTickerByContract	コントラクトアドレスによるトークン価格（オンチェーン／DeFiトークン）	platformId、contractAddress

検索とID解決

ツール	説明	必須パラメーター
search	名前でコイン／取引所／人物／タグを検索します。IDを取得するため、最初に使用してください	q
resolveId	名前／シンボルを正式なIDに解決します。価格ツールの使用前に呼び出してください	type、query

有料プランのツール

これらのツールには、有料のCoinPaprika APIプランが必要です。APIキーがない場合は、アップグレード方法を案内するメッセージが返されます。

ツール	必要なプラン	説明
getCoinOHLCVHistorical	Starter以上	過去のOHLCVローソク足データ
getTickersHistoricalById	Starter以上	過去のティッカースナップショット
getHistoricalTickerByContract	Starter以上	コントラクトによる過去のティッカー
getChangelogIDs	Starter以上	コインID変更の変更履歴
keyInfo	Pro	APIキーの詳細を確認
getMappings	Business	プラットフォーム間のIDマッピング

APIキーの設定

無料プランでは、ほとんどのツールをAPIキーなしで利用できます。有料プランの機能（過去データ、マッピングなど）を利用するには、COINPAPRIKA_API_KEY環境変数を設定してください。

# Set via environment variable
export COINPAPRIKA_API_KEY=your-api-key-here
coinpaprika-mcp

# Or pass inline
COINPAPRIKA_API_KEY=your-api-key-here npx @coinpaprika/mcp@latest

coinpaprika.com/api/pricingでAPIキーを取得してください。

使用例

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

// Get global market overview:
const global = await getGlobal();

// Find a coin by name:
const results = await search({ q: "ethereum" });

// Get detailed coin info:
const bitcoin = await getCoinById({ coinId: "btc-bitcoin" });

// Get current ticker with USD and BTC quotes:
const ticker = await getTickersById({ coinId: "eth-ethereum", quotes: "USD,BTC" });

// Get OHLCV data for today:
const ohlcv = await getCoinOHLCVToday({ coinId: "btc-bitcoin" });

// Convert 1 BTC to USD:
const conversion = await priceConverter({
  baseCurrencyId: "btc-bitcoin",
  quoteCurrencyId: "usd-us-dollars",
  amount: 1
});

// List top 10 exchanges:
const exchanges = await getExchanges({ limit: 10 });

// Resolve fuzzy query to exact coin ID:
const resolved = await resolveId({ type: "coin", query: "cardano" });

Claude向けプロンプト例

• 「BitcoinとEthereumの現在価格を教えてください。24時間の変動率も表示してください。」
• 「Cardanoの価格、チーム、イベント、主要な取引所を含む包括的な分析をしてください。」
• 「取引高で暗号資産取引所の上位5社を比較してください。」
• 「10 ETHをUSDに換算し、現在の為替レートを表示してください。」
• 「『defi』のタグが付いたコインをすべて探し、それぞれの時価総額を表示してください。」
• 「Solanaを取り扱う取引所と、利用できる取引ペアを教えてください。」
• 「Bitcoinの本日のOHLCVデータを表示してください。」
• 「『layer-2』に関連するコインをすべて検索し、時価総額順に並べてください。」
• 「Ethereumの背後にいるチームを調べてください。主要メンバーは誰ですか？」
• 「Ethereumのコントラクトアドレスを使ってUSDTのティッカーを取得してください。」

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

• 無料プランの制限：月間20,000回の呼び出しが可能で、APIキーは不要です。有料プランは月額99ドルで400,000回の呼び出しからご利用いただけます：https://coinpaprika.com/api/pricing/
• 応答時間：ほとんどのエンドポイントで100～500ms
• データカバレッジ：12,000種類以上の暗号資産、350以上の取引所
• エラー処理：コード、提案、再試行方法を含む構造化エラー
• クォータ情報：このパッケージを自分で実行している場合、すべての応答に、月間無料プランの割り当てと、このサーバープロセスの起動後の呼び出し回数を示すmeta.quotaブロックが含まれます。この回数はプロセス単位のものであり、アカウントの残高ではありません。mcp.coinpaprika.comのホスト型サーバーはmetaブロックを一切返さないため、それに依存するクライアントコードは作成しないでください

トラブルシューティング

よくある問題：

• レート制限：CP429_RATE_LIMITエラーが発生した場合は、待機してから再試行してください。無料プランのクォータは日単位ではなく月単位のため、429が継続して発生する場合は、月間の割り当てを使い切っています
• 無効なコインID：コインIDはsymbol-name形式です（例：bitcoinやBTCではなくbtc-bitcoin）。正しいIDを見つけるには、searchまたはresolveIdを使用してください
• 有料プランが必要なエラー：CP402_INSUFFICIENT_PLANまたはCP403_FORBIDDENは、そのエンドポイントに有料プランが必要であることを示します。環境変数COINPAPRIKA_API_KEYを設定してください
• タイムアウトエラー：大量のデータを要求すると時間がかかる場合があるため、limitパラメーターを小さくしてください
• ネットワークエラー：ネットワーク接続を確認してください。このサービスにはインターネットアクセスが必要です

開発

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

# Install dependencies
npm install

# Run in development
npm start

# Build for production
npm run build

変更履歴

詳細なリリースノートについては、CHANGELOG.mdを参照してください。

ライセンス

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

その他のリソース

• CoinPaprika APIドキュメント
• APIの料金とプラン
• ホスト型MCPサーバー、セットアップ不要のオプション
• DexPaprika MCP、DEXおよびDeFiデータを補完するパッケージ
• Model Context Protocol仕様
• CoinPaprika、包括的な暗号資産市場データ
• DexPaprika、オンチェーンDEX分析