sportsdata-mcp

A club's affiliated teams across the minor-league levels. Returns: {teams:[{id, name, sport, league, parentOrgId, parentOrgName}]} Auth: none needed.

Franchise history (name/league/division changes over time) for one or more teams. Returns: {teams:[{id, name, season, league, division, locationName, active}]} Auth: none needed.

Aggregate stats across all teams — league-wide team leaderboard by season + group. Sort + limit for top-N. Returns: {stats:[{type, group, splits:[{team, stat:{...}}]}]} Auth: none needed.

Roster transactions — signings, trades, call-ups, IL moves, DFA, etc. Filter by team, player, single date or date range. Returns: {transactions:[{id, person, fromTeam, toTeam, date, typeCode, typeDesc, description]}]} Auth: none needed.

Current umpire crew list. Returns: {roster:[{person, jobType, job}]} Auth: none needed.

Venue detail for one or more venueIds — name, location, field/roof info. Returns: {venues:[{id, name, location, fieldInfo, timeZone, active}]} Auth: none needed.

The classes running at one event — MotoGP, Moto2, Moto3, MotoE. Returns: [{id (uuid), name:'MotoGP™', legacy_id}] — `id` is the categoryUuid the session and standings tools need Example: Classes at one Grand Prix {"eventUuid": "0f4c9f38-3e30-40f4-8a4a-9e05ba0d0daa"} Auth: none needed.

The Grand Prix weekends in a season, with circuit, country and dates. Returns: [{id (uuid), name, short_name:'QAT', sponsored_name, date_start, date_end, circuit:{id, name, nation}, country:{iso, name}, season, event_files}] Example: Completed rounds of a season {"seasonUuid": "dd12382e-1d9f-46ee-a5f7-c5104db28e43", "isFinished": true} Auth: none needed.

Every MotoGP season (1949 →) with its uuid — the entry point to everything else. Returns: [{id (uuid), year, current}] (top-level array, newest first) — `id` is the seasonUuid every other tool needs; `current: true` marks the live season Example: All seasons Auth: none needed.

The result of one session: finishing order, rider, team, bike, time/gap and points. Returns: {classification:[{position, points, total_laps, time, gap:{first, lap}, rider:{id, full_name, number, country}, team:{name}, constructor:{name}, average_speed, top_speed, status}], records, file} Example: A race result {"sessionUuid": "5b0827b6-7faf-4a1b-a4c2-de630ba1941a"} Auth: none needed.

The sessions for one class at one event — practice, qualifying, sprint and race. Returns: [{id (uuid), type:'RAC'|'SPR'|'Q1'|'Q2'|'FP1'|'PR', number, date, condition:{track, air, humidity, ground, weather}}] — pick type 'RAC' for the race Example: Sessions for MotoGP at one round {"eventUuid": "0f4c9f38-3e30-40f4-8a4a-9e05ba0d0daa", "categoryUuid": "e8c110ad-64aa-4e8e-8a86-f2f152f6a942"} Auth: none needed.

Championship standings for one class in one season. Returns: {classification:[{position, points, rider:{id, full_name, number, country}, team:{name}, constructor:{name}}], file} Example: MotoGP riders' championship {"seasonUuid": "dd12382e-1d9f-46ee-a5f7-c5104db28e43", "categoryUuid": "e8c110ad-64aa-4e8e-8a86-f2f152f6a942"} Auth: none needed.

Full box score for one game, team and player level. Returns: {game:{…}, scoring:{…}, stats:{away:{teamStats:[…], players:[{player:{id, firstName, lastName, position}, playerStats:[…]}]}, home:{…}}} — SHAPE FROM VENDOR DOCS. The `game` id may be given as '20240115-LAL-BOS', which is often easier than looking one up. 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 game's box score {"league": "nba", "season": "current", "game": "20240115-LAL-BOS"} Auth: needs your own key in MYSPORTSFEEDS_API_KEY.

