fantasy-football -public

This MCP server provides AI-powered tools for Yahoo Fantasy Football, including multi-league discovery, intelligent lineup optimization, draft assistance, and rich analytics. Use the available MCP tools to manage leagues, view standings, inspect rosters, analyze matchups, and optimize lineups with a blend of projections and recent performance signals. Advanced features such as the Player Enhancement Layer automatically adjust projections for bye weeks, recent performance, and risk flags to help you start the right players. You can run the server locally with the FastMCP interface and interact with it over HTTP, making it suitable for integration with Claude Code, custom scripts, or cloud deployments.

Prerequisites:

• Python 3.8+ installed on your system
• Git access to clone the repository
• Access to Yahoo API credentials (Client ID, Client Secret, Access/Refresh tokens)

Step-by-step:

1. Clone the repository

git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public

2. Create and populate the environment file or export variables

# Example using an .env file (recommended)
echo 'YAHOO_CLIENT_ID=your_consumer_key_here' > .env
echo 'YAHOO_CLIENT_SECRET=your_consumer_secret_here' >> .env
echo 'YAHOO_ACCESS_TOKEN=your_access_token' >> .env
echo 'YAHOO_REFRESH_TOKEN=your_refresh_token' >> .env
echo 'YAHOO_GUID=your_yahoo_guid' >> .env
echo 'REDDIT_CLIENT_ID=your_reddit_client_id' >> .env
echo 'REDDIT_CLIENT_SECRET=your_reddit_client_secret' >> .env
echo 'REDDIT_USERNAME=your_reddit_username' >> .env

3. Install Python dependencies

pip install -r requirements.txt

4. Run the FastMCP server locally

python fastmcp_server.py

The server will be accessible at http://localhost:8000 by default.

Environment variables are essential for Yahoo OAuth and optional Reddit sentiment features. If you omit Reddit credentials, Reddit sentiment analytics will be unavailable but the core MCP functionality remains active. When authenticating via OAuth, you may need to complete the browser-based flow and then rerun authentication scripts or restart the server. For Docker deployment, you can pass a .env file to the container to supply these variables securely. If you encounter API rate limits, use the provided token refresh workflow and consider enabling the caching and token refresh endpoints in your integration.