sportsdata-mcp

Race results: finishing order, grid, laps, time/status, points and fastest lap. Returns: {MRData:{RaceTable:{Races:[{season, round, raceName, Results:[{position, positionText, points, grid, laps, status, Driver:{driverId, code}, Constructor:{constructorId}, Time:{millis, time}, FastestLap:{rank, lap, Time, AverageSpeed}}]}]}}} — all values are STRINGS Example: 2024 round 1 {"season": "2024", "round": "1", "format": "json"} Auth: none needed.

Every F1 season on record (1950 onward). Returns: {MRData:{total, limit, offset, SeasonTable:{Seasons:[{season, url}]}}} Example: First page of seasons {"format": "json", "limit": 30} Auth: none needed.

Sprint race results (weekends that have one — 2021 onward). Returns: {MRData:{RaceTable:{Races:[{SprintResults:[{position, points, grid, laps, status, Driver, Constructor, Time}]}]}}} — Races is EMPTY for a weekend with no sprint, which is not an error Example: A 2024 sprint weekend {"season": "2024", "round": "5", "format": "json"} Auth: none needed.

OHLC price candlesticks for one market over a time window (1m/1h/1d periods). Returns: {ticker, candlesticks:[{end_period_ts, yes_bid, yes_ask, price, volume, open_interest}]} Auth: none needed. Also answers this: polymarket_price_history.

OHLC candlesticks for MANY markets in one call — pass the tickers as a list. Returns: {markets:[{market_ticker, candlesticks:[{end_period_ts, price, volume, open_interest}]}]} Auth: none needed. Also answers this: polymarket_price_history.

One event by ticker, optionally with its markets embedded. Returns: {event:{event_ticker, series_ticker, title, category, mutually_exclusive, markets:[…]}, markets} Auth: none needed.

Event catalogue (an event groups related markets) — filter by series or status. Paginated by cursor. Returns: {cursor, events:[{event_ticker, series_ticker, title, sub_title, category, mutually_exclusive, strike_period}], milestones} Example: First page of open events {"limit": 5, "status": "open"} Auth: none needed.

Active exchange-wide announcements. Returns: {announcements:[{type, message, delivery_time, status}]} Auth: none needed.

Standard trading hours + maintenance windows. Returns: {schedule:{standard_hours, maintenance_windows}} Auth: none needed.

Is the exchange up and trading right now. Returns: {exchange_active, trading_active} Auth: none needed.

One market's full detail by ticker — quotes, volume, rules, strike, timing. Returns: {market:{ticker, event_ticker, title, yes_sub_title, no_sub_title, status, result, yes_bid_dollars, yes_ask_dollars, last_price_dollars, volume_fp, open_interest_fp, rules_primary, rules_secondary, strike_type, custom_strike, open_time, close_time, expiration_time}} Auth: none needed. Also answers this: polymarket_market.

Prediction-market catalogue with current quotes — filter by event/series ticker or status. Paginated by cursor. Returns: {cursor, markets:[{ticker, event_ticker, market_type, title, status, yes_bid_dollars, yes_ask_dollars, no_bid_dollars, no_ask_dollars, last_price_dollars, volume_fp, volume_24h_fp, open_interest_fp, liquidity_dollars, open_time, close_time, expiration_time, rules_primary}]} Example: First page of open markets {"limit": 5, "status": "open"} Auth: none needed. Also answers this: polymarket_markets, polymarket_clob_markets.

Milestones — dated catalysts (data releases, games, decisions) linked to the event tickers they resolve. Returns: {cursor, milestones:[{id, category, details, end_date, primary_event_tickers, related_event_tickers}]} Auth: none needed.

One multivariate event collection by ticker. Returns: {multivariate_contract:{collection_ticker, series_ticker, title, description, associated_events, associated_event_tickers}} Auth: none needed.

