Fantasy Premier League
Research a Fantasy Premier League squad and make lineup, captain and transfer changes
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.2
- Listing updated
- today
Similar MCP servers
About Fantasy Premier League
Fantasy Premier League is an MCP server for sports data. It runs locally on your machine and is started by your AI client.
Everything read-only works with no login: squad views, season summaries, gameweek reports, player research and bulk exports for your own modelling. Only three tools write to your team, fpl_set_lineup, fpl_set_captain and fpl_make_transfers, and those need a session.
Signing in is done by the user in a real browser window on FPL's own page, using authorization code with PKCE. The README explains that FPL's identity provider rejects password grants, so the server never stores or handles an email and password. It keeps a refresh token in ~/.fpl-mcp/credentials.json, readable only by the user. A fallback tool accepts a bearer token pasted by hand; that token lasts about an hour.
It runs locally over stdio, which the README calls the safest option because nothing is exposed off the machine. A remote HTTP mode exists for connector-style clients and refuses to start without a shared secret of 16 or more characters, since an open endpoint could let anyone change the team. An fpl.mcpb bundle is also offered. The login flow needs a local Chromium install.
Install
Run in a terminal
claude mcp add fpl -- uvx fantasy-premier-league-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"fpl": {
"command": "uvx",
"args": [
"fantasy-premier-league-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fpl": {
"command": "uvx",
"args": [
"fantasy-premier-league-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fpl": {
"type": "stdio",
"command": "uvx",
"args": [
"fantasy-premier-league-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fpl": {
"command": "uvx",
"args": [
"fantasy-premier-league-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fpl": {
"command": "uvx",
"args": [
"fantasy-premier-league-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (18)
Taken from the project documentation; the running server may differ.
- fpl_setup
- Stores your team id and a default mini-league id.
- fpl_login
- Signs in once through a browser window and remembers the session.
- fpl_logout
- Forgets the saved session and revokes it at FPL.
- fpl_auth_status
- Checks the session, renewing the token if needed.
- fpl_set_token
- Accepts a bearer token pasted by hand as a fallback.
- fpl_my_squad
- Shows the starting XI, bench, captain, formation, bank, free transfers and chips.
- fpl_season_summary
- Points, overall rank, rank by gameweek, chips, hits and past seasons.
- fpl_gameweek_report
- Per-player scoring for a gameweek, including bench and auto-subs.
- fpl_best_performers
- Ranks your own squad by contribution.
- fpl_top_players
- Top players filtered by position, club and price.
- fpl_player
- One player in depth: stats, fixtures, set pieces, injury news.
- fpl_compare_players
- Compares two or more players side by side.
- fpl_search_players
- Looks players up by name.
- fpl_fixture_ticker
- Ranks clubs by upcoming fixture difficulty.
- fpl_export_players
- Exports a compact player pool.
- fpl_set_lineup
- Changes the lineup (needs a session).
- fpl_set_captain
- Sets the captain (needs a session).
- fpl_make_transfers
- Makes transfers (needs a session).
What it does
- Squad and season views
- Starting XI, bench, captain, bank, free transfers, chips, rank by gameweek.
- Player research
- Rank players by position, club and price, compare them, and view fixtures, set pieces and injury news.
- Fixture ticker
- Clubs ranked by upcoming fixture difficulty.
- Team changes
- Set the lineup, pick a captain or make transfers.
- Browser sign-in
- The user logs in on FPL's own page; no password is stored.
- Bulk export
- Compact player data for your own modelling.
- Local or remote
- Runs over stdio, or as an HTTPS connector protected by a shared secret.
Good for
- Pick a captain for the coming gameweek
- Find differentials and compare candidates before a transfer
- Review how each gameweek scored, including bench and auto-subs
- Check which clubs have the easiest fixtures
- Export player data for a spreadsheet model
Fantasy Premier League FAQ
Do I need to log in?
Not for read-only tools. Only lineup, captain and transfer tools need a session.
Does it store my FPL password?
No. You sign in yourself in a browser window and only a refresh token is saved.
How do I install it?
Run it with `uvx fantasy-premier-league-mcp`, or install it with `uv tool install`.
Why is Chromium needed?
`fpl_login` opens FPL's sign-in page in a local browser window.
Can I run it remotely?
Yes, with `--http` and a `FPL_MCP_SHARED_SECRET`, behind an HTTPS tunnel.
How do I add Fantasy Premier League to Claude Code?
Run this command in your terminal: claude mcp add fpl -- uvx fantasy-premier-league-mcp
What are the best alternatives to Fantasy Premier League?
The closest alternatives to Fantasy Premier League are Digimon, Disney, Clash Royale, Guild Wars 2 and Opendota.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
