home / mcp / fantasy football mcp server

Fantasy Football MCP Server

Provides a multi-league Yahoo Fantasy Football MCP server with AI-powered lineup optimization, drafting help, and analytics.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "derekrbreese-fantasy-football-mcp-public": {
      "command": "python",
      "args": [
        "fastmcp_server.py"
      ]
    }
  }
}

You have a multi-league Yahoo Fantasy Football MCP Server that uses AI-powered tools to optimize lineups, assist with drafts, and manage leagues. It connects to Yahoo and Sleeper data sources, enriches player projections, and provides real-time recommendations to help you win more consistently across all your leagues.

How to use

Start by running the local MCP server you prefer. You can launch either the FastMCP HTTP-compatible local server or the stdio-based integration, then connect your MCP client to the provided entry points to access intelligent lineup optimization, draft recommendations, and league analytics.

How to install

Prerequisites: Python must be installed on your system and you should have access to the internet to install dependencies.

Step 1: Clone the project repository and enter the project directory.

Step 2: Install Python dependencies from the requirements file.

Step 3: Prepare your Yahoo API credentials and complete the initial authentication flow.

Step 4: Run the preferred local server entry point.

Deployment and runtime options

Local Development (FastMCP) and Claude Code Integration (Stdio) are provided for quick testing and development. You can also deploy via Docker or on a cloud platform for production usage.

Configuration and authentication

Create a .env file with your Yahoo API credentials and ensure you complete OAuth authentication so the server can access your leagues and players.

Troubleshooting and tips

If you encounter authentication or rate-limiting issues, refresh tokens or reauthenticate, and monitor API status to adjust request cadence. Clear caches if data becomes stale to force fresh data retrieval.

Security and credentials

Keep your Yahoo API credentials secure and do not share tokens publicly. Use environment variables to provide secrets to the server without embedding them in code.

Available tools

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

ff_get_players

Browse available free agents with ownership percentages

ff_get_waiver_wire

Smart waiver wire targets with expert analysis

ff_get_draft_rankings

Access Yahoo's pre-draft rankings and ADP data

ff_get_draft_recommendation

AI-powered draft pick suggestions with strategy analysis

ff_analyze_draft_state

Real-time roster needs and positional analysis during drafts

ff_get_draft_results

Post-draft analysis with grades and team summaries

ff_analyze_reddit_sentiment

Social media sentiment analysis for player buzz and injury updates

ff_get_api_status

Monitor cache performance and Yahoo API rate limiting

ff_clear_cache

Clear cached responses for fresh data

ff_refresh_token

Automatically refresh Yahoo OAuth tokens