Multivariate event collections — the parlay-style combo products that many KXMVE* markets belong to (a market's mve_collection_ticker points here). Returns: {cursor, multivariate_contracts:[{collection_ticker, series_ticker, title, description, is_ordered, is_all_yes, size_min, size_max, associated_event_tickers, open_date, close_date}]} Auth: none needed.

Order book for one market — resting yes/no bids by price level (dollar-denominated). Returns: {orderbook_fp:{yes_dollars:[[price, size], …], no_dollars:[[price, size], …]}} (empty arrays when nothing is resting) Auth: none needed.

One series by ticker — title, category, settlement sources, fee structure. Returns: {series:{ticker, title, category, frequency, tags, settlement_sources, contract_url, fee_type}} Auth: none needed.

All series in a category (Sports, Politics, Economics, Financials, Climate and Weather, Entertainment, …) — the top of the id chain. Returns: {series:[{ticker, title, category, frequency, tags, settlement_sources, contract_url}]} Example: Every sports series {"category": "Sports"} Auth: none needed.

One structured target (entity) by id. Returns: {structured_target:{id, name, type, details, source_ids}} Auth: none needed.

Structured targets — Kalshi's entity registry (players, companies, people) that markets resolve against. Paginated by cursor; page size via page_size. Returns: {cursor, structured_targets:[{id, name, type, details, source_ids, last_updated_ts}]} Auth: none needed.

Recent public trades, optionally for one market ticker. Paginated by cursor. Returns: {cursor, trades:[{trade_id, ticker, count, yes_price, no_price, taker_side, created_time}]} Auth: none needed. Also answers this: polymarket_trades.

One competition by SLUG (e.g. primera-division). Numeric id 404s — use the slug. Returns: {competition:{id, slug, name, opta_id}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

All LaLiga competitions (men's/women's, primera/segunda, across history), each with slug, opta_id, name. Returns: {competitions:[{id, slug, name, opta_id, lde_id, main}]} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

One match by SLUG (from laliga_matches; the long temporada-… slug, not the numeric id which 404s). For a played match adds scores + formations. Returns: {match:{id, slug, name, home_team, away_team, home_score, away_score, home_formation, away_formation, competition, gameweek, date, status, attempt, ball}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

Matches feed. IMPORTANT: pass competition= to get a competition's matches — subscription= alone returns a mixed bag (incl. World Cup placeholders). competition=primera-division gives the 380 LALIGA EA SPORTS matches; add gameweek= for one matchweek (10). Returns: {total, matches:[{id, slug, name, opta_id, home_team, away_team, competition, season, gameweek, date, time, venue, status}]} (status FullTime/PreMatch/…) Example: 2025/26 LALIGA matchweek 1 (10 matches) {"subscription": "laliga-easports-2025", "competition": "primera-division", "gameweek": 1, "limit": 10} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

One player profile by SLUG — name, firstname/lastname, date_of_birth, country, current team + squad, roles. Returns: {player:{id, slug, name, firstname, lastname, date_of_birth, country, international, team, squad, roles}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

One player's Opta stats[] by SLUG. Returns: {player_stats:{id, name, slug, opta_id, team, stats:[{name, stat}]}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

EVERY player in a season (≈749) with full Opta stats[] (name/stat pairs) + position + team + opta_id. Page with limit (max 100) + offset. Returns: {total, player_stats:[{id, name, slug, opta_id, shirt_number, position, country, team, stats:[{name, stat}]}]} Example: First page of 2025/26 player stats {"slug": "laliga-easports-2025", "limit": 20} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

Rounds / matchweeks structure for a season (gameweeks, groups). Returns: {total, rounds:[{id, slug, name, position, num_gameweeks, gameweeks, has_groups, groups}]} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

A club's CURRENT squad — each entry has person (name, date_of_birth, country, height), photos, position id, shirt_number, opta_id, loan status. (The subscription arg is required by the API but the roster returned is the current one, not season-historical.) Returns: {total, squads:[{id, opta_id, person:{name, date_of_birth, country, height}, photos, position, shirt_number, role, current, loan}]} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

Full league table for a season — 20 entries with played/won/drawn/lost/goals_for/goals_against/goal_difference/points/position + full team object (shield, colours). Returns: {total, standings:[{position, previous_position, played, won, drawn, lost, goals_for, goals_against, goal_difference, points, team:{id, slug, name, shortname, opta_id, shield}}]} Example: 2025/26 LALIGA EA SPORTS table {"slug": "laliga-easports-2025"} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

One season instance by slug — competition, year, season name, current gameweek, rounds, and `teams` (the authoritative 20 teams in that season — use this, not laliga_teams, for a season roster). Returns: {subscription:{id, slug, name, competition, season, season_name, year, current_gameweek, teams:[20 season teams], rounds}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

Season instances (a 'subscription' = one competition's season), paginated 20/page. Each has slug, competition, year, current_gameweek, date range. Returns: {total, subscriptions:[{id, name, slug, competition, year, current_gameweek, date_ini, date_end, rounds}]} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

One team by SLUG — club info, colours, foundation, socials, competitions, venue. Returns: {team:{id, slug, name, shortname, opta_id, club, color, foundation, competitions, last_main_competition}} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

Global team directory across all competitions (~1541), paginated — use it to resolve a team's slug/id/opta_id. NOTE: NOT season-scoped; for the 20 teams in a season read laliga_standing or laliga_subscription (its embedded `teams`). Returns: {total, teams:[{id, slug, name, nickname, shortname, boundname, shield, competitions}]} (opta_id present on most; join via it where available) Example: First page of the team directory {"limit": 20} Auth: works without a key; LALIGA_SUBSCRIPTION_KEY unlocks more if set.

The daily puzzle: the position, the solution line, and the game it came from. Returns: {game:{id, perf:{key, name}, rated, players:[{name, color, rating}], pgn, clock}, puzzle:{id, rating, plays, solution:[uci moves], themes:[str], initialPly}} Example: Today's puzzle Auth: none needed.

Top-rated players for one time control or variant. Returns: {users:[{id, username, title, perfs:{<perf>:{rating, progress}}, online}]} Example: Top 10 blitz players {"count": 10, "perf": "blitz"} Auth: none needed.

Top 10 for EVERY time control and variant in a single call. Returns: {bullet:[{id, username, title, perfs}], blitz:[…], rapid:[…], classical:[…], chess960:[…], atomic:[…], …} — one array per perf Example: Every leaderboard at once Auth: none needed.

Arena tournaments — currently running, finished and upcoming. Returns: {created:[{id, fullName, startsAt, variant, clock, nbPlayers}], started:[…], finished:[…]} — three lists by state, NOT one Example: Arena tournaments by state Auth: none needed.

A Lichess player: ratings per time control and variant, games played, play time and profile. Returns: {id, username, title, perfs:{bullet:{rating, games, rd, prog}, blitz:{…}, rapid:{…}, classical:{…}, correspondence:{…}, puzzle:{…}}, createdAt, seenAt, playTime:{total, tv}, count:{all, rated, win, loss, draw}, profile:{…}, patron, streamer} — no single 'rating': read perfs.<timeControl>.rating Example: One player's profile and ratings {"username": "thibault"} Auth: none needed.

Online/playing status for up to 50 users in one call — who is available right now. Returns: [{id, name, title, online, playing, streaming, patron}] (top-level array) Example: Status of two players {"ids": ["thibault", "neio"]} Auth: none needed.

List every tool group across all providers, which are currently enabled, and each provider's auth requirements (env-var names + required/optional). On a fresh install (no groups enabled) this is the only functional tool, so the model can guide the user to enable what they want in sportsdata-mcp.yaml.

List all registered MCP resources (capability map, dispatcher catalogues, reference data).

Discover tools by capability — the unit of cross-provider comparison. Given a slug like 'sport.event_markets', returns every enabled tool exposing it across providers. Pass no argument for the full capability → tools map.

All-Star Game ballot candidates for a league + season. Returns: {league, candidates:[{position, players:[{person, team}]}]} Auth: none needed.

All-Star 'Final Vote' candidates for a league + season. Returns: {league, candidates:[{person, team, position}]} Auth: none needed.

All-Star write-in candidates for a league + season. Returns: {league, writeIns:[{person, team, position}]} Auth: none needed.

Attendance figures for a team or league/season — per-game and aggregate home/away/total gate. Returns: {records:[{openings, attendanceTotal, attendanceAverage, team, season}], aggregateTotals} Auth: none needed.

Recipients of an award — e.g. MLBHOF (Hall of Fame), ALMVP/NLMVP, ALCY/NLCY (Cy Young), ALROY/NLROY (Rookie of the Year). Discover awardIds with mlb_awards_list. Returns: {awards:[{id, name, season, player, team, votes}]} Auth: none needed.

Award definitions catalogue — every awardId with name, description and sport (the id lookup for mlb_awards). Returns: {awards:[{id, name, description, sortOrder, sport, active}]} Auth: none needed.