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_markets | venueをまたぐマッチング済みカタログを、正規のmarketオブジェクトとして返します。sport、league、status、signalで絞り込めます。GET /v2/markets に対応します。 | 有効なキーであれば誰でも |
find_arbitrage | 確定済みのvenue横断アービトラージ機会を、sportで絞り込んで返します。signal が "arb" の正規marketオブジェクト(パリティ確認済み、解決リスクのブロックなし、potential_arb_pct 値あり)を返します。GET /v2/markets?signal=arb に対応します。 | 有効なキーであれば誰でも |
get_market | id(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_coverage | venueカバレッジ・センサス、つまり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_arbitrage と list_markets はどちらもmarketオブジェクト(signal、potential_arb_pct、outcomes)を返します。解決の詳細は各venue固有のものです。エージェントが実行前に不一致を検証する必要がある場合は、get_market(またはREST の /v2/pairs/{market_id} エンドポイント)を呼び出して、開示済みリスクの完全な詳細を取得してください。
ティアの現れ方
MCPツールはHTTPステータスではなくデータを返すため、キーに権限がない場合でも、ツールは本文内にステータスを含めて応答します。Freeキーが watch_markets を呼び出すと、エージェントが読めないエラーではなく、402 とアップグレードURLが返ります。これにより、エージェントは結果を見て分岐し、アップグレードを促すことができます。
製品全体のエージェント可読な概要は、あなたのエージェントを/llms.txtに向けてください。