io.github.christianclaudio/espn
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| games_get_scoreboardA | Fetch live scores, game status, periods/innings, clocks/outs, TV broadcasts, and probable starters (e.g. starting pitchers or quarterbacks) for a sport and league. Supports filtering by date (YYYYMMDD), week number, season type, and Top 25 groups. |
| games_get_game_summaryB | Fetch comprehensive game summary for an event ID, including consensus betting lines (spread, moneyline, over/under from DraftKings/Caesars/ESPN BET), matchup predictor (FPI/BPI win probabilities), live win probability curve, season head-to-head series, last 5 games momentum, team statistics, and in-game injuries. |
| games_get_team_scheduleB | Fetch full season schedule and historical game results for a specific team, including opponents, scores, dates, home/away status, and event IDs. |
| games_get_standingsB | Fetch current or historical division, conference, and overall league standings, including win-loss records, win percentages, games back, streaks, and differential. |
| games_get_rankingsC | Fetch Top 25 national polls and rankings (AP Top 25, Coaches Poll, College Football Playoff rankings) for college sports like NCAAF and NCAAB, including current and previous ranks, votes, and records. |
| games_get_transactionsB | Fetch recent league player transactions (trades, free agent signings, waiver claims, roster activations, and injury reserve designations). |
| games_get_leaders_by_athleteB | Fetch statistical leaderboards across a league for individual athletes (e.g. passing yards, rushing, points, strikeouts). |
| games_get_leaders_by_teamC | Fetch team statistical leaderboards across a league (e.g. total offense, defensive points allowed, efficiency). |
| games_get_league_groupsC | Fetch league conference, division, and structural group hierarchies. |
| games_get_league_eventsC | Fetch league-wide calendar of scheduled events, optionally filtered by date. |
| games_get_league_draftC | Fetch league draft rounds, team selections, and pick results. |
| games_get_scoreboard_headerB | Fetch live ticker scoreboard header data across games for a sport and league. |
| games_get_event_oddsB | Fetch sports betting odds, point spreads, over/under, and moneylines across sportsbooks via ESPN Core API. |
| games_get_play_by_playB | Fetch granular play-by-play sequence with clock, downs, distances, yardage, and scoring flags via ESPN Core API. |
| games_get_game_situationC | Fetch real-time game situation (down, distance, yardline, possession, red zone, clock) via ESPN Core API. |
| games_get_win_probabilitiesC | Fetch high-density win probability timeline curve samples across an entire game. |
| games_get_game_predictorC | Fetch ESPN predictive matchup model win percentages, projected margins, and ratings. |
| games_get_calendarC | Fetch league schedule calendar and active event dates across a season. |
| games_get_futuresB | Fetch season futures betting markets (championship odds, conference champions, win totals). |
| games_get_power_indexC | Fetch league team power index (FPI / BPI) ratings and efficiency metrics. |
| teams_get_team_rosterB | Fetch active team roster and injury designations grouped by position, including jersey numbers, experience, position abbreviations, and coaching staff. |
| teams_get_team_depth_chartA | Fetch team depth chart showing positional starter and backup hierarchies (e.g. QB1, QB2, RB1, RB2) to evaluate starting status and backup substitution impacts. |
| teams_get_player_statsB | Extract detailed individual player boxscores and performance metrics for a game (e.g., Strikeouts and Innings Pitched for MLB pitchers; Points, Rebounds, Assists for NBA/WNBA; Passing, Rushing, Receiving for NFL/NCAAF; Goals and Assists for Soccer/NHL). |
| teams_get_athlete_overviewB | Fetch athlete biographical information, season/career statistical splits, recent individual game logs, rotowire fantasy notes, and next upcoming match. |
| teams_searchB | Search ESPN's entity index by name for athletes, teams, or leagues. Returns IDs, display names, and metadata needed to call other tools. |
| teams_list_teamsA | Fetch all active teams in a given sport and league, returning team IDs, names, abbreviations, locations, and colors. |
| teams_get_teamB | Fetch detailed information for a single team including standing summary, overall record, venue, and next scheduled event. |
| teams_get_team_statisticsB | Fetch team and opponent season statistics across offensive, defensive, and special teams categories. |
| teams_get_athlete_bioB | Fetch detailed athlete biography including birthplace, college, draft round and pick, experience, physical measurements, and background. |
| teams_get_athlete_statsB | Fetch career and season statistical totals and averages across all standard and advanced metric categories for an athlete. |
| teams_get_athlete_gamelogC | Fetch game-by-game statistical performance log for an athlete across an entire season. |
| teams_get_athlete_splitsB | Fetch situational split statistics for an athlete (home vs away, monthly performance, opponents, and win/loss splits). |
| news_get_newsB | Fetch recent news headlines, injury updates, breaking analysis, and roster moves for a given sport and league. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| games_game_analysis | Generate prompt template for performing comprehensive sports market and matchup analysis. |
| teams_team_evaluation | Generate prompt template for evaluating a team's roster, depth, form, and schedule. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| get_supported_leagues | Return JSON mapping of all supported sports, leagues, and aliases. |
| get_capabilities | Return static system capabilities reference. |
TDQS
Scored across 33 tools
Several tools overlap: games_get_game_summary already includes betting lines, matchup predictor, win probability curve, and injuries that are also exposed by games_get_event_odds, games_get_game_predictor, and games_get_win_probabilities. Athlete overview also duplicates athlete_bio/stats/gamelog/splits, and scoreboard vs scoreboard_header is subtle. Descriptions help, but boundaries are blurry.
All names use snake_case with a predictable domain prefix (games_, teams_, news_) followed by a verb and entity. teams_search is a minor verb-only variant but still fits the domain_action pattern, and list_teams uses list appropriately.
33 tools is heavy for a single MCP server, with many granular endpoints that could be consolidated. Specialized odds, predictor, and win-probability tools sit alongside an aggregate game summary that already covers similar data.
The surface covers teams, games, schedules, standings, rankings, odds, play-by-play, rosters, depth charts, player/team stats, athlete bios/logs/splits, news, and drafts. It is very complete for read-only ESPN sports data.