sportsdata-mcp

Scoreboard for one league: today's (or a given date's) games with status, clock, live scores and event ids. The fastest way to get the `event` ids that espn_game_summary / espn_core_call (event_*) need. sport+league are slugs, e.g. football/nfl, basketball/nba, soccer/eng.1. Returns: {leagues:[...], events:[{id, name, status, competitions:[{competitors:[{team, score}]}]}]} Example: Today's NFL scoreboard. {"sport": "football", "league": "nfl"} Auth: none needed.

Gateway to the ESPN site API resource families (site.api.espn.com). Supply an `operation` plus a `path_params` map containing at least `sport` + `league` (slugs like football/nfl, basketball/nba) and any id the op needs (teamId, athleteId), then optional `query_params`. Covers team detail/rosters/schedules/ injuries/depth-charts/transactions/history, athlete news, conference/division groups and poll rankings. For athlete profiles/game-logs/splits use espn_web_call (or espn_core_call for the canonical model). Browse every operation in the espn://site/operations resource. Returns: (JSON object) Auth: none needed.

League standings / ladder: per-team wins, losses, win %, conference/division groupings for the current (or a given) season. Returns: {name, children:[{standings:{entries:[{team, stats:[{name, value}]}]}}]} (children = conferences/divisions) Example: Current NBA standings. {"sport": "basketball", "league": "nba"} Auth: none needed.

Team catalogue for one league: every team with id, name, abbreviation, colours and logos. Use the team ids with espn_site_call (team_roster, team_schedule, …). Returns: {sports:[{leagues:[{teams:[{team:{id, displayName, abbreviation}}]}]}]} Example: All 32 NFL teams. {"sport": "football", "league": "nfl"} Auth: none needed.

Gateway to the ESPN web API (site.web.api.espn.com): site-wide search across teams/athletes/leagues, plus the common/v3 athlete views (overview, stats, gamelog, splits) that power player profile pages, and statistics-by-athlete. `search` needs only query_params {query, limit}; the athlete_* ops need path_params {sport, league, athleteId}. Browse the espn://web/operations resource. Returns: (JSON object) Auth: none needed.

