MCP Server
Give any AI agent access to live alternative sports data — odds, events, probabilities, and futures across 27+ leagues.
AltSportsData MCP Server
The AltSportsData MCP Server gives AI agents direct access to the full AltSportsData API — live odds, events, probabilities, settlement, futures, and analytics across 27+ alternative sports leagues.
Built on the Model Context Protocol (MCP), it works with Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, and any MCP-compatible client.
29 tools. Zero boilerplate. Drop one config snippet into your AI tool and you're live.
Credential model
Use the same ALT Sports Data credential here that you use for the API and SDKs. MCP is another interface to the same platform, not a separate access product.
What Can It Do?
Your AI agent can:
- Browse leagues — List all 27+ alt sports with archetypes and supported markets
- 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 Endpoint | MCP Tool(s) |
|---|---|
GET /sports | list_leagues |
GET /events | get_events |
GET /events/{id} | get_event, get_event_summary |
GET /events/{id}/participants | get_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}/sgp | calculate_sgp |
GET /events/jaialai/{id} | get_jaialai_matches |
GET /events/jaialai/{id}/odds | get_jaialai_odds |
GET /futures | list_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
| Category | Leagues |
|---|---|
| Surf / Skate | WSL (Surfing), SLS (Skateboarding) |
| Racing | F1, MotoGP, Supercross, Nitrocross, NHRA, Formula Drift, MotoAmerica, USAC, High Limit Racing, World Outlaws, Super Motocross |
| Combat | BKFC, Power Slap, BYB Extreme, LUX Fight League, Real American Freestyle |
| Team | MASL (Arena Soccer), NLL (Lacrosse), Athletes Unlimited, Goal Soccer |
| Precision | Disc Golf (DGPT), World Jai Alai |
| Multi | X 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-mcpgit 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 8080Environment Variables
| Variable | Required | Description |
|---|---|---|
ALTSPORTSDATA_API_KEY | Yes | Your AltSportsData API key |
ALTSPORTSDATA_BASE_URL | No | Override API base URL |
ODDS_FORMAT | No | Default odds format: american (default), decimal, probability |
Next Steps
- Quickstart → — Get running in 2 minutes
- Tools Reference → — Full documentation for all 29 tools
- Claude Desktop → — Connect to Claude Desktop
- Claude Code → — Connect to Claude Code CLI
- Cursor → — Connect to Cursor IDE