Fantasy Football Manager — Claude Code MCP server for ESPN leagues
Brings an ESPN fantasy league into an AI client: reads rosters and projections, works out a legal weekly lineup, and files free-agent moves.
claude mcp add fantasy-football-manager -- uvx fantasy-football-managerWhat Fantasy Football Manager does
Several MCP servers ship in one package. One handles analysis, policy and league state; the ESPN companion covers live observation and transactions; a portfolio server rolls every configured team into a single view. Season operations go over authenticated HTTP, so no Chrome or Playwright is involved. Draft work still runs through the browser adapter.
You need an ESPN account plus a protected session file, pointed at by FFM_ESPN_CREDENTIAL_FILE. Both servers must share the same per-team state directory. The flow: espn_connect with league, team, season, phase="season", transport="http" and scoring week, then espn_sync, then recommend_lineup. Action modes are read with get_manager_config and replaced with update_manager_config, passing the config's current revision.
A recommendation or submission fails when projections are missing or player lock evidence is absent. Verified HTTP reads cover roster ownership and locks, but waiver processing, IR moves and scoring-week rollover have not been tested. Treat those as unproven before turning on automatic mode.
What it helps with
- build a legal weekly lineup from current projections
- sync an ESPN league roster into local state
- prepare an exact free-agent proposal and confirm it
- check player locks before a deadline
- track several managed teams in one dashboard
Example prompts for the agent
- Connect to my ESPN league and show the current roster
- Sync the league and suggest a legal lineup for this week
- Draft a free-agent proposal in review mode, I'll confirm it
How to install Fantasy Football Manager
Platform CLI
claude mcp add fantasy-football-manager -- uvx fantasy-football-manageruvx runs the command named after the package; if the README names another one, use uvx --from fantasy-football-manager <command>
Platform CLI
codex mcp add fantasy-football-manager -- uvx fantasy-football-manageruvx runs the command named after the package; if the README names another one, use uvx --from fantasy-football-manager <command>
Config file
{
"mcpServers": {
"fantasy-football-manager": {
"command": "uvx",
"args": [
"fantasy-football-manager"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from fantasy-football-manager <command>
Config file
{
"servers": {
"fantasy-football-manager": {
"type": "stdio",
"command": "uvx",
"args": [
"fantasy-football-manager"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from fantasy-football-manager <command>
Platform CLI
gemini mcp add fantasy-football-manager uvx fantasy-football-manageruvx runs the command named after the package; if the README names another one, use uvx --from fantasy-football-manager <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Fantasy Football Manager
How do I install Fantasy Football Manager in Claude Code?
Run claude mcp add fantasy-football-manager -- uvx fantasy-football-manager.
What does Fantasy Football Manager do?
It reads an ESPN league over authenticated HTTP, syncs roster and projections, calculates a legal lineup for the week, and can submit player moves under a configured mode.
What does it need to run?
An ESPN account and a protected session file referenced by FFM_ESPN_CREDENTIAL_FILE. Both MCP servers have to point at the same per-team state directory.
