Sports Betting MCP

What sports-betting-mcp does

The sports-betting-mcp MCP server gives AI agents access to a sports betting analysis system for NBA, NHL, NCAAB, and MLB. It exposes structured data for daily recommendations, market information, game-level analysis, active alerts, and historical performance. Supported bet types include moneyline, spread, and totals.

The service records picks before games begin and resolves them against final scores. This lets an agent inspect pending picks, review completed wins and losses, and compare results by sport or bet type. The underlying analysis uses a 12-agent consensus process that considers factors such as matchups, injuries, rest, travel, betting activity, and historical trends.

How it works

The MCP process communicates with a sports betting API over stdio. Requests are authenticated with an X-API-Key header supplied by the configured API key. The default API base URL is local, but the configuration can point to the hosted service or another compatible deployment.

For game analysis, specialized agents assess the matchup independently before a consensus process produces a selection, confidence value, and edge details. Responses can therefore be used to rank picks, explain a recommendation, or filter results by sport and confidence. Market data includes current moneyline, spread, and totals information for the day’s games.

Some underlying API functions are tiered. General API-key access includes daily picks, odds, win-rate data, injuries, line movement, schedules, statistics, leaderboards, news, and pending picks. Full structured picks, on-demand analysis, resolved results, search, pick logging, history, webhooks, and related functions require approved Pro access.

Setup and configuration

Install the package with:

pip install sports-betting-mcp

Add the executable to an MCP client configuration and provide the required key:

{
  "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 is required. SPORTS_BETTING_API_URL is optional and defaults to http://localhost:5000. A free key is available from the service website; Pro features require administrative approval. The package requires Python 3.10 or newer and uses the stdio transport.

Tools and capabilities

The sports-betting-mcp MCP server exposes tools for:

• Retrieving all daily picks, the highest-confidence pick, unresolved picks, and recently completed picks.
• Running a full 12-agent analysis for a specified game.
• Reading live moneyline, spread, and totals data.
• Checking active alerts for line changes and injury effects.
• Reviewing win rates by sport and bet type.
• Inspecting model totals, recent-20 performance, and confidence tiers.
• Viewing leaderboard rankings by win rate.
• Checking service uptime, database, and scheduler health.

Limitations and notes

Coverage is limited to NBA, NHL, NCAAB, and MLB. The displayed performance figures change as games are resolved, and the repository includes different historical totals in its descriptive material, so consumers should query the live statistics tools for current values. Access to some analysis and historical API functions depends on Pro approval.