Fantasy Football MCP Server

A comprehensive Model Context Protocol (MCP) server for Yahoo Fantasy Football that provides intelligent lineup optimization, draft assistance, and league management through AI-powered tools.

🚀 Features

Core Capabilities

• Multi-League Support – Automatically discovers and manages all Yahoo Fantasy Football leagues associated with your account
• 🆕 Player Enhancement Layer – Intelligent projection adjustments with bye week detection, recent performance stats, and breakout/declining player flags
• Intelligent Lineup Optimization – Advanced algorithms considering matchups, expert projections, and position-normalized value
• Draft Assistant – Real-time draft recommendations with strategy-based analysis and VORP calculations
• Comprehensive Analytics – Reddit sentiment analysis, team comparisons, and performance metrics
• Multiple Deployment Options – FastMCP, traditional MCP, Docker, and cloud deployment support

Advanced Analytics

• Position Normalization – Smart FLEX decisions accounting for different position baselines
• Multi-Source Projections – Combines Yahoo and Sleeper expert rankings with matchup analysis
• Strategy-Based Optimization – Conservative, aggressive, and balanced approaches
• Volatility Scoring – Floor vs ceiling analysis for consistent or boom-bust plays
• Live Draft Support – Real-time recommendations during active drafts

🆕 Player Enhancement Layer

The enhancement layer enriches player data with real-world context to fix stale projections and prevent common mistakes:

Key Features

✅ Bye Week Detection – Automatically zeros projections and displays "BYE WEEK - DO NOT START" for players on bye, preventing accidental starts

✅ Recent Performance Stats – Fetches last 1-3 weeks of actual performance from Sleeper API and displays trends (L3W avg: X.X pts/game)

✅ Performance Flags – Intelligent alerts including:

• BREAKOUT_CANDIDATE – Recent performance > 150% of projection
• TRENDING_UP – Recent performance exceeds projection
• DECLINING_ROLE – Recent performance < 70% of projection
• HIGH_CEILING – Explosive upside potential
• CONSISTENT – Reliable, steady performance

✅ Adjusted Projections – Blends recent reality with stale projections for more accurate start/sit decisions (60/40 or 70/30 weighting based on confidence)

Example

Before Enhancement:

{
  "name": "Rico Dowdle",
  "sleeper_projection": 4.0,
  "recommendation": "Bench"
}

After Enhancement:

{
  "name": "Rico Dowdle",
  "sleeper_projection": 4.0,
  "adjusted_projection": 14.8,
  "performance_flags": ["BREAKOUT_CANDIDATE", "TRENDING_UP"],
  "enhancement_context": "Recent breakout: averaging 18.5 pts over last 3 weeks",
  "recommendation": "Strong Start"
}

The enhancement layer is non-breaking and automatically applies to:

• ff_get_roster (with include_external_data=True)
• ff_get_waiver_wire (with include_external_data=True)
• ff_get_players (with include_external_data=True)
• ff_build_lineup (automatic)

🛠️ Available MCP Tools

League & Team Management

• ff_get_leagues – List all leagues for your authenticated Yahoo account
• ff_get_league_info – Retrieve detailed league metadata and team information
• ff_get_standings – View current league standings with wins, losses, and points
• ff_get_roster – Inspect detailed roster information for any team
• ff_get_matchup – Analyze weekly matchup details and projections
• ff_compare_teams – Side-by-side team roster comparisons for trades/analysis
• ff_build_lineup – Generate optimal lineups using advanced optimization algorithms

Player Discovery & Waiver Wire

• ff_get_players – Browse available free agents with ownership percentages
• ff_get_waiver_wire – Smart waiver wire targets with expert analysis (configurable count)
• ff_get_draft_rankings – Access Yahoo's pre-draft rankings and ADP data

... View full README on GitHub