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