ESPN Fantasy Football MCP Server

Overview

This MCP (Model Context Protocol) server allows LLMs like Claude to interact with the ESPN Fantasy Football API. It provides tools for accessing league data, team rosters, player statistics, and more through a standardized interface. It can work with both public and private ESPN Leagues.

Features (MCP Tools)

Authentication: Securely store ESPN credentials for the current session (for private leagues)
League Info: Get basic information about fantasy football leagues
Team Rosters: View current team rosters and player details
Player Stats: Find and display stats for specific players
League Standings: View current team rankings and performance metrics
Matchup Information: Get details about weekly matchups

Installation

Prerequisites

Python 3.10 or higher
uv package manager
Claude Desktop for the best experience

Usage with Claude Desktop

Update the Claude Desktop config:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Include reference to the MCP server

{
"mcpServers": {
  "espn-fantasy-football": {
    "command": "uv",
    "args": [
      "--directory",
      "/absolute/path/to/directory",
      "run",
      "espn_fantasy_server.py"
      ]
    }
  } 
}

Restart Claude Desktop

Acknowledgements

cwendt94/espn-api for the nifty python wrapper around the ESPN Fantasy API

mcp_espn_ff