Fantasy Football Manager MCP server
ESPN draft and lineup analysis for Codex and MCP clients. Live actions use the ESPN companion.
89 stars
Reviews
Write oneNobody has reviewed Fantasy Football Manager yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Fantasy Football Manager tools (38, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
espn_connectConnect one authenticated ESPN league, team, season, and phase, then save the connection locally.
espn_disconnectStop this process's loop and release its ESPN connection.
espn_get_statusRead cached ESPN connection, automation, and submission status without a new ESPN request.
espn_prepare_draft_pickRefresh the connected draft and save one exact pick proposal without a submission click.
espn_prepare_lineupRefresh the weekly roster and save one legal lineup proposal without submitting a transaction.
espn_prepare_season_actionRefresh ESPN through HTTP and prepare one exact season transaction without submitting it.
espn_reconcile_draft_pickObserve ESPN draft history to verify one previously authorized pick without another submission click.
espn_reconcile_lineupObserve the weekly ESPN roster to verify one authorized lineup transaction without submitting another action.
espn_reconcile_season_actionRead ESPN through HTTP to resolve a season submission without another transaction request.
espn_start_automationStart continuous ESPN observation and analysis inside this MCP server process.
espn_start_standalone_workerStart an independent local ESPN worker that continues after the MCP client or Codex closes.
espn_stop_automationSave automation.paused=true in local configuration and request a stop for this process's ESPN loop.
espn_submit_draft_pickwrite actionAuthorize and attempt one real ESPN draft pick from a prepared proposal.
espn_submit_lineupwrite actionAuthorize and attempt one real ESPN lineup transaction from a prepared proposal.
espn_submit_season_actionwrite actionAuthorize and submit one prepared ESPN HTTP season transaction, then observe its result.
espn_syncRead the connected ESPN draft or weekly roster into the manager's local state.
execute_demo_actionwrite actionExecute an existing proposal against synthetic demo state only.
get_action_historyRead recent audit records from this data directory without changing state.
get_capabilitiesRead this server's capabilities before selecting analysis or execution tools.
get_draft_recommendationsRead cached results and status from the local draft monitor without running a simulation.
get_managed_analysisRead one team's available analysis and its observation context.
get_managed_teamRead one configured team's saved roster, starters, reserve players, rules, and policy summary.
get_manager_configRead the full current configuration and its config_revision.
get_power_rankingsCompare every team's best legal weekly lineup by projected points.
get_source_statusCheck the freshness and completeness of the saved observation.
get_teamRead the selected team's roster from the saved snapshot.
import_league_snapshotValidate and save a complete league snapshot supplied by the caller.
list_managed_proposalsRead saved proposed changes across teams for review.
list_managed_teamsList configured teams across leagues before requesting a team, players, or proposals.
load_demoLoad a fictional scenario for local testing or demonstrations.
prepare_actionValidate a synthetic action and save a proposal without executing it.
rank_waiver_candidatesRank alternative single-player acquisitions using the saved weekly snapshot and user limits.
recommend_draftwrite actionRun one bounded draft simulation against the current imported draft snapshot.
recommend_lineupOptimize the selected team's known weekly projections while preserving locked slots.
search_managed_playersSearch saved players across managed teams or within one team context.
start_draft_monitorStart background draft simulations and return the initial monitor status.
stop_draft_monitorRequest shutdown of the local draft monitor and wait up to five seconds.
update_manager_configwrite actionReplace the saved configuration using its current configuration revision.
Public scan report
scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan55 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
What the publisher says
From the Fantasy Football Manager repository's README, as published. We do not edit it. Read it on GitHub
Fantasy Football Manager
ESPN fantasy football team management for Codex and other Model Context Protocol (MCP) clients. Season operations use authenticated HTTP without Chrome or Playwright. Connect your league, sync its roster, and calculate a legal weekly lineup from current projections. The same package provides a draft assistant with continuous Monte Carlo simulations and a server coordinator for multiple teams.
<!-- mcp-name: io.github.krmisystems/fantasy-football-manager -->
The manager MCP server provides 17 tools for analysis, policy, and league state. The ESPN MCP companion provides 16 tools for live observations, controlled transactions, and continuous operation. The portfolio MCP adds five tools for all configured teams, players, saved proposals, and lineup analysis. HTTP season actions include lineups, free-agent additions, waiver claims, drops, and IR moves. Draft support retains the existing browser adapter.
Version 0.4.0 preview: The reviewed v0.4.0 wheel is deployed privately and has completed a five-team HTTP observation sweep. An explicitly authorized coverage repair also confirmed two automatic HTTP actions: a free-agent add/drop and a subsequent lineup exchange. Version 0.3.3 assets retain their earlier behavior. See the release links below for the v0.4.0 preview. Read HTTP season acceptance for the current evidence and remaining live validation. Read Stable release readiness for scheduled acceptance checks, backup verification, and release gates.
This independent project requires your ESPN account. A protected session file supplies HTTP authentication. An optional Linux import reads only the two ESPN session cookies from an existing profile without starting a browser.
Try a fictional lineup
Run this demo with Python 3.11 or later and uv. It requires no ESPN account, Chrome session, or MCP client.
uvx --from fantasy-football-manager==0.4.0 fantasy-football-manager --demoThe command prints a fictional lineup report and exits without changing saved league state. The verified demo returns status: "ok", liveactions: false, and a projected improvement of 5.50 points**. These values describe synthetic inputs, not a measured fantasy result.
Read the developer showcase for the design, verified trials, and contribution ideas.
Open the team dashboard
The source checkout includes Fieldroom, a local dashboard for multiple managed teams. Inspect rosters, source health, projections, action limits, and proposed changes in one workspace. Optional approval controls submit exact saved HTTP season proposals through the existing transaction service.
uv sync --locked
uv run fantasy-football-dashboard --demo --enable-actionsOpen http://127.0.0.1:8765/. Demo approvals affect fictional in-memory records only. They make no ESPN requests. The dashboard requires no Node.js runtime, ESPN account, or external UI service. This dashboard is not included in the published v0.3.3 package.
Read the dashboard setup and API guide for actual team data and submission controls. Use the media UI integration prompt to connect an existing authenticated home-server interface. Football is the only implemented sport. The portfolio envelope leaves room for future adapters.
Start with a weekly lineup
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add fantasy-football-manager -- uvx fantasy-football-manager
Fantasy Football Manager: common questions
- Is Fantasy Football Manager MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Fantasy Football Manager safety report
- How do I install Fantasy Football Manager?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Fantasy Football Manager need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Fantasy Football Manager maintained?
- The last commit was 6 days ago (2026-09-15). The latest release is v0.4.0.