fantasy-football-mcp-public

Overview

This is a comprehensive MCP server specifically designed for Yahoo Fantasy Football. It provides advanced features including multi-league support, intelligent lineup optimization algorithms, draft assistance with real-time recommendations, and player enhancement layers that augment projections with recent performance data. The server integrates with Yahoo API for league data and Sleeper API for expert rankings, with optional Reddit integration for sentiment analysis. It supports multiple deployment options including FastMCP, traditional stdio, Docker, and cloud platforms.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• ff_get_leagues

  List all leagues for your authenticated Yahoo account

  Try:Show me all my fantasy football leaguesTry:What leagues am I in?
• ff_get_league_info

  Retrieve detailed league metadata and team information

  Try:Get details about my main leagueTry:Show league settings and team info
• ff_get_standings

  View current league standings with wins, losses, and points

  Try:Who's winning my league?Try:Show me the current standings
• ff_get_roster

  Inspect detailed roster information for any team

  Try:Show me my current rosterTry:What players are on team XYZ?
• ff_get_matchup

  Analyze weekly matchup details and projections

  Try:How's my matchup this week?Try:Show me my opponent's projected points
• ff_build_lineup

  Generate optimal lineups using advanced optimization algorithms

  Try:Create my best lineup for this weekTry:Optimize my lineup with bye week considerations
• ff_get_players

  Browse available free agents with ownership percentages

  Try:Show me available free agentsTry:Who should I pick up from waivers?
• ff_get_waiver_wire

  Smart waiver wire targets with expert analysis

  Try:Who are the top waiver wire pickups?Try:Suggest 3 players to add this week
• ff_get_draft_recommendation

  AI-powered draft pick suggestions with strategy analysis

  Try:Who should I draft with my next pick?Try:Suggest a strategy for round 5
• ff_analyze_reddit_sentiment

  Social media sentiment analysis for player buzz and injury updates

  Try:What's the sentiment on Aaron Jones?Try:Check Reddit for any injury news on my players
• ff_get_api_status

  Monitor cache performance and Yahoo API rate limiting

  Try:Check my API statusTry:Am I close to Yahoo's rate limit?
• ff_clear_cache

  Clear cached responses for fresh data

  Try:Clear all cached dataTry:Force refresh player information

Comparable tools

Installation

git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public
pip install -r requirements.txt

YAHOO_CLIENT_ID=your_consumer_key_here
YAHOO_CLIENT_SECRET=your_consumer_secret_here
YAHOO_ACCESS_TOKEN=your_access_token
YAHOO_REFRESH_TOKEN=your_refresh_token
YAHOO_GUID=your_yahoo_guid

cd utils
python setup_yahoo_auth.py

{
  "mcpServers": {
    "fantasy-football": {
      "command": "python",
      "args": ["/path/to/fantasy_football_multi_league.py"]
    }
  }
}

FAQ

How often do Yahoo API tokens need to be refreshed?

Yahoo API tokens expire hourly. Use the `refresh_yahoo_token.py` script or run `python utils/refresh_yahoo_token.py` to update them automatically.

Can I use this server with non-Yahoo fantasy football leagues?

No, this server is specifically designed for Yahoo Fantasy Football and requires Yahoo API credentials to function.

Compare fantasy-football-mcp-public with