fantasy-football-mcp-public

Druhayes/fantasy-football-mcp-public

3.2

If you are the rightful owner of fantasy-football-mcp-public and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Fantasy Football MCP Server integrates Yahoo Fantasy Football with Claude Desktop, offering advanced lineup optimization and league management.

Tools
5
Resources
0
Prompts
0

MSeeP.ai Security Assessment Badge

Fantasy Football MCP Server

A Model Context Protocol (MCP) server for Yahoo Fantasy Football integration with Claude Desktop. Features advanced lineup optimization, draft assistance, and comprehensive league management.

Features

  • Multi-League Support: Manage all your Yahoo Fantasy Football leagues
  • AI-Powered Optimization: Advanced lineup recommendations with multiple strategies
  • Draft Assistant: Real-time draft recommendations and analysis
  • Waiver Wire Analysis: Find top pickups with trending data
  • Position Normalization: Smart FLEX decisions with position-adjusted scoring
  • Rate Limiting & Caching: Efficient API usage with built-in optimization

Quick Start

Prerequisites

  • Python 3.9+
  • Claude Desktop
  • Yahoo Fantasy Sports account
  • Yahoo Developer App credentials

Installation

  1. Clone the repository:
git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public
  1. Install dependencies:
pip install -r requirements.txt

  1. Configure API credentials:

    • Yahoo API: Follow for detailed setup
    • Reddit API (optional): See for player sentiment analysis
    • Copy .env.example to .env
    • Add your API credentials
    • Run authentication: python utils/setup_yahoo_auth.py

  2. Configure Claude Desktop:

    • Add the MCP server configuration (see )
    • Restart Claude Desktop

Available MCP Tools

League Management

  • ff_get_leagues - List all your fantasy football leagues
  • ff_get_league_info - Get detailed league information
  • ff_get_standings - View current standings

Team Management

  • ff_get_roster - Get your team roster
  • ff_get_matchup - View matchup details with opponent analysis
  • ff_get_opponent_roster - Get opponent's roster for matchup planning
  • ff_get_opponent_roster_comparison - Detailed roster comparison and insights
  • ff_get_optimal_lineup - Get AI lineup recommendations

Player Discovery

  • ff_get_players - Browse available players
  • ff_get_waiver_wire - Find top waiver pickups
  • ff_get_draft_rankings - Get pre-draft rankings

Draft & Admin

  • ff_get_draft_results - View draft results
  • ff_get_draft_recommendation - Get live draft advice
  • ff_refresh_token - Refresh Yahoo access token

Project Structure

fantasy-football-mcp-public/
ā”œā”€ā”€ fantasy_football_multi_league.py  # Main MCP server
ā”œā”€ā”€ src/                               # Core modules
ā”‚   ā”œā”€ā”€ agents/                        # Specialized agents
ā”‚   ā”œā”€ā”€ models/                        # Data models
ā”‚   ā”œā”€ā”€ strategies/                    # Lineup strategies
ā”‚   ā””ā”€ā”€ utils/                         # Utility functions
ā”œā”€ā”€ utils/                             # Authentication utilities
ā”œā”€ā”€ config/                            # Configuration
ā””ā”€ā”€ requirements.txt                   # Dependencies

Configuration

See for detailed setup instructions.

Security

  • Never commit .env files or API credentials
  • See for security policy
  • Regularly rotate access tokens

Contributing

See for guidelines.

License

MIT - See file

Support

For issues or questions, please use the GitHub Issues page.