公式MCPサーバーOdds API MCPサーバー
AIアシスタント向け

Claude、Codex、Cursor、VS Codeを450以上のブックメーカーのライブオッズと過去オッズに接続できます。価格、ラインの推移、バリューベット、ベットの結果を普段の言葉で尋ねたり、アシスタントにコードを書かせたりできます。

無料・オープンソース · 33のツール · npm、Docker、Claude Desktopのワンクリックインストールに対応

セットアップ

1分もかからず接続できます

APIキーを取得する
プランとブックメーカーを選びます。支払いが完了すると、すぐにダッシュボードにキーが表示されます。
AIツールにサーバーを追加する
コマンドを1つ、またはJSONブロックを1つ貼り付けるだけです。サーバーはnpxまたはDockerでお使いのマシン上で動作し、キーは環境変数から読み込みます。
普段の言葉で尋ねる
アシスタントが適切なツールを選んでAPIを呼び出し、ライブの価格で答えます。同じデータを使ってコードを書き、テストすることもできます。

ターミナルで実行

claude mcp add odds-api \
  --env ODDS_API_KEY="your-api-key" \
  -- npx -y odds-api-mcp-server

ターミナルで実行

codex mcp add odds-api \
  --env ODDS_API_KEY="your-api-key" \
  -- npx -y odds-api-mcp-server

claude_desktop_config.jsonに追加

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

.cursor/mcp.jsonに追加

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

.vscode/mcp.jsonに追加

