Documentation
MCP Server

MCP Server

Give any AI agent access to live alternative sports data, odds, events, probabilities, and futures across 29+ leagues from ALT Sports Data.

ALT Sports Data MCP Server

The ALT Sports Data MCP Server gives AI agents direct access to the full ALT Sports Data API: live odds, events, probabilities, settlement, futures, and analytics across 29+ leagues.

Built on the Model Context Protocol (MCP), it works with Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, and any MCP-compatible client.

Architecture diagram showing the ALT Sports Data MCP Server connecting AI clients to the live API.

29 tools. Zero boilerplate. Drop one config snippet into your AI tool and you're live.

What Can It Do?

Your AI agent can:

  • Browse leagues — List supported leagues, archetypes, and market menus
  • Query events — Filter by sport, status, date range across all leagues
  • Pull live odds — Moneylines, matchups, totals, props, exactas, podiums, heat winners
  • Calculate probabilities — Fair (vig-removed) probabilities, favorites, odds conversion
  • Build parlays — Same Game Parlay (SGP) probability calculator
  • Check results — Settlement data, final standings, heat scores
  • Track futures — Season-long futures odds (winner, top 2/3/5/10)

Endpoint → Tool Mapping

Every public API endpoint maps to one or more MCP tools:

API EndpointMCP Tool(s)
GET /sportslist_leagues
GET /eventsget_events
GET /events/{id}get_event, get_event_summary
GET /events/{id}/participantsget_participants
GET /events/{id}/{oddType}get_odds, get_moneylines, get_matchups, get_totals, get_player_props, get_exactas, get_podiums, get_heat_winners, get_fastest_lap, get_all_markets
GET /events/{id}/heats/{heatId}get_heat_scores
POST /events/{id}/sgpcalculate_sgp
GET /events/jaialai/{id}get_jaialai_matches
GET /events/jaialai/{id}/oddsget_jaialai_odds
GET /futureslist_futures
GET /futures/{sport}/tour/{id}/odds/{type}get_futures_odds

Plus SDK-powered analytics tools that add intelligence layers on top of the raw API:

get_market_probabilities · get_fair_probabilities · get_favorites · convert_odds · get_settlement · get_settled_results · get_league_info · get_market_catalog

Supported Leagues

CategoryLeagues
Surf / SkateWSL (Surfing), SLS (Skateboarding)
RacingF1, MotoGP, Supercross, Nitrocross, NHRA, Formula Drift, MotoAmerica, USAC, High Limit Racing, World Outlaws, Super Motocross
CombatBKFC, Power Slap, BYB Extreme, LUX Fight League, Real American Freestyle
TeamMASL (Arena Soccer), NLL (Lacrosse), Athletes Unlimited, Goal Soccer
PrecisionDisc Golf (DGPT), World Jai Alai
MultiX Games, Major League Table Tennis, Spectation

Install & Run

# Install via pip (when published)
pip install altsportsdata-mcp

# Or via uv
uv pip install altsportsdata-mcp

# Run
ALTSPORTSDATA_API_KEY=your_key altsportsdata-mcp
git clone https://github.com/asd-git-master/altsportsdata-mcp.git
cd altsportsdata-mcp
uv pip install -e .

# Run (stdio — for Claude Desktop, Claude Code, Cursor)
ALTSPORTSDATA_API_KEY=your_key python -m altsportsdata_mcp.server

# Run (HTTP/SSE — for remote/shared access)
ALTSPORTSDATA_API_KEY=your_key python -m altsportsdata_mcp.server --sse --port 8080

Environment Variables

VariableRequiredDescription
ALTSPORTSDATA_API_KEYYesYour ALT Sports Data API key
ALTSPORTSDATA_BASE_URLNoOverride API base URL
ODDS_FORMATNoDefault odds format: american (default), decimal, probability

Next Steps

On this page