Enhanced Fantasy Football MCP Server
Optional Reddit API integration for player sentiment analysis in fantasy football decisions.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Fork notice: This is a personal fork of carterfawson/fantasy-football-mcp, itself derived from derekrbreese/fantasy-football-mcp-public. Git history was rewritten to remove credential files the upstream author had committed. Runtime deps are pinned in
requirements-runtime.txt/requirements-lock.txt.
Enhanced Fantasy Football MCP Server
A Model Context Protocol (MCP) server for Yahoo Fantasy Football integration with Claude Desktop. Features advanced lineup optimization, draft assistance, comprehensive league management, and enhanced roster management capabilities.
π Attribution
This project is based on the excellent foundation provided by derekrbreese/fantasy-football-mcp-public. Special thanks to Derek Breese for the initial concept, architecture, and scaffolding that made this enhanced version possible.
Related MCP server: Yahoo Fantasy Baseball MCP
β¨ Enhancements in This Fork
Enhanced Roster Management: Fixed "position already filled" errors with intelligent position change detection
Working Waiver Wire Transactions: Fully functional add/drop player capabilities with proper Yahoo API integration
Waiver Status Tracking: New function to monitor pending waiver claims and their approval status
Single-Player Position Changes: Safer lineup management that changes one player at a time
Improved Error Handling: Comprehensive response parsing and detailed debugging information
Fixed Import Dependencies: Resolved sleeper_api and other module import issues
Yahoo API Compliance: Updated XML formatting to match Yahoo's exact specifications
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
Clone the repository:
git clone https://github.com/carterfawson/fantasy-football-mcp.git
cd fantasy-football-mcpInstall dependencies:
pip install -r requirements.txtConfigure API credentials:
Yahoo API: Follow YAHOO_SETUP.md for detailed setup
Reddit API (optional): See REDDIT_SETUP.md for player sentiment analysis
Copy
.env.exampleto.envAdd your API credentials
Run authentication:
python utils/setup_yahoo_auth.py
Configure Claude Desktop:
Add the MCP server configuration (see INSTALLATION.md)
Restart Claude Desktop
Available MCP Tools
League Management
ff_get_leagues- List all your fantasy football leaguesff_get_league_info- Get detailed league informationff_get_standings- View current standings
Team Management
ff_get_roster- Get your team rosterff_get_matchup- View matchup details with opponent analysisff_get_opponent_roster- Get opponent's roster for matchup planningff_get_opponent_roster_comparison- Detailed roster comparison and insightsff_get_optimal_lineup- Get AI lineup recommendations
π Enhanced Roster Management
ff_set_lineup- Set your starting lineup (enhanced with intelligent position change detection)ff_change_player_position- Move a single player to a different position (safer than full lineup changes)ff_add_player- Add players from free agents or waiver wire (fully functional)ff_drop_player- Drop players from your rosterff_get_waiver_status- Check status of pending waiver claims and transactions
Player Discovery
ff_get_players- Browse available playersff_get_waiver_wire- Find top waiver pickupsff_get_draft_rankings- Get pre-draft rankings
Draft & Admin
ff_get_draft_results- View draft resultsff_get_draft_recommendation- Get live draft adviceff_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 # DependenciesConfiguration
See INSTALLATION.md for detailed setup instructions.
Security
Never commit
.envfiles or API credentialsSee SECURITY.md for security policy
Regularly rotate access tokens
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT - See LICENSE file
Support
For issues or questions, please use the GitHub Issues page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Free fantasy AI for ESPN, Sleeper, Fantrax: football, basketball and hockey in Claude and ChatGPT.
Fantasy analysis for your ESPN, Yahoo, and Sleeper leagues. Reads your leagues, never changes them.
Fantasy football for any AI agent: draft board, start/sit, waivers, your Sleeper league. Free.
Fantasy football across all your leagues: Yahoo, ESPN, Sleeper. Who to root for, waivers, scores.
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables comprehensive Sleeper Fantasy Football integration with Claude, providing real-time player projections, historical performance analytics, league management, and waiver wire analysis. Supports advanced NFL metrics, lineup optimization, and matchup analysis for fantasy football decision-making.121-
- FlicenseNot gradedqualityDmaintenanceConnects Claude to your Yahoo Fantasy Baseball team, enabling lineup management, roster analysis, and free agent scouting through natural conversation.-
- AlicenseAqualityBmaintenanceManage your Yahoo Fantasy Baseball team via Claude β check rosters, scout free agents, set lineups, and pull advanced stats from Baseball Savant, FanGraphs, and MLB Stats API.516 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Yahoo Fantasy Baseball and Basketball leagues, allowing roster analysis, matchup tracking, free agent browsing, and player stats retrieval via natural language.-