Espn

Model Context Protocol server for live & historical sports stats and odds via ESPN.

Connector by christianclaudio · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/christianclaudio-espn

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Model Context Protocol server for live & historical sports stats and odds via ESPN.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools: 33 read · 0 write · 0 deleteRead-only
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Tools by what they do 33

Read from the source code; the running server may list different tools.

Read 33 · Look things up without changing anything.

get_athlete_bio
get_athlete_gamelog
get_athlete_overview
get_athlete_splits
get_athlete_stats
get_calendar
get_event_odds
get_futures
get_game_predictor
get_game_situation
get_game_summary
get_leaders_by_athlete

Show 21 more tools

get_leaders_by_team
get_league_draft
get_league_events
get_league_groups
get_news
get_play_by_play
get_player_stats
get_power_index
get_rankings
get_scoreboard
get_scoreboard_header
get_standings
get_team
get_team_depth_chart
get_team_roster
get_team_schedule
get_team_statistics
get_transactions
get_win_probabilities
list_teams
search

Secrets and settings it asks for

Other settings (environment variables or headers).

ESPN_BASE_URL
ESPN_MAX_RETRIES
ESPN_MCP_ENABLE_TOOL_SEARCH
ESPN_MCP_PROFILE
ESPN_MCP_READONLY
ESPN_MCP_TOOL_SEARCH_BACKEND
ESPN_TIMEOUT_SECONDS

Network hosts it talks to 4

github.com · found in code
gofastmcp.com · found in code
site.web.api.espn.com · found in code
sports.core.api.espn.com · found in code

Tools (33)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

get_athlete_bio
Fetch detailed athlete biography including birthplace, college, draft round and pick, experience, physical measurements, and background.
get_athlete_gamelog
Fetch game-by-game statistical performance log for an athlete across an entire season.
get_athlete_overview
Fetch athlete biographical information, season/career statistical splits, recent individual game logs, rotowire fantasy notes, and next upcoming match.
get_athlete_splits
Fetch situational split statistics for an athlete (home vs away, monthly performance, opponents, and win/loss splits).
get_athlete_stats
Fetch an athlete's season totals (e.g. a quarterback's passing yards for a season) and career totals and averages. Find the athlete_id with teams_search.
get_calendar
Fetch league schedule calendar and active event dates across a season.
get_event_odds
Fetch sports betting odds, point spreads, over/under, and moneylines across sportsbooks via ESPN Core API.
get_futures
Fetch season futures betting markets (championship odds, conference champions, win totals).
get_game_predictor
Fetch ESPN predictive matchup model win percentages, projected margins, and ratings.
get_game_situation
Fetch real-time game situation (down, distance, yardline, possession, red zone, clock) via ESPN Core API.
get_game_summary
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.
get_leaders_by_athlete
Fetch statistical leaderboards across a league for individual athletes (e.g. passing yards, rushing, points, strikeouts).
get_leaders_by_team
Fetch team statistical leaderboards across a league (e.g. total offense, defensive points allowed, efficiency).
get_league_draft
Fetch league draft rounds, team selections, and pick results for a draft year (e.g. the first overall pick).
get_league_events
Fetch the league's current scheduled events. Date filtering is not supported here: for games on a date or range, use games_get_scoreboard with date.

Show 18 more tools

get_league_groups
Fetch league conference, division, and structural group hierarchies.
get_news
Fetch recent news headlines, injury updates, breaking analysis, and roster moves for a given sport and league.
get_play_by_play
Fetch granular play-by-play sequence with clock, downs, distances, yardage, and scoring flags via ESPN Core API.
get_player_stats
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).
get_power_index
Fetch league team power index (FPI / BPI) ratings and efficiency metrics.
get_rankings
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.
get_scoreboard
Fetch final scores and results for any date, including postseason games such as the Super Bowl, World Series, or NBA Finals, plus live scores, game status, periods/innings, clocks/outs, TV broadcasts, and probable starters. Returns each game's event ID. Filter by date, week, season type, or Top 25 group. Sports: football, basketball, baseball, hockey, soccer, golf, mma.
get_scoreboard_header
Fetch live ticker scoreboard header data across games for a sport and league.
get_standings
Fetch current or historical regular-season division, conference, and league standings (e.g. which team had the best record): win-loss records, win percentages, games back, streaks, and differential. Echoes the season ESPN returned.
get_team
Fetch detailed information for a single team including standing summary, overall record, venue, and next scheduled event.
get_team_depth_chart
Fetch team depth chart showing positional starter and backup hierarchies (e.g. QB1, QB2, RB1, RB2) to evaluate starting status and backup substitution impacts.
get_team_roster
Fetch active team roster and injury designations grouped by position, including jersey numbers, experience, position abbreviations, and coaching staff.
get_team_schedule
Fetch a team's season schedule and results: opponents, scores, dates, home/away, and event IDs. Regular season by default; season_type=3 for postseason games (e.g. the World Series, NBA Finals, or Super Bowl).
get_team_statistics
Fetch team and opponent season statistics across offensive, defensive, and special teams categories.
get_transactions
Fetch recent league player transactions (trades, free agent signings, waiver claims, roster activations, and injury reserve designations).
get_win_probabilities
Fetch high-density win probability timeline curve samples across an entire game.
list_teams
Fetch all active teams in a given sport and league, returning team IDs, names, abbreviations, locations, and colors.
search
Search ESPN's entity index by name to find an athlete ID or team ID, or a league. Returns IDs, display names, and metadata needed to call other tools.

Signals

Stars: 0
Forks: 0
Open issues: 0
Weekly downloads: 648
Last commit: Oct 22, 2026 (7 days ago)
Last release: Oct 23, 2026 (6 days ago)
Last package publish: Oct 23, 2026 (6 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.christianclaudio/espn
Version: 2.1.1
Auth: No auth
Packages: pypi mcp-server-espn
License: Apache-2.0
Repository: github.com/christianclaudio/mcp-server-espn
First seen: Oct 24, 2026
Last checked: Oct 25, 2026
Source: Official MCP Registry github-graphql

More from christianclaudio

Cite this page

Espn MCP server. Agent Mart. https://agentmart.dev/connectors/christianclaudio-espn (last updated 2026-10-25)