Live sports betting MCP server — AI picks, odds, injuries, line movement across NBA, NHL, NCAAB, MLB. 12 tools for real-time game analysis.
Project description
sports-betting-mcp
The first MCP server for sports betting. Give any AI agent live access to picks, odds, injuries, line movement, and game analysis across NBA, NHL, NCAAB, and MLB.
mcp-name: io.github.seang1121/sports-betting-mcp
Track Record
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 |
| Tools | 12 MCP tools |
Results by Sport
| Sport | Record | Win Rate |
|---|---|---|
| NBA | Documented W/L | 59%+ |
| NHL | Documented W/L | 59%+ |
| NCAAB | Documented W/L | 60%+ |
| MLB | Documented W/L | Live |
All results are queryable in real-time through the get_win_rate tool. Ask your AI agent to pull the latest numbers -- they update after every game.
Why This Exists
Sportsbooks have the data. Bettors have opinions. AI agents have reasoning -- but no access to either.
This server is the bridge.
Before sports-betting-mcp, an AI agent could talk about sports betting but couldn't actually look at today's odds, check injury reports, analyze line movement, or generate a pick with a documented edge. It was guessing. Now it has a direct feed.
The system behind this MCP server runs a 12-agent analysis pipeline on every game: each agent evaluates a different angle (momentum, matchups, injuries, public betting %, sharp money, rest advantage, and more), then a consensus engine synthesizes them into a single pick with a confidence score and edge breakdown.
Works With
Any client that supports the Model Context Protocol can connect:
| 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 |
One install. Works everywhere.
Quick Start
Install
pip install sports-betting-mcp
Configure
export SPORTS_BETTING_API_URL=https://sportsbettingaianalyzer.com
export SPORTS_BETTING_API_KEY=your_api_key
sports-betting-mcp
Add to Your MCP Client
Drop this into your MCP config (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"sports-betting": {
"command": "sports-betting-mcp",
"env": {
"SPORTS_BETTING_API_URL": "https://sportsbettingaianalyzer.com",
"SPORTS_BETTING_API_KEY": "your_api_key"
}
}
}
}
Get a free API key at sportsbettingaianalyzer.com/account/api-keys.
Available Tools
12 tools. Every call returns structured data that AI agents can reason over, display, or act on.
| Tool | What It Does |
|---|---|
get_top_pick |
Highest-confidence pick of the day with a visual bet slip image |
get_todays_picks |
All AI picks with confidence scores, edges, and bet slip cards per sport |
get_live_odds |
Live moneyline, spread, and totals from FanDuel and BetMGM |
get_win_rate |
Real-time win rate with full record breakdown by sport and bet type |
get_pending_picks |
Currently unresolved picks that are still in play |
get_injury_report |
Active injuries affecting today's lines and matchups |
get_line_movement |
Significant line shifts since market open -- sharp money signals |
analyze_game |
Full 12-agent analysis on any game: consensus pick + edge breakdown |
get_completed_picks |
Recently resolved picks with W/L results -- verify the track record |
get_leaderboard |
Rankings by win rate -- AI model vs human bettors |
log_pick |
Log your own pick into the system -- gets auto-resolved against final scores |
get_system_status |
Health check -- uptime, database status, scheduler health |
Visual Bet Slips
The get_top_pick and get_todays_picks tools return rendered bet slip images directly in chat. No links, no redirects -- the card shows up inline with the pick details, confidence score, and recommended bet.
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.
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 |
Who Built This
Built by a developer who got tired of manually checking odds across apps and spreadsheets. The data exists, the analysis can be automated, and AI agents are the right interface -- but nobody had connected the pipes.
This started as a personal tool to automate a nightly betting research workflow. When MCP launched and made it possible to expose that system to any AI agent, the decision to publish was obvious.
Requirements
- Python 3.10+
- A free API key from sportsbettingaianalyzer.com
License
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sports_betting_mcp-1.0.1.tar.gz.
File metadata
- Download URL: sports_betting_mcp-1.0.1.tar.gz
- Upload date:
- Size: 11.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e077a82478e4b98085c049942444bdb6546b632c0795e693f349454b30ef491e
|
|
| MD5 |
81dbd5db68cd98b452ac0ccbf247d34f
|
|
| BLAKE2b-256 |
43d1d37e7cd8fb77785b5849ce8efaaec236062e8f569adcc3217ddd106ce1a2
|
File details
Details for the file sports_betting_mcp-1.0.1-py3-none-any.whl.
File metadata
- Download URL: sports_betting_mcp-1.0.1-py3-none-any.whl
- Upload date:
- Size: 11.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a10c9da5f71c195b0b3f31bf8d09c1c60722c08e859a0809c5e079b6815e001
|
|
| MD5 |
1d406a5521e4753f1f90f47f231fbe8a
|
|
| BLAKE2b-256 |
c0a52c32b626f49958db1f76eb8b08021ada627a9b9a6e495401696406af0211
|