mcp_espn_ff

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

1. 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"
        ]
      }
    } 
  }
  

2. Restart Claude Desktop

Acknowledgements

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