Skip to content
MCP server

Fantasy Premier League

Research a Fantasy Premier League squad and make lineup, captain and transfer changes

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers