Skip to main content
Glama
ESPN MCP Server

ESPN MCP Server

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-server

Or clone and build:

git clone https://github.com/Left-Coast-Tech/espn-mcp.git
cd espn-mcp
npm install
npm run build

Usage 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 tools
get_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

    A3.6/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tools follow the consistent `get_` prefix followed by a clear noun (standings, scoreboard, team, schedule, game, playoffs). No mixed conventions or ambiguous verbs.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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.
      12
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      11
      MIT