# Fantasy Premier League

> Fantasy Premier League is an MCP server for sports data. Research a Fantasy Premier League squad and make lineup, captain and transfer changes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/anubabajide/fpl-mcp
- **MCP Registry name:** io.github.anubabajide/fpl
- **Categories:** [sports data](https://ai-powered.com/categories/sports-data), [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add fpl -- uvx fantasy-premier-league-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fpl": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fpl": {
      "command": "uvx",
      "args": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

## Tools

- `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).

## 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.

## Alternatives

- [Digimon](https://ai-powered.com/mcp/digimon): Digimon is a freemium MCP server for games and play.
- [Disney](https://ai-powered.com/mcp/disney): Disney is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [Guild Wars 2](https://ai-powered.com/mcp/guild-wars-2): Guild Wars 2 is a freemium MCP server for games and play.
- [Opendota](https://ai-powered.com/mcp/opendota): Opendota is a freemium MCP server for games and play.
- [Rebrickable](https://ai-powered.com/mcp/rebrickable): Rebrickable is a freemium MCP server for games and play.
- [Wynncraft](https://ai-powered.com/mcp/wynncraft): Wynncraft is a freemium MCP server for games and play.
- [20-0 MCP](https://ai-powered.com/mcp/20-0-mcp): 20-0 MCP is an open-source MCP server for games and play.

---
Source: https://ai-powered.com/mcp/fantasy-premier-league