Games for a season in one league, with scores and venue. Returns: {lastUpdatedOn, games:[{schedule:{id, week, startTime, awayTeam:{id, abbreviation}, homeTeam:{…}, venue, playedStatus}, score:{awayScoreTotal, homeScoreTotal, quarters|periods|innings:[…], currentQuarter, currentIntermission}}]} — SHAPE FROM VENDOR DOCS. NOTE identity lives under `schedule` and the result under `score`: a game is TWO nested objects, not one flat one. 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: This NFL season's games {"league": "nfl", "season": "current"} Auth: needs your own key in MYSPORTSFEEDS_API_KEY.

Current injury list for a league. Returns: {players:[{id, firstName, lastName, position, currentTeam:{abbreviation}, currentInjury:{description, playingProbability}}]} — SHAPE FROM VENDOR DOCS. Note there is NO season segment on this path — injuries are always 'now'. 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: NBA injuries {"league": "nba"} Auth: needs your own key in MYSPORTSFEEDS_API_KEY. Also answers this: espn_site_call, espnfantasy_player_info, sportsdataio_nfl_injuries.

Per-game statistics for players across a season — the cleanest surface this API has. Returns: {gamelogs:[{game:{id, startTime, awayTeamAbbreviation, homeTeamAbbreviation}, player:{id, firstName, lastName, position, jerseyNumber}, team:{id, abbreviation}, stats:{…sport-specific groups…}}]} — SHAPE FROM VENDOR DOCS. `stats` groups differ per sport (passing/rushing for NFL, offense/rebounds for NBA). 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 team's player game logs {"league": "nba", "season": "current", "team": ["LAL"]} Auth: needs your own key in MYSPORTSFEEDS_API_KEY.

Standings for a league and season. Returns: {teams:[{team:{id, abbreviation, city, name}, stats:{standings:{wins, losses, winPct, gamesBack}}, divisionRank:{rank, gamesBack}, conferenceRank:{…}, overallRank:{…}}]} — 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: This season's standings {"league": "nba", "season": "current"} Auth: needs your own key in MYSPORTSFEEDS_API_KEY.

Every race in a season across all three series, with winner, track, distance, cautions and lead changes. LARGE (~430 KB). Returns: {series_1:[{race_id, series_id, race_season, race_name, track_name, track_id, date_scheduled, scheduled_distance, actual_laps, number_of_cautions, number_of_lead_changes, average_speed, margin_of_victory, pole_winner_driver_id, winner_driver_id, attendance}], series_2:[…], series_3:[…]} — series 1=Cup, 2=Xfinity, 3=Truck Example: 2024 season across all series {"season": 2024} Auth: none needed.

One race weekend in full: the finishing order with laps led, points and status, plus every practice and qualifying run. Returns: {weekend_race:[{race_id, race_name, track_name, results:[{finishing_position, starting_position, car_number, driver_fullname, team_name, laps_completed, laps_led, points_earned, status, delta_leader}], caution_segments, race_comments}], weekend_runs:[{run_type, run_name, results:[{finishing_position, driver_name, best_lap_time, best_lap_speed}]}]} — `weekend_race` is the race, `weekend_runs` is practice + qualifying. WARNING: `results` is NOT sorted and INCLUDES non-starters with finishing_position 0 (DNQ/DNS). Verified on the 2024 Daytona 500, where results[0] is a driver who did not qualify. The winner is the row with finishing_position == 1 — never results[0]. Example: One Cup race weekend {"season": 2024, "series": 1, "raceId": 5376} Auth: none needed.

Live/final box score for one game from the CDN: per-player and per-team stat lines, by period. gameId comes from nba_scoreboard_today or nba_schedule. Returns: {game:{gameId, homeTeam:{teamId, players:[{name, statistics}]}, awayTeam:{...}}} Example: Box score for one game. {"gameId": "0022300001"} Auth: none needed.

Projected/confirmed starting lineups for a date's games, from the stats.nba.com JS data feed. date is YYYYMMDD. Returns: {games:[{gameId, homeTeam, awayTeam, lineups}]} (feed shape varies) Example: Daily lineups for a date. {"date": "20260101"} Auth: none needed.