{
  "servers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

どのMCPクライアントでも利用可能、Node.js不要

{
  "mcpServers": {
    "odds-api": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ODDS_API_KEY",
        "oddsapi/odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktopをお使いですか？最新リリースから.mcpbファイルをダウンロードして開いてください。Claudeがキーを尋ね、あとは自動で設定します。

例

尋ねられること

ライブデータで答える実際の質問です。各質問の下に、アシスタントが回答に使うツールを示しています。

今週末のPremier Leagueの試合で、勝敗のオッズがBet365とUnibetで最も大きく離れているのはどれ？
get_eventsget_multi_odds
Arsenal対ChelseaのOver 2.5ゴールのオッズは、昨日からBet365でどう動いた？
search_eventsget_odds_movements
今夜、最も速く下落しているNBAのオッズは？
get_dropping_odds
今Betanoで出ているバリューベットを期待値の高い順に一覧にして。
get_value_bets
昨日のPremier Leagueの試合で、Liverpoolのアジアンハンディキャップ-1とOver 2.5ゴールに賭けた。ベットは当たった？
get_historical_eventsgrade_bets
自分のブックメーカー間で2%を超えるアービトラージが出たらTelegramにメッセージを送るPythonスクリプトを書いて。
get_documentationget_arbitrage_bets

ツール

33のツールでAPI全体をカバー

ツールはv3 APIの全体をカバーしているので、アシスタントがチャットで見つけたものは、コードでもそのまま同じように動きます。

オッズ

get_odds: 1つのイベントの全マーケットを最大30社のブックメーカーから取得
get_multi_odds: 最大10イベントのオッズを1回の呼び出しで取得
get_updated_odds: 指定したタイムスタンプ以降に変わったオッズのみ
get_odds_summary: ライン別の最高・平均・最低・フェアプライスをブックメーカー横断で
get_odds_movements: 1社のブックメーカーにおける1つのラインの価格履歴
get_dropping_odds: オープン時から大きく下落したラインを競技・リーグ別に

イベント

get_events: 競技、リーグ、チーム、日付、ステータスで試合を検索
get_event: IDで1つのイベントを取得
get_live_events: 現在進行中のすべてのイベント
search_events: チーム名でイベントを検索

ベッティングツール

get_value_bets: ブックメーカーの期待値がプラスの価格
get_arbitrage_bets: 選択したブックメーカー間のアービトラージの機会

履歴と精算

get_historical_events: 競技、リーグ、日付で終了したイベントを検索
search_historical_events: チーム名で終了したイベントを検索
get_historical_odds: 終了したイベントのクロージングオッズと最終スコア
get_closing_lines: 最大10リーグのクロージングラインを一括取得
get_settlements: 最大50イベントのステータスとピリオド別の最終スコア
grade_bets: 最大50件のベットを勝ち、負け、無効、ハーフで精算

ゴルフのアウトライト

list_outrights: ツアー別の大会と、各大会に価格を出しているブックメーカー数
get_outright_odds: 大会の優勝、トップ5/10/20、予選通過のオッズ
get_outright_results: 最終順位と各マーケットの的中結果

リファレンス

get_sports: すべての競技とそのスラッグ
get_leagues: 競技ごとのリーグとイベント数
get_markets: 競技ごとの正確なマーケット名（プレマッチとライブ）
get_bookmakers: すべてのブックメーカーと稼働状況
get_participants: 競技ごとのチームと選手
get_participant: IDで1つのチームまたは選手を取得
get_mappings: 当社のイベントと選択肢に対応するブックメーカー独自のID

アカウントとドキュメント

get_selected_bookmakers: プランに含まれるブックメーカー
select_bookmakers: 選択にブックメーカーを追加
clear_selected_bookmakers: 選択のリセット（12時間に1回まで）
get_usage: 1時間あたりの上限、残りリクエスト数、リセット時刻
get_documentation: APIの完全なドキュメント。コードが最初の実行から動きます

仕組み

お使いのマシンで動き、ライブAPIを読み取ります

キーはお使いのマシンの中に

サーバーはstdio経由でローカルに動作し、api.odds-api.ioと直接通信します。間には何も挟まず、キーはMCP設定の中に保持されます。

APIと同じデータ

450以上のブックメーカー、34競技、プレマッチとライブを1つのJSONスキーマで。アシスタントが見るデータが、そのままコードが受け取るデータです。

アシスタントが読めるドキュメント

サーバーは完全なドキュメントとOpenAPI仕様をMCPリソースとして提供します。コードを頼むと、アシスタントはまず実際のフィールド名を確認します。

すべてのプランに含まれます

MCPサーバーは無料のオープンソースです。ツールの呼び出しは通常のAPIリクエストとして扱われ、毎時5,000リクエストの上限にカウントされます。

よくある質問

MCPサーバーに関する質問

Odds API MCPサーバーとは何ですか？

Odds-API.io公式のModel Context Protocolサーバーです。Claude、Codex、CursorなどのAIアシスタントに33のツールを提供し、450以上のブックメーカーのライブオッズと過去オッズ、イベント、バリューベット、アービトラージ、ベットの結果を読み取れるようにします。

どのAIツールで使えますか？

stdio経由のMCPに対応したクライアントならどれでも使えます。Claude Code、Claude Desktop、Codex、Cursor、GitHub Copilotを使ったVS Code、Windsurf、Zedなどです。Claude Desktopにはワンクリックでインストールできるファイルもあります。

有料プランは必要ですか？

はい。サーバーにはAPIキーが必要で、キーはすべての有料プランに含まれます。最も手頃なのはSoloプラン（月額£49、ブックメーカー2社）です。MCPサーバー自体に追加料金はかかりません。

アシスタントはどのブックメーカーを見られますか？

プランで選択したブックメーカーです。アシスタントにget_selected_bookmakersを実行するよう頼むと確認できます。競技、リーグ、イベントなどのリファレンスデータは、すべてのブックメーカーについて利用できます。

ライブオッズにも対応していますか？

はい。get_live_eventsで進行中の試合を一覧表示し、get_oddsで現在の価格を取得できます。自分のアプリでストリーミングを受け取るにはWebSocket APIを使います。そのコードもアシスタントが書けます。

APIキーは安全ですか？

サーバーはお使いのコンピューター上で動作し、キーはapi.odds-api.ioにのみ送信されます。ホスト型のプロキシはありません。コードはMITライセンスでGitHubに公開されています。

アシスタントがベットを行うことはできますか？

いいえ。サーバーはデータを読み取るだけです。ブックメーカーにログインしたり、ベットを行ったりすることはできません。

llms.txtのドキュメントとはどう違いますか？

llms.txtはアシスタントにドキュメントを渡し、コードを書けるようにするものです。MCPサーバーを使うと、チャット中にアシスタントがAPIを呼び出してライブデータを扱えます。多くの方が両方を使っています。

アシスタントにライブオッズを

すべてのプランにMCPサーバー、毎時5,000リクエスト、全競技・全マーケットが含まれます。月払いか年払いを選べて、解約は毎月いつでも可能です。

プランを見る AIセットアップガイド Claudeチュートリアル