sportsdata-mcp

Player season statistics for a team or league. `season` is required. Returns: {paging:{current, total}, response:[{player:{id, name, age, nationality, height, weight, injured, photo}, statistics:[{team, league, games:{appearences, lineups, minutes, position, rating}, goals:{total, assists, conceded, saves}, shots, passes, tackles, duels, dribbles, fouls, cards, penalty}]}]} — SHAPE FROM VENDOR DOCS. `statistics` is a LIST — one entry per competition — so a player in a league and a cup has two. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A club's squad statistics {"team": 42, "season": 2023} Auth: needs your own key in API_SPORTS_KEY.

The vendor's own model prediction for a fixture, with the comparison data behind it. Returns: {response:[{predictions:{winner:{id, name, comment}, win_or_draw, under_over, goals:{home, away}, advice, percent:{home, draw, away}}, league, teams, comparison:{form, att, def, poisson_distribution, h2h, goals, total}, h2h:[…]}]} — SHAPE FROM VENDOR DOCS. `percent` values are STRINGS with a % sign. This is a vendor model, not a market price: compare it against `squiggle`-style model output, not against a bookmaker's line. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A fixture's prediction {"fixture": 1035037} Auth: needs your own key in API_SPORTS_KEY. Also answers this: squiggle_tips, squiggle_ladder.

League table. Both `league` and `season` are required. Returns: {response:[{league:{id, name, standings:[[{rank, team:{id, name}, points, goalsDiff, group, form, status, description, all:{played, win, draw, lose, goals:{for, against}}, home:{…}, away:{…}}]]}}]} — SHAPE FROM VENDOR DOCS. NOTE the DOUBLE nesting: `standings` is a list OF TABLES (one per group in a group stage), each a list of rows. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Premier League table {"league": 39, "season": 2023} Auth: needs your own key in API_SPORTS_KEY.