Sportsbook odds for today's games from the live CDN odds feed (spread, money line, total per game and book). Returns: {games:[{gameId, markets:[{name, books:[{name, outcomes:[...]}]}]}]} Example: Today's game odds. Auth: none needed.

Event-level play-by-play log for one game from the CDN: every action with clock, score, player and description. gameId from nba_scoreboard_today / nba_schedule. Returns: {game:{gameId, actions:[{actionNumber, period, clock, scoreHome, scoreAway, description}]}} Example: Play-by-play for one game. {"gameId": "0022300001"} Auth: none needed.

Full league schedule for the current season (every game, date, broadcasters, arena). Large payload (~8 MB) — prefer nba_scoreboard_today for just today. Returns: {leagueSchedule:{seasonYear, gameDates:[{gameDate, games:[{gameId, homeTeam, awayTeam, ...}]}]}} Example: Whole-season schedule. Auth: none needed.

Today's games from the live CDN scoreboard: matchups, period/clock state, live scores and game ids. The fastest way to get today's gameId values for nba_boxscore / nba_playbyplay. Returns: {scoreboard:{gameDate, games:[{gameId, gameStatus, gameStatusText, period, gameClock, homeTeam, awayTeam}]}} Example: Today's NBA scoreboard. Auth: none needed.

Gateway to the stats.nba.com /stats/ analytics API (138 operations). Supply an `operation` (the /stats/ path segment, e.g. "leaguedashplayerstats", "shotchartdetail", "boxscoretraditionalv3", "playercareerstats") plus a `query_params` map; each operation already carries NBA's full default param set, so override only the fields you need (e.g. {Season: "2024-25", PlayerID: "201939"}). Browse every operation, its required params and its defaults in the nba://stats/operations resource. Most responses are column-oriented ({resultSets:[{name, headers, rowSet}]}); zip headers with each row. Returns: (JSON object) Auth: none needed.

The NBL ladder (standings) for one season — 10 clubs with position, played/won/lost, points_percentage, win_percentage, points_for/against, last_5 and current streak. `year` is the season start year (2025 = current NBL26). Returns: {type, count, data:[{id, position, played, won, lost, points_percentage, win_percentage, points_for, points_against, last_5, streak, team}]} Example: Current-season ladder {"year": 2025, "seasonType": "regular"} Auth: none needed.

Per-team match outcomes (results) for a season — win/loss rows by team, for head-to-head and form analysis. Returns: {type, count, data:[{team, …per-match outcome rows}]} Auth: none needed.

NBL news articles (latest ~200) — each with title, slug, body (HTML), excerpt, sub_headline, byline, published_date, categories/tags, a related_player and match_slug link, and featured_image_url. NOTE: this feed returns a RAW ARRAY (not the {type,count,data} envelope). Use `limit` to cap rows. Returns: array of {id, status, title, slug, body, excerpt, sub_headline, byline, published_date, categories, tags, related_player, match_slug, featured_image_url, likes} (RAW ARRAY, not enveloped) Example: Latest 10 NBL articles {"limit": 10} Auth: none needed.

Upcoming matches across all NBL teams for a season (empty in the deep off-season). For the full fixture incl. completed games use nbl_schedule. Returns: {type, count, data:[{id, start_time, round, home_team, away_team}]} Auth: none needed.

Game-by-game box scores for one player across a season — per match the points/rebounds/assists/blocks/steals/turnovers and playing position. The score-series / game-log source. Returns: {type, count, data:[{period, playing_position, points, rebounds, assists, blocks, steals, turnovers}]} Auth: none needed.

Season statistics for one player — points/rebounds/assists/blocks/steals/turnovers and their per-game averages, shooting splits (field goals / three-pointers / free throws made-attempted-percentage), fouls, minutes. playerId is the player UUID from nbl_players. Returns: {type, count, data:[{points_average, rebounds_total_average, assists_average, blocks_average, steals_average, turnovers_average, field_goals_percentage, three_pointers_percentage, free_throws_percentage, fouls_average, minutes}]} Auth: none needed.

