ESPN Fantasy Football
ESPN Fantasy API with LLMs!
What is ESPN Fantasy Football?
ESPN Fantasy Football is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to espn fantasy api with llms!
ESPN Fantasy API with LLMs!
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ESPN Fantasy API with LLMs!
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-espn-ffConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ESPN Fantasy Football
The ESPN Fantasy Football MCP server bridges Claude with the ESPN Fantasy Football API, giving AI assistants direct access to league metadata, team rosters, player statistics, weekly matchups, and standings. It supports private leagues through a secure session-based credential storage mechanism, making it useful both for public and private ESPN fantasy leagues. Fantasy football managers can ask Claude to analyze their team, compare players, review matchup projections, and get standings updates without leaving their AI assistant.
Prerequisites
- Python 3.10 or higher installed
- The uv package manager installed (pip install uv or brew install uv on macOS)
- An ESPN Fantasy Football account with at least one league
- For private leagues: your ESPN S2 cookie and SWID from your browser session
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the mcp_espn_ff repository to your local machine.
git clone https://github.com/KBThree13/mcp_espn_ff.git
cd mcp_espn_ffInstall dependencies with uv
Use uv to install the project dependencies. The server uses the espn-api Python package to communicate with the ESPN Fantasy API.
uv syncNote the absolute path to your installation
The MCP configuration requires the absolute path to your project directory. Note it now to use in the next step.
pwdAdd the server to Claude Desktop configuration
Edit your Claude Desktop config file to register the ESPN Fantasy Football server. Use the absolute path from the previous step as the cwd value.
Restart Claude Desktop
Save the configuration and restart Claude Desktop. The server will start automatically when Claude Desktop launches.
Authenticate for private leagues
For private leagues, ask Claude to store your ESPN credentials. Your ESPN S2 cookie and SWID can be found in browser developer tools under Application > Cookies on espn.com.
ESPN Fantasy Football Examples
Client configuration
Add this block to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json. Replace /absolute/path/to/mcp_espn_ff with the actual path from the pwd command above.
{
"mcpServers": {
"espn-fantasy-football": {
"command": "uv",
"args": ["run", "espn_fantasy_server.py"],
"cwd": "/absolute/path/to/mcp_espn_ff"
}
}
}Prompts to try
Once the server is running, use these prompts to query your ESPN Fantasy Football league through Claude.
- "Show me my current ESPN fantasy football league standings"
- "What does my roster look like this week and who should I start?"
- "Show me the weekly matchups for this week in my league"
- "How has player Patrick Mahomes been performing over the last 4 weeks?"
- "Store my ESPN credentials for my private league (I'll provide my S2 cookie and SWID)"Troubleshooting ESPN Fantasy Football
uv command not found when Claude Desktop tries to start the server
Install uv globally using pip install uv or on macOS with brew install uv. After installation, verify with uv --version. Note that Claude Desktop may use a different PATH than your terminal — you may need to use the full path to uv (e.g., /usr/local/bin/uv) in the command field of the config.
Private league returns no data or access denied errors
Private ESPN leagues require your ESPN S2 cookie and SWID authentication tokens. Open espn.com in a browser, log in, and use developer tools (Application > Cookies) to find the espn_s2 and SWID cookie values. Provide these to Claude when it asks for credentials.
Server starts but no fantasy data is returned
Ensure your ESPN account has an active fantasy football league for the current season. The ESPN Fantasy API only returns data for active or recent seasons. Verify your league ID is correct — it appears in the URL when viewing your league on espn.com.
Frequently Asked Questions about ESPN Fantasy Football
What is ESPN Fantasy Football?
ESPN Fantasy Football is a Model Context Protocol (MCP) server that espn fantasy api with llms! It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ESPN Fantasy Football?
Follow the installation instructions on the ESPN Fantasy Football GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with ESPN Fantasy Football?
ESPN Fantasy Football works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ESPN Fantasy Football free to use?
Yes, ESPN Fantasy Football is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
ESPN Fantasy Football Alternatives — Similar Analytics Servers
Looking for alternatives to ESPN Fantasy Football? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ESPN Fantasy Football in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ESPN Fantasy Football?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.