Sports Betting Mcp

sports-betting-mcp

スポーツベッティング初の MCP サーバーです。 あらゆる AI エージェントから、NBA、NHL、NCAAB、MLB の予想、オッズ、試合分析、成績追跡にリアルタイムでアクセスできます。

mcp-name: io.github.seang1121/sports-betting-mcp

---

できること

あらゆる MCP 対応 AI エージェントを、ライブスポーツベッティング分析システムに接続します。すべての予想は試合開始前に記録され、最終スコアに基づいて結果が確定します。都合のよい予想だけを選ぶことはありません。

指標	値
対象スポーツ	NBA、NHL、NCAAB、MLB
賭けの種類	マネーライン、スプレッド、トータル
予想の情報源	12エージェントの合意モデル
予想の合計数	3,859件以上（結果確定済み）
プラットフォームのユーザー数	30
ツール	MCP ツール12個
認証	API キー（X-API-Key ヘッダー）

スポーツ別の結果

スポーツ	予想数	的中数	的中率
NBA	1,267	762	60.1%
NHL	1,148	656	57.1%
NCAAB	1,149	549	47.8%
MLB	283	109	38.5% (2026年4月開始)

すべての結果は、get_win_rate ツールからリアルタイムで照会できます。数値は試合のたびに更新されます。

---

クイックスタート

インストール

pip install sports-betting-mcp

MCP クライアントに追加する

MCP 設定に以下を追加してください（Claude Desktop、Cursor、Windsurf、Claude Code など）。

{
  "mcpServers": {
    "sports-betting": {
      "command": "sports-betting-mcp",
      "env": {
        "SPORTS_BETTING_API_URL": "https://sportsbettingaianalyzer.com",
        "SPORTS_BETTING_API_KEY": "your_api_key"
      }
    }
  }
}

環境変数

変数	必須	説明
SPORTS_BETTING_API_KEY	はい	認証用の API キー
SPORTS_BETTING_API_URL	いいえ	API のベース URL（デフォルトは http://localhost:5000）

---

対応クライアント

Model Context Protocolに対応するあらゆるクライアントで利用できます。

クライアント	状態
Claude Desktop	完全対応
Cursor	完全対応
Windsurf	完全対応
Claude Code (CLI)	完全対応
あらゆる MCP クライアント	stdio トランスポート経由で完全対応

---

利用可能なツール

ツールは12個あります。すべての呼び出しが、AI エージェントによる推論、表示、または操作に使える構造化データを返します。

予想と分析

ツール	機能
get_todays_picks	信頼度スコアと優位性の内訳を含む、AI による本日の予想すべてを取得します。スポーツで絞り込めます
get_top_pick	本日の予想のうち、信頼度が最も高いものを1件取得します
get_pending_picks	現在プレイ中で、まだ結果が確定していない予想を取得します
get_completed_picks	最近結果が確定した予想と勝敗を取得し、実績を確認できます
analyze_game	任意の試合について、合意に基づく予想と優位性の内訳を含む、12エージェントによる詳細分析を行います

オッズと市場データ

ツール	機能
get_live_odds	本日の試合のライブマネーライン、スプレッド、トータルを取得します
get_alerts	マルチエージェントシステムからの有効なアラート（ラインの変動、負傷の影響）を取得します

実績と統計

ツール	機能
get_win_rate	スポーツ別および賭けの種類別の内訳を含む、的中率を取得します
get_model_stats	予想の合計数、直近20件の的中率、信頼度層別の内訳など、モデルの実績を取得します
get_leaderboard	的中率に基づくユーザーランキングを取得します
get_system_status	稼働時間、データベース、スケジューラーの状態を確認します

---

分析の仕組み

各試合は、複数エージェントによるパイプラインで分析されます。

1. 12の専門エージェントが、試合の勢い、相性、負傷、休養、移動、一般の賭け率、プロの資金を示す指標、過去の傾向などを個別に評価します。
2. コンセンサスエンジンが12の意見を統合し、信頼度スコア付きの単一の予想を生成します。
3. エッジの計算では、モデルが示す確率と現在の市場オッズを比較します。
4. 予想は試合開始前に記録され、最終スコアに基づいて結果が判定されます。事後の編集はできません。

信頼度スコアとエッジの内訳は、すべての予想レスポンスに含まれています。そのため、AI エージェントは各推奨をフィルタリング、順位付けしたり、根拠を説明したりできます。