Clubs, by league/season, country, or name search. Returns: {response:[{team:{id, name, code, country, founded, national, logo}, venue:{id, name, address, city, capacity, surface}}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Search a club {"search": "Arsenal"} Auth: needs your own key in API_SPORTS_KEY.

Formula 1 races and sessions for a season. Returns: {response:[{id, competition:{id, name, location}, circuit:{id, name}, season, type, laps:{current, total}, distance, timezone, date, status}]} — SHAPE FROM VENDOR DOCS. `jolpicaf1` (keyless) covers F1 history back to 1950 and `openf1` (keyless) covers live telemetry — prefer those unless you need this one key to span sports. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A season's races {"season": 2023} Auth: needs your own key in API_SPORTS_KEY.

Handball games (EHF Champions League, Bundesliga, LNH and others) by date or league. Returns: {response:[{id, date, time, status, league, teams, scores:{home, away}, periods:{first, second}}]} — SHAPE FROM VENDOR DOCS. Handball scores run to 25-35 per side; a value under 10 usually means the match is still in the first half, not a low-scoring game. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A day's games {"date": "<today>"} Auth: needs your own key in API_SPORTS_KEY.

Ice-hockey games (NHL, KHL, SHL and others) by date or league. Returns: {response:[{id, date, status, league, teams, scores:{home, away}, periods:{first, second, third, overtime, penalties}}]} — SHAPE FROM VENDOR DOCS. For the NHL itself the keyless official `nhl` provider is deeper and live. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A day's games {"date": "2024-01-15"} Auth: needs your own key in API_SPORTS_KEY.

MMA fights (UFC and others) by date or season. Returns: {response:[{id, date, slug, category, status, is_main, fighters:{first:{id, name, winner}, second:{…}}}]} — SHAPE FROM VENDOR DOCS. `winner` is null until the fight is resulted, and BOTH may be false on a draw or no-contest — do not infer the loser from one flag. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A card {"date": "2024-03-09"} Auth: needs your own key in API_SPORTS_KEY.

American-football games (NFL, NCAA) by date, season or team. Returns: {response:[{game:{id, stage, week, date:{date, time, timezone}, status}, league, teams, scores:{home:{quarter_1,…, total}, away:{…}}}]} — SHAPE FROM VENDOR DOCS. NOTE this host wraps the identity under `game`, unlike the basketball and hockey hosts. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A week of NFL {"league": 1, "season": 2023} Auth: needs your own key in API_SPORTS_KEY.

Rugby games (Six Nations, Super Rugby, NRL, Premiership) by date or league. The catalogue's only rugby-union coverage. Returns: {response:[{id, date, time, status, league, teams, scores:{home, away}, periods:{first, second, overtime}}]} — SHAPE FROM VENDOR DOCS. For the NRL specifically, the keyless `nrl` provider is official and deeper. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A day's games {"date": "2024-03-09"} Auth: needs your own key in API_SPORTS_KEY.

Your subscription and how much of today's quota is left. Costs no quota — call it first when something returns empty. Returns: {response:{account:{firstname, lastname, email}, subscription:{plan, end, active}, requests:{current, limit_day}}} — SHAPE FROM VENDOR DOCS. `requests.current` vs `limit_day` is the check worth making before blaming the data. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Quota check Auth: needs your own key in API_SPORTS_KEY.

Volleyball games (Italian SuperLega, Polish PlusLiga, CEV and others) by date or league. Returns: {response:[{id, date, status, league, teams, scores:{home, away}, periods:{first, second, third, fourth, fifth}}]} — SHAPE FROM VENDOR DOCS. `scores` is SETS WON (best of 5), not points; the per-set point totals are in `periods`. Reading `scores` as points is the usual mistake. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A day's games {"date": "<today>"} Auth: needs your own key in API_SPORTS_KEY.

Event types the API covers (ATP singles, WTA doubles, ITF, …). Returns: {success:1, result:[{event_type_key, event_type_type:'Atp Singles'}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Event types {"method": "get_events"} Auth: needs your own key in API_TENNIS_KEY.

Matches in a date range, with scores and set-by-set detail once played. Returns: {success:1, result:[{event_key, event_date, event_time, event_first_player, first_player_key, event_second_player, second_player_key, event_final_result:'2 - 0', event_status, tournament_name, tournament_round, scores:[{score_first, score_second, score_set}], pointbypoint:[…]}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A day's matches {"method": "get_fixtures", "date_start": "2025-01-20", "date_stop": "2025-01-20"} Auth: needs your own key in API_TENNIS_KEY.

Head-to-head history between two players, plus each one's recent form. Returns: {success:1, result:{H2H:[{event_key, event_date, event_first_player, event_second_player, event_final_result, tournament_name}], firstPlayerResults:[…], secondPlayerResults:[…]}} — SHAPE FROM VENDOR DOCS. Note `result` here is an OBJECT, not a list like the other methods. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Two players' H2H {"method": "get_H2H", "first_player_key": 1905, "second_player_key": 1903} Auth: needs your own key in API_TENNIS_KEY.

Matches in progress right now, with live scores. Returns: {success:1, result:[{event_key, event_first_player, event_second_player, event_game_result, event_serve, event_status, scores:[…]}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Live matches {"method": "get_livescore"} Auth: needs your own key in API_TENNIS_KEY.

One player's profile and recent results. Returns: {success:1, result:[{player_key, player_name, player_country, player_bday, player_logo, stats:[{season, type, rank, titles, matches_won, matches_lost, hard_won, clay_won, grass_won}]}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One player {"method": "get_players", "player_key": 1905} Auth: needs your own key in API_TENNIS_KEY.

ATP or WTA rankings. Returns: {success:1, result:[{place, player, player_key, league, movement, country, points}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: ATP rankings {"method": "get_standings", "event_type": "ATP"} Auth: needs your own key in API_TENNIS_KEY.

Tournaments, optionally for one event type. Returns: {success:1, result:[{tournament_key, tournament_name, event_type_key, event_type_type}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: All tournaments {"method": "get_tournaments"} Auth: needs your own key in API_TENNIS_KEY.

Premier League fixtures and results. Returns: {data:[{id, week, kickoff, home_team, away_team, home_score, away_score, status, ground}], meta:{next_cursor}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A season's fixtures {"season": 2023} Auth: needs your own key in BALLDONTLIE_API_KEY.

Premier League clubs for a season. Returns: {data:[{id, name, short_name, abbr, city, stadium}]} — SHAPE FROM VENDOR DOCS. The keyless official `premierleague` provider is deeper for the EPL. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: EPL clubs {"season": 2023} Auth: needs your own key in BALLDONTLIE_API_KEY.

MLB games by date, season or team. (For MLB alone, the keyless official `mlb` provider is far deeper.) Returns: {data:[{id, date, season, postseason, home_team_score, away_team_score, home_team, away_team, venue, status}], meta:{next_cursor}} — SHAPE FROM VENDOR DOCS. NOTE: `away_team` here, but `visitor_team` on the NBA and NFL paths. The shape is NOT uniform across sports. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One date's games {"dates": ["2024-07-04"]} Auth: needs your own key in BALLDONTLIE_API_KEY.

NBA games by date, season or team. Returns: {data:[{id, date, season, status, period, time, postseason, home_team_score, visitor_team_score, home_team:{…}, visitor_team:{…}}], meta:{next_cursor}} — SHAPE FROM VENDOR DOCS. Note the away side is `visitor_team`, not `away_team`. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One date's games {"dates": ["2024-01-15"]} Auth: needs your own key in BALLDONTLIE_API_KEY.

NBA players, searchable by name. Returns: {data:[{id, first_name, last_name, position, height, weight, jersey_number, college, country, draft_year, draft_round, draft_number, team:{…}}], meta:{next_cursor, per_page}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Search a player {"search": "curry"} Auth: needs your own key in BALLDONTLIE_API_KEY.

Season averages for specific NBA players. Returns: {data:[{player_id, season, games_played, min, pts, reb, ast, stl, blk, turnover, fg_pct, fg3_pct, ft_pct}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A player's season {"season": 2023, "player_ids": ["115"]} Auth: needs your own key in BALLDONTLIE_API_KEY.

NBA standings for a season. Returns: {data:[{team:{…}, conference_record, conference_rank, division_record, division_rank, wins, losses, home_record, road_record, season}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A season's standings {"season": 2023} Auth: needs your own key in BALLDONTLIE_API_KEY.

Per-player, per-game NBA box-score lines. Returns: {data:[{id, min:'34:12', fgm, fga, fg_pct, fg3m, fg3a, ftm, fta, oreb, dreb, reb, ast, stl, blk, turnover, pf, pts, player:{…}, team:{…}, game:{…}}], meta:{next_cursor}} — SHAPE FROM VENDOR DOCS. `min` is a 'MM:SS' STRING, not a number. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A player's game lines {"player_ids": ["115"], "seasons": ["2023"]} Auth: needs your own key in BALLDONTLIE_API_KEY.

All 30 NBA franchises with conference and division. Returns: {data:[{id, conference, division, city, name, full_name, abbreviation}]} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Every NBA team Auth: needs your own key in BALLDONTLIE_API_KEY.

NFL games by season, week or team. Returns: {data:[{id, visitor_team_score, home_team_score, season, postseason, status, date, week, home_team, visitor_team}], meta:{next_cursor}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: A season's games {"seasons": ["2023"]} Auth: needs your own key in BALLDONTLIE_API_KEY.

Cash-out availability for one or more markets. Returns: [{marketId, cashout, partial}] (top-level array) Auth: none needed.

In-play event details (event name, competition, primary market, runners, start time) for one or more events. Returns: [{eventId, eventTypeId, marketId, marketName, eventName, competitionName, numberOfRunners, countryCode, startTime}] (top-level array) Auth: none needed.

Live timeline + running score/state for one in-play event. Returns: {eventId, eventTypeId, score:{home:{name, score, numberOfYellowCards, ...}, away:{...}}, timeElapsed, ...} Auth: none needed.

Live timelines + running scores for several in-play events at once (batch). Returns: [{eventId, eventTypeId, score:{home:{name, score, halfTimeScore, fullTimeScore}, away:{...}}}] (top-level array) Auth: none needed.

Exchange back/lay prices + state for one or more markets (the core odds feed). Returns: {currencyCode, eventTypes:[{eventTypeId, eventNodes:[{eventId, event:{eventName, countryCode, openDate}, marketNodes:[{marketId, state:{inplay, status}, description, runners:[{...prices: back/lay}]}]}]}]} Example: Price two markets {"marketIds": "1.258654642,1.258653584"} Auth: none needed.

Market STRUCTURE for an event (market ids, names, runners) — probed live 2026-07-06: this route STRIPS exchange prices (runners come back without the exchange block) and 400s on multi-id batches. For prices, feed the market ids into betfair_market_prices; for bulk market-id discovery, betfair_navigation with attachments=MENU,EVENT,MARKET returns 1000+ MARKET nodes per event type in one call. Returns: {currencyCode, eventTypes:[{eventNodes:[{eventId, event:{eventName}, marketNodes:[{marketId, description:{marketType}, state, runners:[{...prices}]}]}]}]} Auth: none needed.

Navigation graph by node — traverse sport → group → event → market. Feed market ids into betfair_market_prices. Returns: {nodes:[{nodeId, name, nodeType: EVENT_TYPE|MENU|EVENT|MARKET, navInfo, ...}]} Example: Top of the Horse Racing tree {"nodeIds": "EVENT_TYPE:7"} Auth: none needed.

Live scores for one or more in-play events (per-sport score detail). Returns: [{eventId, eventTypeId, score:{home:{name, score, ...}, away:{...}}}] (top-level array) Auth: none needed.

Live scores plus broadcast/streaming availability for one or more events. Returns: [{eventId, startTime, state:{score:{...}}, broadcast:{...}}] (top-level array) Auth: none needed.

All visible promotions (name, description, dates). Returns: {Promotions:[{Id, PromotionId, Name, Description, PromotionStartDate}]} Auth: none needed.

All event types (sports + racing) with event counts and SGM availability. Returns: {Items:[{EventTypeId, EventTypeDesc, EventCount, HasSameGameMulti, MasterEventTypeId}]} Auth: none needed.

Featured 'Fav 4' upcoming races for a race-type filter. Returns: {Items:[{EventId, MasterEventId, Venue, RaceNumber, BettingCloseTimeUtc, TimeToJump}]} Auth: none needed.

Editorially featured racing events (carousel order, promo titles). Returns: {ContentfulFeaturedEvent:[{EventOrder, EventID, EventName, PromotionTitle}]} Auth: none needed.

All meetings + their races for a day offset, grouped by code. Returns: {Thoroughbred:[[{EventId, Venue, CountryCode, RaceNumber, AdvertisedStartTime, HasFixedMarkets}]], Greyhounds:[...], Trots:[...]} Example: Today's meetings {"DaysToRace": 0} Auth: none needed.

Racing market movers — runners whose fixed prices are shortening/drifting. Returns: {Items:[{EventId, EventName, Venue, RaceNumber, SecondsToJump, AdvertisedStartTime}]} Auth: none needed.

Master categories (competitions) for one event type, optionally with levelled markets. Returns: {EventTypeDesc, EventTypeId, MasterCategories:[{MasterCategoryId, MasterCategory, Categories:[{CategoryId, CategoryName}]}]} Example: Basketball competitions {"EventTypeId": 107} Auth: none needed.

One sport match's markets by master event id — a market GROUP per call (Events[].Outcomes[] with prices; GroupLinks names the other groups: totals, lines, race-to, periods). Returns: {MasterEvent:{MasterEventId, MasterEventName, CategoryId, MinAdvertisedStartTime, IsLive, IsOpenForBetting}, Events:[{EventId, EventName, Outcomes:[{OutcomeName, Price, MarketTypeCode, MarketDesc, Points}]}], GroupLinks:[{GroupTypeCode, GroupName}]} Auth: none needed.

Next races about to jump, with time-to-jump, for a race-type + country filter. Returns: {Items:[{Race:{EventId, Venue, RaceNo, AdvertisedStartTime, StateCode}, TimeToJump, SecondsToJump, EventType}]} Auth: none needed.

Popular Same Game Multi suggestions for one master event. Returns: {PopSGMBetItems:[{legs:[{selectionName, price}], price}]} Auth: none needed.

Categories that currently have Popular Same Game Multis. Returns: {PopSGMCategoryItems:[{EventTypeId, MasterCategoryName, CategoryId, CategoryName}]} Auth: none needed.

Popular market quick-links (specials, featured competitions) for navigation. Returns: {Items:[{PopularMarketName, EventTypeId, EventType, MasterEventId, CategoryId}]} Auth: none needed.