fantasy-yolo

A programmatic interface to your own ESPN Fantasy Football team — an MCP server and a CLI, sharing one set of tools.

The human is the brain. This makes no roster decisions. It answers questions about your league accurately and executes what you tell it, carefully. There is no optimizer and no projections model.

$ fy roster
$ fy matchup

The same tools are exposed over MCP, so an agent you already use can answer "who am I playing this week" or "any injuries on my roster" against live data.

Status

Early. Reads work; the write path is designed but not built. See docs/design.md and docs/user-stories.md.

Setup

See docs/setup.md. In short: copy two cookies out of your browser, put them in a chmod 0600 file, write a small config naming your league and team.

What you should know before using this

This is unofficial. It is not affiliated with, endorsed by, or sponsored by ESPN or Disney. It drives a private, undocumented API that can change or break without notice.

It runs on your machine, with your credentials, on your own account. It operates no service and redistributes nothing.

"Runs locally" is not "stays local." Everything this server returns is handed to whatever MCP client and model you have configured — which for most people is a hosted service. The project ships no telemetry and opens no network connection other than to ESPN, but that is not the same as your roster staying on your machine.

What you are risking. ESPN's terms restrict unofficial automated access. ESPN can suspend or terminate your account and your league, and neither this project nor its author can restore anything they take. Read Disney's Terms of Use and ESPN's Fair Play and Conduct rules and decide for yourself.

espn_s2 is a full session cookie, not a scoped token. Leaking it is account compromise. Never paste it into an issue or a chat.

Licence

MIT, covering this project's own code. It grants no rights to ESPN's data, marks, or API, and it is not permission from ESPN.

Reads are built on espn-api (MIT).