Skip to content

MCPサーバー

ネイティブのModel Context Protocolサーバーにより、コーディングエージェントはクライアントコードを書かずにマッチング済みフィードとライブの機会を読み取れます。すべてのプランで無料です。

このAPIは、ネイティブのModel Context Protocolサーバーでもあります。ClaudeやCursorのようなコーディングエージェントは、クライアントコードを書かずに、マッチング済みフィード、機会、その他のカタログをツールとして呼び出せます。サーバー自体はすべてのプランで無料です。ツール一覧はどのキーにも公開されていますが、各ツールが返すデータはキーのティアによって制限されます。

サーバーは https://api.dino.markets/v2/mcp/ でStreamable HTTPとして動作します(末尾のスラッシュに注意してください。厳格なMCPクライアント/スキャナーは、スラッシュなしの /v2/mcp から /v2/mcp/ へのリダイレクトで 502 になることがあります)。

接続する

APIキーをbearerトークンとして認証してください。RESTと同じキーが使えます。多くのMCPクライアントは mcp-remote 経由で接続します。これはローカルのクライアントをHTTPエンドポイントに橋渡しします。

{
  "mcpServers": {
    "dino-markets": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.dino.markets/v2/mcp/",
        "--header",
        "Authorization:Bearer ${DINO_API_KEY}"
      ],
      "env": { "DINO_API_KEY": "sk_live_..." }
    }
  }
}

Streamable HTTPを直接話すクライアントであれば、mcp-remote を使わずにURLへ直接接続し、Authorization: Bearer sk_live_... を自分で送信できます。

ツール

各ツールはRESTエンドポイントに対応しています。5つはカタログの読み取り用で、有効なキーであれば誰でも無料で使えます。watch_markets はストリームチケットを発行するもので、有料プランが必要です。v2には個別のpair一覧ツールはなく、pair詳細は get_market に統合されています。

ツール内容プラン
list_marketsvenueをまたぐマッチング済みカタログを、正規のmarketオブジェクトとして返します。sport、league、status、signalで絞り込めます。GET /v2/markets に対応します。有効なキーであれば誰でも
find_arbitrage確定済みのvenue横断アービトラージ機会を、sportで絞り込んで返します。signal"arb" の正規marketオブジェクト(パリティ確認済み、解決リスクのブロックなし、potential_arb_pct 値あり)を返します。GET /v2/markets?signal=arb に対応します。有効なキーであれば誰でも
get_marketid(list_markets または find_arbitrage からの dino_<uuid> または裸のUUID)で指定した1件の正規marketオブジェクトを、解決の開示、venue id、板の厚み(デプス)付きで返します。取引前にはこれを読んでください。GET /v2/pairs/{market_id} に対応します。有効なキーであれば誰でも
list_leaguesシーズン中のスポーツとリーグを、スポーツごとのopen/live/settled件数付きで返します。GET /v2/leagues に対応します。有効なキーであれば誰でも
get_coveragevenueカバレッジ・センサス、つまりKalshiに上場している対戦形式のリーグすべてを(組み込み済みかどうかにかかわらず)その集約ステータスとともに、スポーツレベルのPolymarket側余剰も添えて返します。GET /v2/coverage に対応します。有効なキーであれば誰でも
report_bad_arbおかしいと思う機会を通報します。opp_id にはmarketの id 値を渡します。POST /v2/report-bad-arb に対応します。有効なキーであれば誰でも
watch_marketsリアルタイムWebSocketストリーム用のチケットを発行し、ws_url とあなたのティアで許可されたチャンネルを返します。結果内の allowed.channels を正とみなしてください。BasicとProのトークンはv2の markets:* マッチング済みフィード・チャンネルを取得します。POST /v1/stream/token に対応します(v2でも変更なし)。Basic、Pro

ツールが返すデータは対応するRESTエンドポイントと一致するため、find_arbitragelist_markets はどちらもmarketオブジェクト(signal、potential_arb_pct、outcomes)を返します。解決の詳細は各venue固有のものです。エージェントが実行前に不一致を検証する必要がある場合は、get_market(またはREST の /v2/pairs/{market_id} エンドポイント)を呼び出して、開示済みリスクの完全な詳細を取得してください。

ティアの現れ方

MCPツールはHTTPステータスではなくデータを返すため、キーに権限がない場合でも、ツールは本文内にステータスを含めて応答します。Freeキーが watch_markets を呼び出すと、エージェントが読めないエラーではなく、402 とアップグレードURLが返ります。これにより、エージェントは結果を見て分岐し、アップグレードを促すことができます。

製品全体のエージェント可読な概要は、あなたのエージェントを/llms.txtに向けてください。