Fantasy Football MCP
Yahoo Fantasy Football MCP server for Claude Desktop - Advanced lineup optimization, draft assistance, and league management. Built using Claude Code.
What is Fantasy Football MCP?
Fantasy Football MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to yahoo fantasy football mcp server for claude desktop - advanced lineup optimization, draft assistance, and league management. built using claude code.
Yahoo Fantasy Football MCP server for Claude Desktop - Advanced lineup optimization, draft assistance, and league management. Built using Claude Code.
This server falls under the Analytics and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Yahoo Fantasy Football MCP server for Claude Desktop - Advan
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx fantasy-football-mcp-publicConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Fantasy Football MCP
The Fantasy Football MCP Server connects Claude Desktop to your Yahoo Fantasy Football account, providing AI-powered lineup optimization, draft assistance, waiver wire analysis, and comprehensive league management tools. It integrates with Yahoo's OAuth API and optionally with Sleeper and Reddit APIs to enrich player projections with real-time performance data, bye-week flags, and social sentiment. Ideal for fantasy football managers who want data-driven AI advice directly in their chat interface.
Prerequisites
- Python 3.10+ with pip for dependency installation
- A Yahoo Developer App with Consumer Key and Consumer Secret (create at developer.yahoo.com)
- Yahoo Fantasy Football account with at least one active league
- An MCP-compatible client such as Claude Desktop
- Optional: Reddit API credentials for sentiment analysis features
Clone the repository
Clone the project from GitHub and navigate to the project directory. This server is not published to PyPI and must be run from source.
git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public
pip install -r requirements.txtCreate a Yahoo Developer App
Visit developer.yahoo.com and create a new application. Select Fantasy Sports as the API, note your Consumer Key and Consumer Secret, and set the callback URL to oob (out-of-band) for local auth.
Create the .env file with your credentials
Create a .env file in the project root with your Yahoo API credentials. Reddit credentials are optional but enable sentiment analysis.
YAHOO_CLIENT_ID=your_consumer_key_here
YAHOO_CLIENT_SECRET=your_consumer_secret_here
YAHOO_ACCESS_TOKEN=
YAHOO_REFRESH_TOKEN=
YAHOO_GUID=
# Optional Reddit credentials
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
REDDIT_USERNAME=your_reddit_usernameComplete the Yahoo OAuth flow
Run the authentication setup script which opens a browser for OAuth authorization and automatically writes your access and refresh tokens into the .env file.
cd utils
python setup_yahoo_auth.pyConfigure Claude Desktop
Add the server to your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json, pointing to the absolute path of the project and using the stdio server entry point.
Restart Claude Desktop and verify
Restart Claude Desktop after saving the config. Ask Claude to list your fantasy football leagues to confirm the connection is working.
Fantasy Football MCP Examples
Client configuration
Claude Desktop config block that runs the fantasy football server directly from the cloned repository using the stdio-mode entry point.
{
"mcpServers": {
"fantasy-football": {
"command": "python",
"args": ["/absolute/path/to/fantasy-football-mcp-public/fantasy_football_multi_league.py"],
"env": {
"YAHOO_CLIENT_ID": "your_consumer_key",
"YAHOO_CLIENT_SECRET": "your_consumer_secret",
"YAHOO_ACCESS_TOKEN": "your_access_token",
"YAHOO_REFRESH_TOKEN": "your_refresh_token",
"YAHOO_GUID": "your_yahoo_guid"
}
}
}
}Prompts to try
Example prompts that exercise lineup optimization, waiver wire advice, and draft assistance tools.
- "Show me my current roster for league 12345 and suggest the best lineup for this week"
- "Who are the top waiver wire pickups for this week based on recent performance?"
- "Compare my team to my opponent's team and highlight my weakest positions"
- "I'm drafting at pick 7 — who should I take with my next three picks?"
- "Analyze Reddit sentiment for injured players on my roster"Troubleshooting Fantasy Football MCP
Yahoo OAuth token expired errors during runtime
Run utils/refresh_yahoo_token.py to get a new access token, then restart Claude Desktop. Tokens expire periodically and must be refreshed. The ff_refresh_token tool can also be called directly from Claude.
ff_get_leagues returns an empty list or authentication error
Make sure YAHOO_GUID is set correctly in your .env file. The GUID is your Yahoo user ID, which you can find in your Yahoo profile settings. Re-run setup_yahoo_auth.py if you are unsure.
Reddit sentiment analysis tools return errors
Reddit credentials are optional. If not configured, the ff_analyze_reddit_sentiment tool will be unavailable. To enable it, register a Reddit app at reddit.com/prefs/apps and add the three REDDIT_ env vars to your .env file.
Frequently Asked Questions about Fantasy Football MCP
What is Fantasy Football MCP?
Fantasy Football MCP is a Model Context Protocol (MCP) server that yahoo fantasy football mcp server for claude desktop - advanced lineup optimization, draft assistance, and league management. built using claude code. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Fantasy Football MCP?
Follow the installation instructions on the Fantasy Football MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Fantasy Football MCP?
Fantasy Football MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Fantasy Football MCP free to use?
Yes, Fantasy Football MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Fantasy Football MCP Alternatives — Similar Analytics Servers
Looking for alternatives to Fantasy Football MCP? 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 Fantasy Football MCP 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 Fantasy Football MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.