Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

seang1121/sports-betting-mcp

Open more actions menu

Repository files navigation

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.

Status Python PyPI License MCP Sports

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

Available Tools

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)

Performance & Stats

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:

  1. 12 specialized agents evaluate the game independently -- covering momentum, matchups, injuries, rest, travel, public betting percentages, sharp money indicators, historical trends, and more.
  2. A consensus engine synthesizes all 12 opinions into a single pick with a confidence score.
  3. Edge calculation compares the model's implied probability against the current market line.
  4. 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 pick
  • flip — fading/betting against the AI
  • manual_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

Related Projects

License

MIT

About

The first MCP server for sports betting — 9 tools, live odds, AI picks, 59.6% win rate across 1,353+ picks

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.