---

API 全体 — 22 エンドポイント

API には 無料（任意の API キーで利用可能）と Pro（承認済みアクセス）の2つのティアがあります。

無料ティア（すべての API キー保有者が利用可能）

エンドポイント	メソッド	機能
/xk/p	GET	信頼度スコア付きの本日の AI 予想
/xk/o/{sport}	GET	FanDuel／BetMGM のリアルタイムオッズ
/xk/w	GET	スポーツと賭けの種類別の勝率内訳
/xk/i	GET	Covers.com の有効な負傷者レポート
/xk/m	GET	大幅なオッズ変動（プロの資金を示すシグナル）
/xk/games	GET	オッズのスナップショットと AI 予想フラグ付きの本日の全試合スケジュール
/xk/stats	GET	スポーツ、賭けの種類、信頼度ティア別のモデル成績
/xk/lb	GET	リーダーボード — AI と人間の勝率
/xk/news	GET	RSS ソースからのスポーツニュースフィード
/xk/q	GET	現在保留中（未判定）の予想

Pro ティア（アクセス承認が必要）

エンドポイント	メソッド	機能
/xk/full	GET	完全な構造化予想 — エッジの完全な内訳、プラス／マイナスのエッジ、根拠、スコアカード、オッズ付きの反対側、オッズ変動、品質フラグ
/xk/analyze	POST	任意の試合をオンデマンドで12エージェント分析 — チーム名を送信すると、完全なコンセンサスを取得できます
/xk/results	GET	W／L、実際のスコア、利益、主な寄与エッジを含む判定済み予想
/xk/clv	GET	クロージングラインバリュー分析 — オッズは有利な方向に動いたか
/xk/search	GET	チーム名と W／L 記録で全予想を検索
/xk/log	POST	予想を記録（反転フラグ、予想ソースの追跡に対応）
/xk/log/batch	POST	最大20件の予想を一括記録し、各予想の成功／重複／エラーのステータスを返します
/xk/history	GET	自分の予想履歴 — 保留中、判定済み、勝率
/xk/slip	POST	Nimrod のベットスリップ画像を生成
/xk/webhook	POST/GET/DELETE	予想イベント用の Webhook を登録
/xk/full	GET	すべての予想について、反対側、オッズ、配当を含むフェード／反転データ

Pro の予想ペイロード

/xk/full のすべての予想には、次の情報が含まれます。

{
  "ai_pick": "Lakers -5.5",
  "ai_verdict": "STRONG BET",
  "ai_probability": "65%",
  "ai_reasoning": "Lakers defense ranks top 5, opponent on B2B...",
  "edges": [13 individual edge factors],
  "top_edges": [top 5 positive],
  "negative_edges": [top 3 negative],
  "scorecard": [3 model scores],
  "fade_pick": "Celtics +5.5",
  "fade_team": "Celtics",
  "fade_odds": "+105",
  "fade_note": "Betting AGAINST the AI — take Celtics +5.5",
  "line_moved": true,
  "flags": ["line_moved"],
  "data_quality": "good"
}

予想ソースの追跡（学習用）

予想を記録する際に pick_source を含めると、判断の種類を追跡できます。

• model_agree — AI の予想に従う
• flip — AI の予想に逆らう賭け
• manual_override — カスタム予想

これにより、モデルに同意する予想と反転予想の勝率を、時間の経過とともに比較できます。

---

API 認証

X-API-Key ヘッダーで認証します。sportsbettingaianalyzer.com で無料キーを取得してください。Pro アクセスには管理者の承認が必要です。

---

技術スタック

コンポーネント	技術
ランタイム	Python 3.10+
プロトコル	MCP (Model Context Protocol)
トランスポート	stdio
ビルド	Hatchling
配布	PyPI (sports-betting-mcp)
バックエンド	Flask + SQLite
分析	12エージェントのコンセンサスパイプライン
スポーツ	NBA、NHL、NCAAB、MLB

---

関連プロジェクト

• Mortgage Rates MCP Server -- 17 の貸し手、13 個のツール、リアルタイムの住宅ローン金利情報
• March Madness Bracket Predictor -- 5 モデルのアンサンブル、14 年間のバックテスト、77％の精度、2026 年の優勝チームを正しく予測
• Agent Command Center -- MCP サーバー、エージェント、フック、cron ジョブ、リポジトリを自動検出するダッシュボード

ライセンス

MIT