Tools Reference
Complete reference for all 29 MCP tools — parameters, return types, and examples.
Tools Reference
The AltSportsData MCP Server exposes 29 tools organized across 7 categories. Every tool automatically serializes responses to JSON for your AI agent.
All tools require ALTSPORTSDATA_API_KEY to be set as an environment variable. No explicit auth parameter needed per-call.
Discovery & Catalog
list_leagues
List all 27+ alternative sports leagues with their archetypes, supported markets, and metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status |
Returns: Array of league objects with code, name, archetype, supported_markets.
Example prompt: "What leagues does AltSportsData cover?"
get_league_info
Detailed league information — archetype classification, data shape, contract hints, available market types.
| Parameter | Type | Required | Description |
|---|---|---|---|
league | string | Yes | League code (e.g. wsl, f1, bkfc) |
Returns: League detail object with archetype, data shape, market menu, and integration hints.
Example prompt: "Tell me about WSL surfing — what data is available?"
get_market_catalog
Browse all available market types, optionally filtered by league or archetype.
| Parameter | Type | Required | Description |
|---|---|---|---|
league | string | No | Filter by league code |
archetype | string | No | Filter by archetype |
Returns: Market catalog with types, descriptions, and which leagues support each.
Events
get_events
List events across leagues with filters for sport type, event status, date range, and sort order.
| Parameter | Type | Required | Description |
|---|---|---|---|
league | string | No | League code (e.g. f1, wsl). Omit for all leagues |
status | string | No | Event status filter: LIVE, UPCOMING, NEXT, IN_WINDOW, COMPLETED, CANCELLED, POSTPONED |
start_date | string | No | ISO 8601 start date (e.g. 2026-03-01T00:00:00Z) |
end_date | string | No | ISO 8601 end date |
sort_order | string | No | ASC or DESC (default) |
Returns: Array of event listing objects.
Example prompt: "Show me all F1 events in March 2026"
get_event
Get full details for a single event including rounds, heats, teams, and schedule.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID (e.g. f1:bc8a2ac2-0111-4b99-b402-08a19a731eda) |
Returns: Full event object with rounds, heats, teams, location, dates, status.
get_event_summary
Comprehensive event summary with participants and market overview in a single call.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
Returns: Combined summary: event details + participant list + available markets overview.
get_participants
List all competitors/athletes for a specific event.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
Returns: Array of athlete objects with id, firstName, lastName, nationality, team, etc.
Odds & Markets
get_odds
Get odds for any market type for a specific event. Supports all 16 market types.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
odd_type | string | Yes | One of: eventWinner, secondPlace, fastestLap, heatWinner, headToHead, overUnder, multiOverUnder, shows, podiums, propBets, dreamTeam, eventExacta, heatExacta, raceTop10, raceTop5, raceTop3 |
exactas_type | integer | No | For exactas: 2, 3, or 4 |
over_under_sub_market | string | No | For overUnder: finishingPosition, points, gapToLeaders |
Returns: Odds response with outcomes, probabilities, settlement status.
get_all_markets
Fetch all available odds for an event in a single call — iterates every supported market type.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
Returns: Object with each market type as a key and its odds as the value.
get_moneylines
Shortcut for winner/moneyline odds (eventWinner market type).
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
get_matchups
Shortcut for head-to-head matchup odds (headToHead market type).
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
get_totals
Over/under totals odds.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
sub_market | string | No | finishingPosition, points, or gapToLeaders |
get_player_props
Player proposition bet odds.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
get_exactas
Exacta combination odds (2-way, 3-way, or 4-way).
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
exactas_type | integer | No | 2 (default), 3, or 4 |
get_podiums
Podium finish (top 3) odds.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
get_heat_winners
Heat/round winner odds — per round with per-heat breakdowns.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
get_fastest_lap
Fastest lap odds (applicable to racing sports).
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
Analytics & Probabilities
get_market_probabilities
Implied win probabilities with vig removed for a given market.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
market_type | string | No | Market type (default: eventWinner) |
Returns: Array of { athlete, probability, fair_odds } sorted by probability descending.
get_fair_probabilities
Calculate fair (vig-removed) probabilities for any odds set.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
market_type | string | No | Market type |
get_favorites
Top N favorites by odds for an event.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
market_type | string | No | Market type (default: eventWinner) |
top_n | integer | No | Number of favorites to return (default: 5) |
Example prompt: "Who are the top 3 favorites for the next WSL event?"
calculate_sgp
Same Game Parlay — calculate combined probability for multiple selections.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
selections | array of strings | Yes | Array of ASD selection UUIDs (outcome mapping IDs) |
fixture_id | string | No | Fixture ID for the parlay |
Returns: { viggedProbability, probability, decimalOdds }
convert_odds
Convert between American, decimal, and probability odds formats.
| Parameter | Type | Required | Description |
|---|---|---|---|
odds | number | Yes | Odds value to convert |
from_format | string | Yes | Source format: american, decimal, probability |
to_format | string | Yes | Target format: american, decimal, probability |
Settlement & Results
get_settlement
Settlement/grading data for completed events — who won, lost, voided.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
market_type | string | No | Market type (default: eventWinner) |
get_settled_results
Final results and standings for a completed event.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
Futures
list_futures
List available futures markets across all leagues.
Returns: Array of futures with id, type, tourName, startDate, endDate, isMarketOpen.
get_futures_odds
Get odds for a specific season futures market.
| Parameter | Type | Required | Description |
|---|---|---|---|
league | string | Yes | League code (e.g. wsl, f1) |
tour_id | string | Yes | Tour/season ID |
future_type | string | Yes | One of: winner, top2, top3, top5, top10, makeCut, makePlayOdds |
Specialty
get_jaialai_matches
Jai Alai match and set details for an event.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Jai Alai event ID (e.g. jaialai:09-11-2024_chargers-vs-renegades) |
get_jaialai_odds
Jai Alai event, match, and set odds.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Jai Alai event ID |
get_heat_scores
Get scores or lap times for a specific heat/round within an event.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | Event ID |
heat_id | string | Yes | Heat/round ID |
MCP Resources
The server also exposes static resources for context injection:
| URI | Description |
|---|---|
altsportsdata://leagues | All leagues with metadata — inject as context |
altsportsdata://leagues/{code} | Single league details |
altsportsdata://catalog | Full market type catalog |
These resources can be used by MCP clients that support resource injection to give your AI agent background context about available leagues and markets.