TheRundown Data MCP

TheRundown 公式データ MCP

これは TheRundown の公式ソースリポジトリです。aigeon-ai/therundown は非公式です。

0.4.0 のソース候補では、75 個の公開 REST 操作ツール、実際の WebSocket を使用する範囲限定のキャプチャツール 4 個、既存の利便性ツール 6 個が登録されます。公式 MCP SDK と Node.js 22+ を使用します。正確なルート、エイリアス、廃止済み／非公開の除外項目、トランスポートの制限については、COVERAGE.md をご覧ください。

ホスト型アカウント接続先は https://mcp.therundown.io/oauth/mcp です。旧式の / と /mcp では、認証済みヘッダーの Product API キーを受け付けます。2026-10-03 に確認された最後の稼働状況では、バージョン 0.3.0 にツールが 6 個ありました。この拡張候補は、まだデプロイも一般公開もされていません。個人用の接続は、ディレクトリへの掲載を意味しません。別途提供されているドキュメント MCP（https://docs.therundown.io/mcp）では、Product の価格を取得できません。

ChatGPT では Streamable HTTP を使用します。各キャプチャでは、実際の上流 WebSocket 接続を開き、最大 5 秒間、50 メッセージ、256 KiB までのデータを監視してから閉じます。継続的にバックグラウンドで配信するものではありません。チャンネル、スナップショット、再開の制限については COVERAGE.md を、デプロイ要件については HOSTED.md をご覧ください。

匿名でのメタデータ取得と ping では、Product への呼び出しは行われません。すべてのデータツールでは、ローカルキー認証、または OAuth ルートで接続されたアカウントが必要です。認証情報をプロンプト、URL、ソース、ログ、ブラウザーバンドルに含めないでください。

以下の過去のソース ZIP は引き続き 0.2.3 であり、この候補は含まれていません。公開済みの npm パッケージはありません。この ZIP は stdio 専用です。npm start では HTTP アダプターは起動しません。

バージョン付きソースバンドルをダウンロードし、SHA-256 チェックサムを検証してから、展開してください。公式 ZIP のサイズは 41,072 バイトで、SHA-256 は cb0a0841aa040f049ffddec5b5fa2436cb9de721a30a3bd53270132db7204025 です。ZIP マニフェストで、バンドル内のすべてのソースファイルを検証できます。ZIP 内の README は BUNDLE-README.md から生成されています。このリポジトリの README には、リポジトリのセットアップ手順も記載されています。展開した ZIP のディレクトリで、次のコマンドを実行します。

npm ci --ignore-scripts
npm test

代わりにチェックアウトしたソースを実行するには、このリポジトリで Node.js 22+ を使用します。

npm ci --ignore-scripts
npm test

Claude Desktop の手動ローカル設定では、対応している環境で claude_desktop_config.json に以下を追加し、クライアントを再起動してください。Node 22+ とサーバーのパスには絶対パスを指定してください。このソース ZIP は .mcpb デスクトップ拡張機能ではありません。

