ESPN MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ESPN MCP Server What NBA games are on tonight?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ESPN MCP Server
A Model Context Protocol (MCP) server that provides access to ESPN's public API for live sports data.
Supported Leagues
NFL (National Football League)
NHL (National Hockey League)
NBA (National Basketball Association)
Related MCP server: ESPN MCP Server
Features
Current standings and playoff picture
Live scores and game schedules
Team information and statistics
Flexible team name resolution (city, nickname, or abbreviation)
Installation
npm install -g espn-mcp-serverOr clone and build:
git clone https://github.com/Left-Coast-Tech/espn-mcp.git
cd espn-mcp
npm install
npm run buildUsage with Claude Desktop
Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Mac/Linux or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"espn": {
"command": "npx",
"args": ["espn-mcp-server"]
}
}
}Or if installed globally:
{
"mcpServers": {
"espn": {
"command": "espn-mcp-server"
}
}
}Usage with Claude Code
Add to your project's .mcp.json:
{
"espn": {
"command": "npx",
"args": ["espn-mcp-server"]
}
}Available Tools
get_standings
Get current standings for a league.
league: "nfl" | "nhl" | "nba" (required)
group: conference or division filter (optional)Example: "Get NFL standings for the AFC East"
get_scoreboard
Get current or upcoming games with scores.
league: "nfl" | "nhl" | "nba" (required)
week: NFL week number (optional)
date: YYYYMMDD format (optional)Example: "What NFL games are on this week?"
get_team
Get team information including record and standing.
league: "nfl" | "nhl" | "nba" (required)
team: team name, city, or abbreviation (required)Example: "Get info on the Patriots"
get_schedule
Get a team's schedule with results.
league: "nfl" | "nhl" | "nba" (required)
team: team name, city, or abbreviation (required)Example: "Show me the Chiefs remaining schedule"
get_game
Get details about a specific game.
league: "nfl" | "nhl" | "nba" (required)
gameId: ESPN game ID (required)get_playoffs
Get playoff bracket or playoff picture.
league: "nfl" | "nhl" | "nba" (required)Example: "Show me the NBA playoff bracket"
Examples
Once configured, you can ask Claude:
"What are the current NFL standings?"
"Who's leading the AFC North?"
"What's the Broncos record?"
"What NBA games are on tonight?"
"Show me the NHL playoff picture"
Data Source
This server uses ESPN's public API. Data is fetched in real-time and is not cached.
License
MIT
Contributing
Contributions welcome! Please open an issue or PR.
Available Tools
6 toolsget_gameA
Get detailed information about a specific game including box score if completed.
Inputs: gameId (required), league (required).
get_playoffsC
Get current playoff bracket or playoff picture/standings.
Inputs: league (required).
get_scheduleA
Get a team's schedule including past results and upcoming games.
Inputs: team (required), league (required).
get_scoreboardA
Get current or upcoming games with scores. For NFL, can specify week number.
Inputs: league (required), date, week.
get_standingsA
Get current standings for a league. Returns win-loss records, division standings, and playoff positioning.
Inputs: league (required), group.
get_teamA
Get detailed information about a specific team including record, stats, and current standing.
Inputs: team (required), league (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct aspect (standings, scores, team info, schedule, game details, playoffs). Minor overlap exists between get_team (which includes standing) and get_standings, and between get_scoreboard and get_game, but descriptions clarify the differences.
All tools follow the consistent `get_` prefix followed by a clear noun (standings, scoreboard, team, schedule, game, playoffs). No mixed conventions or ambiguous verbs.
With 6 tools, the server is well-scoped for a sports data provider. Each tool covers a core data need without bloat, and the count feels appropriately sized.
The server covers the major domains: standings, scores, teams, schedules, games, and playoffs. Minor gaps exist (e.g., player stats, league news, or team lists), but for the apparent purpose of game/season data, the surface is largely complete.
Maintenance
Related MCP Connectors
Live sports stats and pre-computed analysis for AI assistants across NBA, MLB, NFL, and NHL.
NBA, NFL, NHL and combined sports scores as agent tools.
ESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.
Live sports data: scores, play-by-play, box scores, odds and props. No key needed to start.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides access to comprehensive sports data from 5 major leagues (NBA, NFL, MLB, EPL, NHL) including teams, players, games, statistics, standings, injuries, and betting odds through 67+ endpoints. Enables users to query sports information and analytics through natural language.12MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides comprehensive access to ESPN's sports APIs for live scores, team information, news, and statistics across NFL, NBA, MLB, NHL, college sports, and major soccer leagues with advanced filtering and real-time updates.26 npm-
- AlicenseNot gradedqualityDmaintenanceProvides access to live NHL game data, team and player statistics, standings, schedules, playoff information, and head-to-head comparisons through natural language queries using official NHL APIs.MIT
- AlicenseAqualityDmaintenanceProvides access to live NHL game data, player and team statistics, standings, schedules, playoff brackets, and historical comparisons through natural language queries using the official NHL API.11MIT