derekrbreese/fantasy-football-mcp-public
View on GitHub ↗Yahoo Fantasy Football MCP server for Claude Desktop - Advanced lineup optimization, draft assistance, and league management. Built using Claude Code.
46 ★29 forksPythonUpdated 21d ago
What you need to know
Comprehensive MCP server for Yahoo Fantasy Football with lineup optimization, draft assistance and league management. Multi-league support, a player enhancement layer (bye week detection, recent performance, breakout/declining flags), VORP-based draft recommendations, Reddit sentiment analysis and multiple deployment options (FastMCP, stdio, Docker, cloud).
Install
git clone && pip install -r requirements.txt Set up Yahoo Developer App credentials in .env python setup_yahoo_auth.py (first-time OAuth)
Usage
- •ff_get_leagues, ff_get_standings, ff_get_roster, ff_get_matchup, ff_compare_teams
- •ff_build_lineup for optimal lineups
- •ff_get_draft_recommendation during drafts
- •ff_analyze_reddit_sentiment for player buzz
- •Local: python fastmcp_server.py (http://localhost:8000); stdio: python fantasy_football_multi_league.py; Docker: docker build -t fantasy-football-mcp .
Key features
- ✓Multi-league discovery and management
- ✓Player Enhancement Layer: bye week detection, last 1-3 week performance, BREAKOUT_CANDIDATE/TRENDING_UP/DECLINING_ROLE/HIGH_CEILING/CONSISTENT flags, adjusted projections
- ✓Lineup optimization with position normalization, multi-source projections (Yahoo + Sleeper), strategy-based approaches and volatility scoring
- ✓Draft Assistant with VORP and live draft recommendations
- ✓Reddit sentiment analysis, cache management, OAuth token refresh
- ✓FastMCP, stdio, Docker and cloud (Render/Railway) deployment
Best for
Yahoo fantasy football managers who want AI lineup and draft assistance
Caveats
- ⚠Requires active Yahoo Fantasy Football leagues and valid API credentials
- ⚠Reddit sentiment requires optional Reddit credentials
- ⚠Yahoo rate limits (1000 req/hour; server caps at 900/hour)
Clients: Claude Code · Claude Desktop · Cursor · Antigravity
Documentation ↗Reviewed 2026-08-11
Topics
claude-desktopfantasy-footballfantasy-sportslineup-optimizationmcpmodel-context-protocolpythonyahoo-api
- Stars
- 46★
- Forks
- 29
- Language
- Python
- License
- MIT
- Created
- 2025-08-12
- Last push
- 2026-08-14