{
  "mcpServers": {
    "therundown-data": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/therundown-data-mcp-0.2.3/server.mjs"],
      "env": { "THERUNDOWN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Cursor では、グローバル設定ファイル ~/.cursor/mcp.json を使用し、Cursor の起動環境でキーを利用できるようにしてください。

{
  "mcpServers": {
    "therundown-data": {
      "type": "stdio",
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/therundown-data-mcp-0.2.3/server.mjs"],
      "env": { "THERUNDOWN_API_KEY": "${env:THERUNDOWN_API_KEY}" }
    }
  }
}

クライアントの参考資料：ローカル MCP サーバー、Cursor。

パスとキーはローカル環境に合わせて置き換えてください。利用可能な場合は、クライアントのシークレットストレージ、または継承される環境変数を使用してください。値を入力したクライアント設定ファイルをコミットしないでください。サーバーはプロセス環境から THERUNDOWN_API_KEY を読み取り、X-TheRundown-Key としてのみ送信します。キーをツール引数として受け付けることはありません。stdout には MCP プロトコルメッセージのみが出力されます。キーがなくても、プロセスは MCP メタデータの検出に利用できる状態を保ちます。Product ツールの呼び出しには、ネットワークリクエストを行わず、サニタイズ済みの missing_credentials エラーを返します。

元からある 6 個の利便性ツールは次のとおりです。

ツール	機能	検出に使用しない場合
list_sports	現在公開されているスポーツ ID と名前を一覧表示します。	カタログの行から、そのスポーツにイベントや価格データがあると推測しないでください。
list_affiliates	現在公開されているアフィリエイト ID と名前を一覧表示します。	指定されたスポーツやマーケットをブックが提供している証拠として使用しないでください。廃止された 27 は除外されています。
list_markets	マーケット定義、またはスポーツを指定した日付別のマーケットを一覧表示します。	定義をオープン価格として扱わないでください。日付別の検出では live は拒否されます。
list_events	1 つのスポーツについて、日付付きイベントの概要と利用可能なマーケット ID を検索します。	記憶や似た名前の検索結果からイベントを選択しないでください。まず参加者、日付、タイムゾーンを正確に特定してください。
get_main_lines	正確なイベント ID を指定して、アフィリエイトごとのオープンなメインラインを取得します。	list_events の前に呼び出したり、イベントの検索に使ったりしないでください。返された正確な ID が必要です。
list_futures	公開スケジュール、精算情報、オープンなメインラインのフィールドを含む、範囲指定された先物競技ボードを一覧表示します。	通常の日付付きイベントの検出には使用しないでください。また、カタログや精算のステータスだけでボードの精算が完了したと判断しないでください。

list_markets はカタログの検出に対応しており、sport_id と date を指定して利用可能なマーケットを検出することもできます。日付ベースの検出では、エンドポイントがライブマーケットを分類しないため、live は拒否されます。イベントクエリでは常に main_line=true、hide_closed=true、include=all_periods を使用します。list_futures は Ultra+ の競技エンドポイントで、範囲指定されたデフォルト値 [1141] と [19,23]、不透明なカーソルによるページネーション、公開スケジュール／精算フィールド、およびライン ID のないアフィリエイトごとのオープンなメインラインに対応しています。日付付きイベントツールのデフォルト値は、引き続きマーケット [1,2,3] とアフィリエイト [19,23] です。ライブマーケット [41,42,43] は明示的に渡してください。廃止されたアフィリエイト 27 は拒否され、検出対象から除外されます。

最初の会話

Use TheRundown to list current sports and affiliates. Find MLB (sport 3).
For today's UTC date, list events with market_ids [1,2,3]
and affiliate_ids [19,23]. Select an event ID from that response and
call get_main_lines with the same filters.
Show the source URL, each book's line value and price updated_at,
and the returned usage headers. Explain empty results without inventing odds.

npm test はオフラインで実行できます。実際の Product API データを確認するには、THERUNDOWN_API_KEY を非公開で設定し、npm run smoke を実行してください。デフォルトでは、MLB とアフィリエイト [19,23] の試合前マーケット [1,2,3] を確認します。Free プランには遅延した試合前オッズが含まれますが、ライブオッズ、プロップ／代替マーケット、履歴データは含まれません。ソースカタログの行があるだけでは、そのデータへのアクセス権は得られません。

利用資格のあるキーを使う場合、THERUNDOWN_SMOKE_LIVE=1 npm run smoke でライブ [41,42,43] もリクエストします。THERUNDOWN_SMOKE_DATE=YYYY-MM-DD と THERUNDOWN_SMOKE_SPORT_ID で、日付範囲を指定します。範囲を限定して Ultra+ の競技を確認するには、THERUNDOWN_SMOKE_FUTURES=1 と、40（PGA）や 41（Formula 1）などのスポーツを設定します。この場合、マーケット 1141 とアフィリエイト 19,23 のみをリクエストします。チェックの期限は 60 秒です。レビュー済みのソースツールマニフェストを検証し、UTC のチェック時刻、範囲、選択したイベント ID、ソース URL、使用状況、件数を報告します。status: "ok"、完全なソースツールマニフェスト、正のイベント件数とメインライン件数が必要です。データが空の場合は結論を出せず、終了コード 2 で終了します。これらのリクエストはオプトインであり、使用量が計上されます。

使用量、API プランによる遅延、利用資格は、すべてのリクエストに適用されます。カタログ、日付別マーケット、イベント、メインラインの各ページはローカルでページネーションするため、各ページでスナップショットを再取得し、個別に使用量が計上されます。list_futures は API の上流の不透明なカーソルとページ制限を使用します。各カーソルページも使用量が計上されるリクエストであり、has_more が true の場合は競技一覧の一部にすぎません。結果には、安全なソース URL、取得タイムスタンプ、API 使用状況ヘッダー、価格ごとの updated_at が含まれます。取得タイムスタンプは、価格が最新である証拠にはなりません。

エージェント向け概要とエラー（0.2.1 以降）

現在の Build with AI のルールと最初の会話については、MCP リソースを通じて therundown://brief を読み取ってください。初期化時にも同じ指示が返されます。どちらの操作も Product API を呼び出しません。

HTTP エラーでは、安全なソース URL、取得時刻、使用量ヘッダーとともに、status、plan、missing_entitlement、required_plan、retry_after（秒）、remaining_points、monthly_remaining_points、limit_reason が返されます。API から認識可能な値が提供されない場合、フィールドは null のままです。サーバーは、拒否された機能から現在のプランを推測しません。上流の未加工のエラーボディが返されることはなく、エラーが発生しても自動的に再試行されません。

空の成功結果では通常の data の形式が維持され、コード、説明、リクエスト範囲を含む empty が追加されます。日付付きの結果には、スポーツ、日付、日付境界のオフセット（ゼロの場合は UTC）が示されます。既存の結果を超えるページは、結果が空である場合とは別に識別されます。オッズが空でも、対象が存在しないことの根拠にはなりません。

セットアップガイド、DESIGN.md、認証、課金を参照してください。最新の公開仕様と ID については、OpenAPI 仕様、スポーツカタログ、マーケットカタログ、アフィリエイトカタログ、TheRundown の llms.txt、ドキュメントの llms.txtを参照してください。