Week box scores — each matchup with both lineups, per-player actual and projected points. The start/sit post-mortem view. Returns: {schedule:[{matchupPeriodId, home:{teamId, totalPoints, tiebreak, pointsByScoringPeriod, rosterForCurrentScoringPeriod:{entries:[{playerId, lineupSlotId, playerPoolEntry:{player:{fullName, stats:[{appliedTotal, appliedAverage, statSourceId, statSplitTypeId}]}}}]}}, away:{…}}]} Example: Week-3 box scores {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

League message board / activity feed (chat topics, trade chatter, activity posts). 404s when the league has no communication group. Returns: {topics:[{id, type, date, author, messages:[{id, messageTypeId, to, for, content}]}]} — HTTP 404 'This Communication Group does not exist.' when the league never used the board Example: Recent league activity {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Draft results — every pick in order with round, team, player, keeper flag and auction bid. Returns: {draftDetail:{drafted, inProgress, completeDate, picks:[{id, overallPickNumber, roundId, roundPickNumber, playerId, teamId, owningTeamIds, keeper, reservedForKeeper, bidAmount, autoDraftTypeId, lineupSlotId, memberId}]}} Example: Full draft board {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

UNDOCUMENTED mega-view (`allon`): settings + teams + rosters + schedule + draft + the whole player pool in ONE response. VERY LARGE (multi-MB) — prefer a targeted tool unless you genuinely need everything. Returns: {settings, status, teams, members, schedule, draftDetail, players, playersHighlighted, creationInfo, lastUpdateInfo, lastAccessInfo} (~4 MB on a 10-team league) Example: Everything about a league in one shot {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

All five ESPN fantasy games with each one's CURRENT season id and scoring period — call this first to resolve seasonId/scoringPeriodId. Returns: [{abbrev:'FFL', id, name, proSportAbbrev, currentSeasonId, currentSeason:{id, currentScoringPeriod:{id}, startDate, endDate}}] (top-level array of 5) Example: Resolve the current NFL fantasy season + week Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Raw league read with ANY combination of views — the escape hatch when no dedicated tool below fits, or to fetch several views in one round trip. Returns: {id, seasonId, scoringPeriodId, settings, status, teams:[…], members:[…]} plus whatever the requested views add (schedule, draftDetail, players, …) Example: Teams + rosters + settings in one call {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "view": ["mTeam", "mRoster", "mSettings"]} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set. Also answers this: sleeper_league, yahoo_league_settings.

ESPN's stock league templates (scoring/roster presets) by scoring-type id — the defaults a new league starts from. Returns: {gameId, id, seasonId, scoringPeriodId, settings:{name:'FFL PPR Scoring', ...}, status:{...}} Example: The PPR football preset {"game": "ffl", "seasonId": 2025, "scoringTypeId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set. Also answers this: sleeper_league, yahoo_league_settings.

Pre-2018 seasons and cross-season history via the leagueHistory path. Only works for leagues that HAVE history — check espnfantasy_status.status.previousSeasons first; an empty list there means this returns 404. Returns a single-element ARRAY, not an object. Returns: [{id, seasonId, settings, teams, status, …}] — ARRAY wrapper; index [0] for a single seasonId. 404 when the league has no leagueHistory record (verified: public league 1234 reports status.previousSeasons == [] and 404s here) — fall back to the seasons path. Example: A 2017 season for a long-running league {"game": "ffl", "leagueId": 1234, "seasonId": 2017} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

League rules: name, size, scoring items, roster slots, schedule/playoff format, waiver + keeper + trade settings. Returns: {settings:{name, size, isPublic, draftSettings, rosterSettings:{lineupSlotCounts}, scoringSettings:{scoringItems:[{statId, points}]}, scheduleSettings, tradeSettings, acquisitionSettings}, status} Example: Scoring + roster rules for a league {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set. Also answers this: sleeper_league, yahoo_league_settings.

Live in-progress scoring for the current period — points so far and how many roster spots have yet to play. Returns: {schedule:[{matchupPeriodId, home:{teamId, totalPoints, totalPointsLive, gamesPlayed}, away:{…}}]} — the *Live fields only populate while pro games are in progress Example: Live scores right now {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Compact matchup scores for the season — totals only, no lineups. Much smaller than the box score. Returns: {schedule:[{id, matchupPeriodId, winner, home:{teamId, totalPoints, gamesPlayed}, away:{…}}]} Example: All matchup results {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set. Also answers this: sleeper_matchups, sleeper_playoff_bracket.

Full season schedule of head-to-head fantasy matchups with each side's total and per-period points. Returns: {schedule:[{id, matchupPeriodId, winner:'HOME'|'AWAY'|'UNDECIDED', home:{teamId, totalPoints, gamesPlayed, pointsByScoringPeriod:{'1':98.4}}, away:{…}}]} Example: Every matchup in the season {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set. Also answers this: sleeper_matchups, sleeper_playoff_bracket.

Lightweight nav payload — league name, size and the current user's team, for cheap orientation before a heavy call. Returns: {id, settings:{name, size}, status:{…}, teams:[{id, abbrev}], members:[…]} Example: Cheap league header {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Pending/unprocessed transactions — waiver claims and trade offers awaiting processing (needs the private cookie in most leagues). Returns: {pendingTransactions:[…]} when any are pending; the key is ABSENT (not an empty list) when there are none. Example: Outstanding waiver claims / trade offers {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Deep card for specific players — full season + per-period stat splits and projections, as the site's player popup shows. Returns: {players:[{id, player:{fullName, stats:[{id, seasonId, scoringPeriodId, statSourceId:0|1, statSplitTypeId, appliedTotal, appliedAverage, stats:{…}}]}}]} — statSourceId 0=actual, 1=projected Example: Season + projection splits for one player {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "fantasy_filter": {"players": {"filterIds": {"value": [15825]}, "filterStatsForTopScoringPeriodIds": {"value": 16, "additionalValue": ["002018", "102018"]}}}} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

The league's player pool with ownership %, ratings, projections and injury status — pass a status filter for FREE AGENTS / WAIVERS (the waiver-wire tool). Returns: {players:[{id, onTeamId, status:'FREEAGENT'|'ONTEAM'|'WAIVERS', keeperValue, draftAuctionValue, ratings, player:{fullName, defaultPositionId, eligibleSlots, injured, injuryStatus, proTeamId, ownership:{percentOwned, percentChange, percentStarted}, stats:[{appliedTotal, statSourceId, statSplitTypeId}]}}]} Example: Top available free agents by ownership {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3, "fantasy_filter": {"players": {"filterStatus": {"value": ["FREEAGENT", "WAIVERS"]}, "limit": 25, "sortPercOwned": {"sortPriority": 1, "sortAsc": false}}}} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Recent fantasy news items for one player (injury/usage blurbs that drive start-sit calls). Returns: {news:{feed:[{id, headline, description, published, lastModified, playerId, links, images}], resultsCount, resultsLimit, timestamp}} Example: News for one player {"game": "ffl", "playerId": 3139477} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

The player universe for a season (id, name, position, pro team, % owned). Defaults to 50 players — pass fantasy_filter to widen or filter. Returns: [{id, fullName, firstName, lastName, defaultPositionId, eligibleSlots:[int], proTeamId, droppable, universeId, ownership:{percentOwned}}] (top-level array) Example: Default slice (50 players) {"game": "ffl", "seasonId": 2025} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Positional ratings — average fantasy points allowed by each pro defence to each position (the strength-of-matchup table). Returns: {positionAgainstOpponent:{positionalRatings:{'1':{average, total, ratingsByOpponent:{'proTeamId':{average, rank}}}}}} (keys are position ids). IN-SEASON ONLY: verified 2026-07-02 that completed/old seasons return 200 with the whole positionAgainstOpponent block ABSENT — that is upstream behaviour, not an error. Example: Which defences are soft against each position {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Pro (real-world) teams for a fantasy season: ids, abbreviations, BYE weeks, and each team's games keyed by scoring period. Returns: {settings:{proTeams:[{id, abbrev, location, name, byeWeek, universeId, proGamesByScoringPeriod:{'1':[{...game}]}}]}} — 33 entries for NFL (id 0 = free-agent/none) Example: NFL teams + bye weeks + week-by-week pro schedule {"game": "ffl", "seasonId": 2025} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Every fantasy team's roster — who each manager holds, their lineup slot, acquisition type and player stats. LARGE (hundreds of KB). Returns: {teams:[{id, roster:{entries:[{playerId, lineupSlotId, acquisitionType, playerPoolEntry:{player:{fullName, defaultPositionId, eligibleSlots, injuryStatus, stats:[…]}}}]}}]} Example: All rosters, week 3 {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Scoreboard for a scoring period — matchup totals plus the pro-game state behind each fantasy team. Returns: {schedule:[{matchupPeriodId, home:{teamId, totalPoints, rosterForCurrentScoringPeriod, cumulativeScore:{wins,losses,ties}}, away:{…}}]} Example: This week's scoreboard {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

One game-season's status: current scoring period, start/end dates, whether it is active. Returns: {abbrev:'FFL 2025', id:2025, gameId, name, active, display, startDate, endDate, currentScoringPeriod:{id}} Example: 2025 fantasy football season status {"game": "ffl", "seasonId": 2025} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

League standings — records, points for/against, division and playoff seeding. Returns: {teams:[{id, name, playoffSeed, rankCalculatedFinal, record:{overall:{wins,losses,ties,percentage,pointsFor,pointsAgainst}, division:{...}, home:{...}, away:{...}}}], schedule:[…]} Example: Final standings {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

League lifecycle status — current matchup period, latest scoring period, whether the season is active, waiver process dates. Returns: {status:{currentMatchupPeriod, latestScoringPeriod, finalScoringPeriod, isActive, previousSeasons:[int], teamsJoined, waiverProcessStatus:{…}}} Example: Where the league is up to {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Fantasy teams with records, points for/against, playoff seed and projected rank. Returns: {teams:[{id, abbrev, name, owners, primaryOwner, divisionId, playoffSeed, points, pointsAdjusted, currentProjectedRank, rankCalculatedFinal, record:{overall:{wins,losses,ties,pointsFor,pointsAgainst}}, transactionCounter, waiverRank}], members:[{id, displayName, firstName, lastName}]} Example: All fantasy teams + records {"game": "ffl", "seasonId": 2018, "leagueId": 1234} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

Completed transactions (adds, drops, trades, waiver claims) for a scoring period. Returns: {transactions:[{id, type, status, teamId, memberId, scoringPeriodId, proposedDate, bidAmount, items:[{type:'ADD'|'DROP', playerId, fromTeamId, toTeamId}]}]} Example: Week-3 transactions {"game": "ffl", "seasonId": 2018, "leagueId": 1234, "scoringPeriodId": 3} Auth: works without a key; ESPN_FANTASY_COOKIE unlocks more if set.

The clubs in one season, with city, country and venue detail. Returns: {total, data:[{code, name, abbreviatedName, editorialName, city, country:{code, name}, address, images, isVirtual}]} — `code` (e.g. 'MAD') is the club key used elsewhere Example: 2024-25 EuroLeague clubs {"competition": "E", "season": "E2024"} Auth: none needed.

One game's detail by its per-season game code. Returns: {id, gameCode, identifier, date, played, gameStatus, local:{club, score}, road:{club, score}, group, phaseType, referee1..4, audience} — a single object, NOT wrapped in {data} Example: Game 1 of the season {"competition": "E", "season": "E2024", "gameCode": 1} Auth: none needed.

Box score for one game: both teams' player lines plus team totals and coach. Returns: {local:{team, coach, total:{…team totals…}, players:[{player:{person, dorsal, position, club}, stats:{timePlayed, valuation, points, fieldGoalsMade2/3, freeThrowsMade, offensiveRebounds, defensiveRebounds, assistances, steals, turnovers, plusMinus, foulsCommited}}]}, road:{…}} — a player line is NESTED as {player, stats}: identity under `player`, numbers under `stats`. `valuation` is EuroLeague's PIR efficiency metric. `timePlayed` is SECONDS as a float (1088.0 = 18:08), not a MM:SS string. Example: Box score for game 1 {"competition": "E", "season": "E2024", "gameCode": 1} Auth: none needed.

Games in a season with scores, venue and officials. Unpaged this is ~800 KB — pass a limit or filter by round. Returns: {total, data:[{id (uuid), gameCode, identifier:'E2024_330', date, localDate, played, gameStatus, group, phaseType, local:{club, score}, road:{club, score}, isNeutralVenue, referee1..4, audience}]} — HOME/AWAY are `local`/`road`; use gameCode (an int) for the per-game tools, not the uuid Example: First 50 games of the season {"competition": "E", "season": "E2024", "limit": 50} Auth: none needed.

Players and coaches registered for a season. LARGE (~600 KB) — page it. Returns: {total, data:[{code, name, alias, height, birthDate, country, position, club}]} Example: First page of registered people {"competition": "E", "season": "E2024", "limit": 100} Auth: none needed.

The rounds (matchdays) in a season, with their date windows. Returns: {total, data:[{round, name, seasonCode, phaseTypeCode, minGameStartDate, maxGameStartDate}]} Example: EuroLeague rounds {"competition": "E", "season": "E2024"} Auth: none needed.

Seasons for a competition — call this to get valid season codes like E2024. Returns: {total, data:[{code:'E2024', name:'EuroLeague 2024-25', alias:'2024-25', year, startDate, endDate, competitionCode, winner}]} Example: EuroLeague seasons {"competition": "E"} Auth: none needed.

Call any FanDuel Racing (TVG) GraphQL operation by name + variables against api.racing.fanduel.com/cosmo/v1/graphql. The full query text lives server-side and the boilerplate variables (brand/product/device/profile) default automatically, so most calls need no variables. Read fanduel://racing/operations for the operation list + variable signatures. Returns: (JSON object) Auth: none needed.

Site message strings (disclaimers, informational copy) for a namespace. Returns: {response:{<namespace>:{<messageKey>: <text>}}} Auth: none needed.

Structured racing promotions / placements (POST; empty body returns all). Returns: {success, promoPlacements:[{...}]} Auth: none needed.

Homepage quick-link tiles for the racing site. Returns: {quickLinks:[{label, url, ...}]} Auth: none needed.

Fetch a FanDuel Sportsbook (US, NJ) REST resource by operation name. Carries the static public `_ak` web key + the sportsbook Origin/region headers, so the caller supplies only the variable query params (eventId, customPageId, dataEntries, eventIds, …). Read fanduel://sportsbook/operations for the list. Returns: (JSON object) Auth: none needed.

Live score + period state for one sportsbook event (NJ). Returns: {openDate, homeTeam:{shortName, abbreviation, score}, awayTeam:{...}, comp, mediaTypes} Auth: none needed.

Countries and regions, used to filter competitions. VERIFIED live — works without a key. Returns: {count, filters, areas:[{id, name, countryCode, flag, parentAreaId, parentArea}]} — VERIFIED (272 areas) 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 areas Auth: needs your own key in FOOTBALL_DATA_ORG_KEY.

One competition with its current season and available seasons. NEEDS A KEY (403 without). Returns: {id, name, code, type, emblem, area, currentSeason:{id, startDate, endDate, currentMatchday, winner}, seasons:[…]} — SHAPE FROM VENDOR DOCS, not probed. 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 {"competition": "PL"} Auth: needs your own key in FOOTBALL_DATA_ORG_KEY.

All matches in one competition. NEEDS A KEY (403 without). Returns: {filters, resultSet, competition, matches:[{id, utcDate, status, matchday, homeTeam, awayTeam, score:{winner, fullTime:{home, away}, halfTime}}]} — 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 Premier League matchday {"competition": "PL", "matchday": 1} Auth: needs your own key in FOOTBALL_DATA_ORG_KEY.

Every competition the API covers, with its code and current season. VERIFIED live — works without a key. Returns: {count, filters, competitions:[{id, name, code:'PL', type:'LEAGUE'|'CUP', emblem, plan:'TIER_ONE'…, area:{id, name, code, flag}, currentSeason:{id, startDate, endDate, currentMatchday}, numberOfAvailableSeasons, lastUpdated}]} — VERIFIED (189 competitions). `plan` tells you which tier a competition needs; the free key covers TIER_ONE only. 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 competitions Auth: needs your own key in FOOTBALL_DATA_ORG_KEY.

One match with lineups, goals, bookings and head-to-head. NEEDS A KEY (403 without). Returns: {id, utcDate, status, competition, homeTeam:{id, name, lineup:[…], bench:[…]}, awayTeam:{…}, score, goals:[{minute, scorer, assist}], bookings:[…], substitutions:[…], referees:[…], head2head:{…}} — 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 match {"matchId": 419516} Auth: needs your own key in FOOTBALL_DATA_ORG_KEY.