Skip to main content

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.

Status Python PyPI License MCP Sports

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:

  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.


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

License

MIT

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

sports_betting_mcp-1.0.1.tar.gz (11.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sports_betting_mcp-1.0.1-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

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

Hashes for sports_betting_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 e077a82478e4b98085c049942444bdb6546b632c0795e693f349454b30ef491e
MD5 81dbd5db68cd98b452ac0ccbf247d34f
BLAKE2b-256 43d1d37e7cd8fb77785b5849ce8efaaec236062e8f569adcc3217ddd106ce1a2

See more details on using hashes here.

File details

Details for the file sports_betting_mcp-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for sports_betting_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8a10c9da5f71c195b0b3f31bf8d09c1c60722c08e859a0809c5e079b6815e001
MD5 1d406a5521e4753f1f90f47f231fbe8a
BLAKE2b-256 c0a52c32b626f49958db1f76eb8b08021ada627a9b9a6e495401696406af0211

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page