All players for one season (~165) — each with jersey_number, playing_position and embedded player {id, first_name, last_name, …}, team and season objects. The player `id` (UUID) feeds nbl_player_stats / nbl_player_boxscores. Returns: {type, count, data:[{jersey_number, playing_position, player:{id, first_name, last_name}, team:{id, name, team_code}, season}]} Example: All NBL26 players {"year": 2025} Auth: none needed.

Every match for one season — each with start_time, round, match_status (complete/upcoming/live), home/away scores, attendance, match_slug/title, a play_by_play flag, the Genius external_id, and full home_team/away_team objects (name, team_code, logos, colours). `seasonType=all` for the whole season. Returns: {type, count, data:[{id, external_id, start_time, round, match_status, home_score, away_score, attendance, match_slug, match_title, play_by_play, home_team:{id, name, team_code, team_logo, color_primary}, away_team:{…}}]} Example: Full NBL26 schedule + results {"year": 2025, "seasonType": "all"} Auth: none needed.

The current season(s). Convenience shortcut over nbl_seasons; may return empty in the deep off-season (the call still resolves). Use `limit` to cap rows. Returns: {type, count, data:[{id, name, year, season_type, external_id, start_date, end_date}]} Auth: none needed.

Every NBL season (~73: NBL27, NBL26, blitz/preseason/tournament variants…), each with id (UUID), name, year (season start year), season_type, the Genius external_id, and start/end dates. The discovery entry point — take a season's `id` for nbl_stat_leaders, or its `year` for the year-scoped feeds. Current regular season is the latest `year` with season_type=regular. Returns: {type, count, source, data:[{id, name, year, season_type, external_id, start_date, end_date, competition}]} Auth: none needed.

Season statistical leaders (points/rebounds/assists/etc. averages, per player) for one season — pass the season UUID (`seasonId`) from nbl_seasons (data[].id), NOT the year. Use `limit` to cap rows (limit=-1 for all). Returns: {type, count, data:[{player, team, points_average, rebounds_total_average, assists_average, field_goals_percentage, three_pointers_made_average, …}]} Example: Top 50 scorers for NBL26 {"seasonId": "1f8e4a79-e98b-457b-85a5-e4b898c6c0bd", "limit": 50, "sort": "-points_average"} Auth: none needed.

One team's roster for a season. teamId comes from the team objects in nbl_players / nbl_schedule / nbl_ladder. Returns: {type, count, data:[{jersey_number, playing_position, player:{id, first_name, last_name}, team}]} Auth: none needed.

Team statistics for a season — totals and per-game averages across assists, rebounds (offensive/defensive), blocks, steals, turnovers, and shooting (field goals / three-pointers / free throws made-attempted-percentage). Returns: {type, count, data:[{team, assists, assists_average, defensive_rebounds, blocks, steals, turnovers, field_goals_made, field_goals_attempted, field_goals_percentage, three_pointers_percentage}]} Example: Team stats, current season {"year": 2025, "seasonType": "regular"} Auth: none needed.

The NBL club catalogue (~78 incl. historical/relocated franchises) — each with id (UUID), name, team_code, team_nickname, logos and brand colours. Join team_id from nbl_players / nbl_schedule back to here. Returns: {type, count, data:[{id, external_id, name, team_code, team_nickname, team_logo, color_primary, color_secondary}]} Auth: none needed.

Poll rankings — AP, coaches and others — for a college sport and division. Returns: {sport, title, updated, page, pages, data:[{RANK, SCHOOL, POINTS, PREVIOUS, RECORD}]} — keys here are UPPERCASE, unlike standings Example: AP football poll {"sport": "football", "division": "fbs", "poll": "associated-press"} Auth: none needed.

