sports-betting-mcp
The first MCP server for sports betting. Give any AI agent live access to picks, odds, game analysis, and performance tracking across NBA, NHL, NCAAB, and MLB.
mcp-name: io.github.seang1121/sports-betting-mcp
What It Does
Connects any MCP-compatible AI agent to a live sports betting analysis system. Every pick is logged before tip-off and resolved against final scores. Nothing is cherry-picked.
| Metric | Value |
|---|
| Sports Covered | NBA, NHL, NCAAB, MLB |
| Bet Types | Moneyline, Spread, Totals |
| Pick Source | 12-agent consensus model |
| Total Picks | 3,859+ resolved |
| Platform Users | 30 |
| Tools | 12 MCP tools |
| Auth | API key (X-API-Key header) |
Results by Sport
| Sport | Picks | Wins | Win Rate |
|---|
| NBA | 1,267 | 762 | 60.1% |
| NHL | 1,148 | 656 | 57.1% |
| NCAAB | 1,149 | 549 | 47.8% |
| MLB | 283 | 109 | 38.5% (launched Apr 2026) |
All results are queryable in real-time via the get_win_rate tool. Numbers update after every game.
Quick Start
Install
pip install sports-betting-mcp
Add to Your MCP Client
Drop this into your MCP config (Claude Desktop, Cursor, Windsurf, Claude Code, etc.):
{
"mcpServers": {
"sports-betting": {
"command": "sports-betting-mcp",
"env": {
"SPORTS_BETTING_API_URL": "https://sportsbettingaianalyzer.com",
"SPORTS_BETTING_API_KEY": "your_api_key"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|
SPORTS_BETTING_API_KEY | Yes | Your API key for authentication |
SPORTS_BETTING_API_URL | No | API base URL (defaults to http://localhost:5000) |
Works With
Any client that supports the Model Context Protocol:
| Client | Status |
|---|
| Claude Desktop | Fully supported |
| Cursor | Fully supported |
| Windsurf | Fully supported |
| Claude Code (CLI) | Fully supported |
| Any MCP Client | Fully supported via stdio transport |
12 tools. Every call returns structured data that AI agents can reason over, display, or act on.
Picks & Analysis
| Tool | What It Does |
|---|
get_todays_picks | All AI picks with confidence scores and edge breakdowns, filterable by sport |
get_top_pick | Single highest-confidence pick of the day |
get_pending_picks | Currently unresolved picks that are still in play |
get_completed_picks | Recently resolved picks with W/L results -- verify the track record |
analyze_game | Full 12-agent analysis on any game: consensus pick + edge breakdown |
Odds & Market Data
| Tool | What It Does |
|---|
get_live_odds | Live moneyline, spread, and totals for today's games |
get_alerts | Active alerts from the multi-agent system (line moves, injury impacts) |
| Tool | What It Does |
|---|
get_win_rate | Win rate with breakdown by sport and bet type |
get_model_stats | Model performance: total picks, last-20 win rate, confidence tier breakdown |
get_leaderboard | User rankings by win rate |
get_system_status | Health check -- uptime, database, scheduler status |
How the Analysis Works
Each game runs through a multi-agent pipeline:
- 12 specialized agents evaluate the game independently -- covering momentum, matchups, injuries, rest, travel, public betting percentages, sharp money indicators, historical trends, and more.
- A consensus engine synthesizes all 12 opinions into a single pick with a confidence score.
- Edge calculation compares the model's implied probability against the current market line.
- Picks are logged before tip-off and resolved against final scores. No retroactive edits.
The confidence score and edge breakdown are included in every pick response, so your AI agent can filter, rank, or explain the reasoning behind any recommendation.
Full API — 22 Endpoints
The API has two tiers: Free (any API key) and Pro (approved access).
Free Tier (available to all API key holders)
| Endpoint | Method | What It Does |
|---|
/xk/p | GET | Today's AI picks with confidence scores |
/xk/o/{sport} | GET | Live odds from FanDuel/BetMGM |
/xk/w | GET | Win rate breakdown by sport and bet type |
/xk/i | GET | Active injury report from Covers.com |
/xk/m | GET | Significant line movement (sharp money signals) |
/xk/games | GET | Today's full schedule with odds snapshot and AI pick flags |
/xk/stats | GET | Model performance by sport, bet type, confidence tier |
/xk/lb | GET | Leaderboard — AI vs human win rates |
/xk/news | GET | Sports news feed from RSS sources |
/xk/q | GET | Currently pending (unresolved) picks |
Pro Tier (requires approved access)
| Endpoint | Method | What It Does |
|---|
/xk/full | GET | Full structured picks — complete edge breakdowns, positive/negative edges, reasoning, scorecard, opposing side with odds, line movement, quality flags |
/xk/analyze | POST | On-demand 12-agent analysis for any game — send team names, get full consensus |
/xk/results | GET | Resolved picks with W/L, actual scores, profit, top contributing edges |
/xk/clv | GET | Closing Line Value analysis — did the line move in our favor? |
/xk/search | GET | Search all picks by team name with W/L record |
/xk/log | POST | Log a pick (supports flip flag, pick source tracking) |
/xk/log/batch | POST | Batch log up to 20 picks with per-pick success/duplicate/error status |
/xk/history | GET | Your pick history — pending, resolved, win rate |
/xk/slip | POST | Generate Nimrod bet slip image |
/xk/webhook | POST/GET/DELETE | Register webhooks for pick events |
/xk/full | GET | Includes fade/flip data for every pick — opposing side, line, odds |
Pro Pick Payload
Every pick from /xk/full includes:
{
"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 Tracking (for learning)
When logging picks, include pick_source to track decision types:
model_agree — following the AI's pickflip — fading/betting against the AImanual_override — custom pick
This enables win rate comparison between model-agree vs flip picks over time.
API Authentication
Authenticate with X-API-Key header. Get a free key at sportsbettingaianalyzer.com. Pro access requires admin approval.
Tech Stack
| Component | Technology |
|---|
| Runtime | Python 3.10+ |
| Protocol | MCP (Model Context Protocol) |
| Transport | stdio |
| Build | Hatchling |
| Distribution | PyPI (sports-betting-mcp) |
| Backend | Flask + SQLite |
| Analysis | 12-agent consensus pipeline |
| Sports | NBA, NHL, NCAAB, MLB |
License
MIT