mmartinsky/espn-mcp

MCP ESPN

A Model Context Protocol (MCP) server for accessing ESPN NBA API endpoints, built with TypeScript.

Features

This MCP server provides access to ESPN's NBA API endpoints including:

• Scoreboard: Get NBA games for a specific date
• Teams: List all NBA teams or get specific team information
• Roster: Get team rosters
• Schedule: Get team schedules
• Players: List NBA players and get player statistics
• News: Get NBA news

Installation

npm install

Requirements

• Node.js 16+
• TypeScript 5.0+

Configuration

Add this to your MCP client configuration (e.g., Claude Desktop):

"espn-mcp": {
    "command": "/usr/local/bin/npx",
    "args": [
        "-y",
        "tsx",
        "/path/to/your/mcp-espn/src/index.ts"
    ]
}

Replace /path/to/your/ with the actual path to where you cloned this repository.

Usage

The server provides the following tools:

espn_nba_scoreboard

Get NBA scoreboard for a specific date.

• date (optional): Date in YYYYMMDD format, defaults to today

espn_nba_teams

Get list of all NBA teams.

espn_nba_team

Get specific NBA team information.

• team (required): Team ID or abbreviation (e.g., "lal" or "13" for Lakers)

espn_nba_roster

Get NBA team roster.

• team (required): Team ID or abbreviation

espn_nba_schedule

Get NBA team schedule.

• team (required): Team ID or abbreviation

espn_nba_players

Get NBA players list.

espn_nba_player_stats

Get NBA player statistics.

espn_nba_news

Get NBA news.

Development

npm start      # Run the server (uses tsx)

The project uses:

• TypeScript for type safety and better development experience
• tsx for running TypeScript files directly during development
• ES modules for modern JavaScript module system

API Endpoints

This server uses the public ESPN API endpoints:

• Base URL: http://site.api.espn.com/apis/site/v2/sports/basketball/nba

License

MIT