Current scoreboard for one college sport and division — games with scores, state and clock. Returns: {updated_at, games:[{game:{gameID, startDate, startTime, gameState, currentPeriod, contestClock, home:{names:{short, full}, score, winner, conferences}, away:{…}, url, network}}]} — note each entry is a one-key object wrapping `game` Example: FBS football scoreboard {"sport": "football", "division": "fbs"} Auth: none needed.

Conference standings for a college sport and division. Returns: {sport, title, updated, page, pages, data:[{conference:'ACC', standings:[{School, 'Conference W', 'Conference L', 'Overall W', 'Overall L', 'Overall PF', 'Overall PA', 'Overall HOME', 'Overall AWAY', 'Overall STREAK'}]}]} — GROUPED BY CONFERENCE: data[] is one entry per conference, each holding its own `standings` list. The inner column names are human-readable strings WITH SPACES and vary by sport; all values are strings. Example: FBS football standings {"sport": "football", "division": "fbs"} Auth: none needed.

Full box score for one game: both lineups with goals, assists, plus-minus, shots, hits, blocks and time on ice. Returns: {id, gameDate, gameState, gameOutcome, homeTeam:{abbrev, score, sog}, awayTeam:{…}, playerByGameStats:{homeTeam:{forwards:[{playerId, name, goals, assists, points, plusMinus, sog, hits, blockedShots, toi}], defense:[…], goalies:[…]}, awayTeam:{…}}, clock, periodDescriptor} Example: One completed game {"gameId": 2024020500} Auth: none needed.

One club's entire season schedule with results — the team game log. Returns: {games:[{id, gameDate, gameType, gameState, homeTeam:{abbrev, score}, awayTeam:{abbrev, score}, gameOutcome:{lastPeriodType}, venue, neutralSite}], currentSeason, previousSeason, nextSeason, clubTimezone} (~200 KB for a full season) Example: Toronto's full 2024-25 season {"team": "TOR", "season": "20242025"} Auth: none needed.

Game landing page: scoring summary by period, three stars, penalties and team game stats. Returns: {id, gameDate, gameState, homeTeam, awayTeam, summary:{scoring:[{periodDescriptor, goals:[{timeInPeriod, firstName, lastName, assists, strength}]}], penalties:[…], threeStars:[…], teamGameStats:[…]}, clock} Example: One completed game {"gameId": 2024020500} Auth: none needed.

League leaders among goalies — wins, save percentage, goals-against average and shutouts. Returns: {wins:[{id, firstName:{default}, lastName:{default}, teamAbbrev, value, headshot}], savePctg:[…], goalsAgainstAverage:[…], shutouts:[…]} Example: Current goalie leaders {"season_or_current": "current", "limit": 10} Auth: none needed.

One player's landing page: bio, draft details, current season splits, career totals and awards. Returns: {playerId, firstName, lastName, position, sweaterNumber, currentTeamAbbrev, birthDate, birthCity, birthCountry, draftDetails:{year, round, overallPick, teamAbbrev}, featuredStats, careerTotals:{regularSeason, playoffs}, seasonTotals:[…], awards:[{trophy, seasons}]} Example: Connor McDavid {"playerId": 8478402} Auth: none needed.

A club's full roster for one season, split into forwards / defensemen / goalies with bio, height/weight, shoots-catches and birthplace. Returns: {forwards:[…], defensemen:[…], goalies:[{id, firstName, lastName, sweaterNumber, positionCode, shootsCatches, heightInInches, weightInPounds, birthDate, birthCity, birthCountry, headshot}]} — three parallel arrays, NOT one `players` list Example: Toronto's 2024-25 roster {"team": "TOR", "season": "20242025"} Auth: none needed.

League schedule for the current week (or a given date's week), grouped by day. Returns: {gameWeek:[{date, dayAbbrev, numberOfGames, games:[{id, startTimeUTC, gameState, gameType, homeTeam:{abbrev, score}, awayTeam:{…}, venue}]}], regularSeasonStartDate, regularSeasonEndDate, playoffEndDate, nextStartDate, previousStartDate} Example: This week's games {"date": "now"} Auth: none needed.