odds-api-mcp-server

Odds-API.io MCP サーバー

Odds-API.io 用の Model Context Protocol（MCP）サーバーです。Claude、Cursor、VS Code などの AI ツールから、スポーツベッティングのオッズデータに直接アクセスできます。

AI ツールのドキュメント全文：docs.odds-api.io/ai-vibe-coding

特長

• 25 個の API ツールで Odds-API.io v3 の API 全体を網羅：スポーツ、イベント、オッズ、過去データ、賭けの精算、バリューベット、アービトラージ、下落するオッズなど
• AI コンテキスト向けのドキュメントリソース
• 34 種類のスポーツを対象に、450 社以上のブックメーカーからリアルタイムデータを取得

クイックスタート

ワンクリックインストール（Claude Desktop）

Releases から最新の .mcpb ファイルをダウンロードして開きます。Claude Desktop から API キーの入力を求められます。

Claude Code CLI

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

Claude Desktop

Claude Desktop の設定に追加します（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）。

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

Cursor

Cursor の MCP 設定に追加します（プロジェクト内の .cursor/mcp.json またはグローバル設定）。

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

VS Code

VS Code の設定に追加します（.vscode/mcp.json）。

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

グローバルインストール（代替方法）

npm install -g odds-api-mcp-server

その後、npx -y odds-api-mcp-server の代わりに odds-api-mcp をコマンドとして使用します。

設定

変数	必須	説明
ODDS_API_KEY	はい	odds-api.io で取得した API キー

利用可能なツール

スポーツとリーグ

ツール	説明
get_sports	利用可能なすべてのスポーツとスラッグを一覧表示
get_leagues	スポーツのリーグを取得（非アクティブなリーグを含める場合は、任意で all フラグを指定）
get_markets	スポーツで提供される正確なマーケット名を、形式、期間、試合前／ライブでの利用可否とともに一覧表示

ブックメーカー

ツール	説明
get_bookmakers	サポートされているすべてのブックメーカーを一覧表示
get_selected_bookmakers	現在選択されているブックメーカーを取得
select_bookmakers	選択したブックメーカーに追加
clear_selected_bookmakers	選択したブックメーカーをすべて解除（12 時間に 1 回）

イベント

ツール	説明
get_events	フィルタリング（リーグ、ステータス、日付範囲、参加者、ブックメーカー、ページネーション）でイベントを取得
get_event	ID で単一のイベントを取得
get_live_events	現在ライブ中のイベントを取得
search_events	チーム名またはテキストでイベントを検索

オッズ

ツール	説明
get_odds	選択したブックメーカーのイベントオッズを取得
get_multi_odds	1 回の呼び出しで最大 10 件のイベントのオッズを取得
get_odds_movements	マーケットの過去のライン変動を取得
get_updated_odds	指定したマーケットの最近変更されたオッズを取得（ポーリング）

過去データ

ツール	説明
get_historical_events	スポーツ／リーグ／日付範囲を指定して終了済みのイベントを取得
get_historical_odds	終了済みのイベントの最終オッズとスコアを取得

ベッティング分析

ツール	説明
get_settlements	最大 50 件のイベントのステータス、最終スコア、final フラグ
grade_bets	最大 50 件の賭けを、勝ち、負け、無効、半勝ち、半負けとして精算
get_value_bets	ブックメーカーの期待値がプラスの機会を取得
get_arbitrage_bets	最適な賭け金を含むアービトラージの機会を取得
get_dropping_odds	スポーツ、リーグ、マーケット、時間枠ごとに、鋭敏なブックメーカーのライン変動を追跡

参加者

ツール	説明
get_participants	スポーツのチーム／参加者を取得
get_participant	ID で単一の参加者を取得

リファレンス

ツール	説明
get_documentation	API ドキュメント全体を取得します

リソース

リソース URI	説明
odds-api://documentation	API ドキュメント全体
odds-api://openapi	OpenAPI/Swagger 仕様

使用例

設定後、AI アシスタントに次のような質問をしてみましょう。

• 「Odds-API ではどのスポーツを利用できますか？」
• 「プレミアリーグの今後の試合を表示してください」
• 「Bet365 と SingBet の、次の Arsenal の試合のオッズを取得してください」
• 「イベントの詳細を含めて、Bet365 でバリューベットを探してください」
• 「Bet365 と Unibet の間にアービトラージの機会はありますか？」
• 「スプレッド市場におけるイベント 12345 のオッズの推移を表示してください」
• 「2026 年 1 月のラ・リーガの過去の結果を取得してください」
• 「現在、サッカーで最も大きく下落しているオッズを表示してください」
• 「過去 12 時間で最も大きく下落したプレミアリーグのオッズは何ですか？」

開発

git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm test

ライセンス

MIT

リンク

• Odds-API.io - 公式ウェブサイト
• ドキュメント - API ドキュメント
• API リファレンス - Swagger/OpenAPI
• npm - パッケージレジストリ