# Fantasy Premier League (pypi · fantasy-premier-league-mcp)

Research and manage a Fantasy Premier League team from any MCP-capable agent.

- Trust score: 51/100 (low)
- Change this week: −15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- pypi · `fantasy-premier-league-mcp`: 51/100 (this document), [markdown](https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp.md), [page](https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp)

## Channel facts

- Registry: `pypi`
- Package: `fantasy-premier-league-mcp`
- Version: `0.3.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 32/100
  - Malware scan not yet available for this package.
  - CVE check failed: a known high-severity CVE affects filelock 3.32.7, a direct dependency. A fixed version is available.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 34 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 84/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to anubabajide/fpl-mcp).
  - License check failed: no license is declared.
  - Actively maintained (last published 14 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2806 tokens (~116/item across 24 items; 24 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "fpl_make_transfers" implies "transfer" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Fantasy Premier League MCP server?

Fantasy Premier League runs locally as a PyPI package, launched with uvx fantasy-premier-league-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add anubabajide-fpl -- uvx fantasy-premier-league-mcp
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add anubabajide-fpl -- uvx fantasy-premier-league-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "anubabajide-fpl": {
      "type": "local",
      "command": [
        "uvx",
        "fantasy-premier-league-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add anubabajide-fpl --command uvx --arg fantasy-premier-league-mcp
```

### Hermes

```yaml
mcp_servers:
  anubabajide-fpl:
    command: "uvx"
    args: ["fantasy-premier-league-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "anubabajide-fpl": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "fantasy-premier-league-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add anubabajide-fpl -t stdio -c uvx -a fantasy-premier-league-mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 51, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-20 (score 66, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-15 (score 51, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-14 (score 66, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-13 (score 51, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-12 (score 66, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-11 (score 51, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-10 (score 66, +15)

- [security improvement] Malware scan: unverified → pass

## MCP tools (24)

### `fpl_setup` (~74 tokens)

Store your FPL team id (and optionally a default mini-league id) on disk.

Find your team id in the URL when viewing your team on the FPL site:
fantasy.premierleague.com/entry/<TEAM_ID>/event/1

Input parameters:

- `league_id`
- `team_id`

### `fpl_login` (~269 tokens)

Sign in to FPL. Needed only for lineup changes and transfers.

Opens FPL's own sign-in page in a browser window on the machine running this
server, and returns within `wait_seconds` while the user signs in there.
Password, two-factor and any bot check happen on FPL's page; no credentials
pass through this server. The session is saved automatically when they
finish, so there is no need to call this again: wait for the user to say
they are done, then confirm with `fpl_auth_status`.

If `status` is "awaiting_redirect_url", no window could be opened (or
\`open_browser` was false). Give the user `sign_in_url` to open in any
browser. After signing in they land on a page whose address starts with
https://fantasy.premierleague.com/?code= and should paste that address
back; call this again with it as `redirect_url` to finish.

Once signed in, the session renews itself without a browser. If already
signed in this returns straight away; `force=true` signs in afresh.

Input parameters:

- `force` (boolean)
- `open_browser` (boolean)
- `redirect_url`
- `wait_seconds` (integer)

### `fpl_logout` (~26 tokens)

Sign out: delete the saved session from this machine and revoke it at FPL.

### `fpl_auth_status` (~55 tokens)

Check whether you are signed in to FPL, renewing the session if needed.

Also reports progress of a sign-in started with `fpl_login`. Read-only tools
never need this; only lineup changes and transfers do.

### `fpl_set_token` (~104 tokens)

Last-resort fallback: use a bearer token copied by hand from DevTools.

Prefer `fpl_login`, including its sign-in link for machines that cannot open
a browser. A pasted token is the `X-Api-Authorization` header value from a
signed-in browser's DevTools Network tab, minus the leading `Bearer `. It
lasts about an hour, cannot renew itself, and is kept in memory only.

Input parameters:

- `token` (string, required)

### `fpl_my_squad` (~136 tokens)

Show your current squad: starting XI, bench, captain, value and bank.

With a valid token this reflects unsaved live state including selling prices,
free transfers remaining, and chip state. `free_transfers` is the number
still available this gameweek (FPL's `limit` minus transfers already made).
\`chips_available` lists chips still held; `active_chip` is the chip currently
playing, and `chips_playable_this_gw` is what can still be played now.

Without a token it falls back to your last confirmed squad.

Input parameters:

- `gameweek`
- `team_id`

### `fpl_season_summary` (~32 tokens)

Season overview for your team: points, rank movement, chips and transfers.

Input parameters:

- `team_id`

### `fpl_gameweek_report` (~54 tokens)

Break down how each of your players scored in a given gameweek.

Defaults to the current gameweek. Includes bench points, auto-subs and hits.

Input parameters:

- `gameweek`
- `team_id`

### `fpl_best_performers` (~85 tokens)

Rank the players in your own squad to see who is carrying the team.

Metrics: total_points, form, points_per_game, value, ict_index, xgi,
xgi_per_90, ep_next, minutes, goals, assists, bonus, defensive_contribution.

Input parameters:

- `limit` (integer)
- `metric`
- `team_id`

### `fpl_top_players` (~131 tokens)

Find the best performing players in the game, with optional filters.

Filter by position (GKP/DEF/MID/FWD), club, and price. Metrics are the same
set as `fpl_best_performers`. `sort_by` is accepted as an alias for
\`metric`, so either name works.

Input parameters:

- `available_only` (boolean)
- `limit` (integer)
- `max_price`
- `metric`
- `min_minutes` (integer)
- `min_price`
- `position`
- `sort_by`
- `team`

### `fpl_search_players` (~38 tokens)

Look up players by name to get their id, price and club.

Input parameters:

- `limit` (integer)
- `query` (string, required)

### `fpl_player` (~47 tokens)

Full detail on one player: season stats, upcoming fixtures and recent form.

\`player` accepts a name or an element id.

Input parameters:

- `horizon` (integer)
- `player` (required)

### `fpl_compare_players` (~35 tokens)

Compare two or more players side by side on the headline stats.

Input parameters:

- `metric`
- `players` (array, required)

### `fpl_fixture_ticker` (~52 tokens)

Rank clubs by how easy their next few fixtures are (lower is better).

Input parameters:

- `horizon` (integer)
- `limit` (integer)
- `start_gameweek`
- `teams`

### `fpl_differentials` (~182 tokens)

Find your differentials in both directions.

\`scope="global"` compares against ownership across all FPL managers.
\`scope="league"` compares against the top `rivals` teams in one mini-league,
which is what actually decides your rank in that league — it also reports
effective ownership, counting captaincy.

Returns `my_differentials` (high performers few rivals own — where you gain)
and `differentials_against_me` (high performers you are missing — where you
bleed rank, so it doubles as a transfer shortlist).

Input parameters:

- `high_ownership_min` (number)
- `league_id`
- `limit` (integer)
- `low_ownership_max` (number)
- `metric`
- `rivals` (integer)
- `scope` (string)
- `team_id`

### `fpl_league_standings` (~46 tokens)

Show a classic mini-league table and where you sit in it.

Input parameters:

- `league_id`
- `limit` (integer)
- `team_id`

### `fpl_export_players` (~228 tokens)

Dump the player pool for your own modelling, with a compact default.

Unlike `fpl_top_players` this does not rank, but it does page: the default
response is a compact field set so it fits in a tool result. Pass
\`fields="standard"` for the broad optimiser columns, or `fields="all"` for
every raw column (usually too large to return in one call).

\`fields` accepts "compact" (default), "standard", "all", or a
comma-separated list. Narrow with `ids`, `position`, `team`, price and
minutes filters, then use `offset`/`limit` to page. `format` is "csv"
(default, far more compact) or "json".

Input parameters:

- `available_only` (boolean)
- `fields`
- `format` (string)
- `ids`
- `limit`
- `max_price`
- `min_minutes` (integer)
- `min_price`
- `offset` (integer)
- `position`
- `team`

### `fpl_export_fixtures` (~95 tokens)

Every fixture over a horizon, one row per team per match, as CSV.

Join to the player export on `team_id` to build per-player, per-gameweek
projections. Blanks and doubles fall out of the shape: a team with no row
for a gameweek blanks it, two rows means a double gameweek.

Input parameters:

- `horizon` (integer)
- `start_gameweek`

### `fpl_export_gameweek_history` (~140 tokens)

Per-player, per-gameweek stats across a range of finished gameweeks, as CSV.

One row per player per gameweek: minutes, goals, assists, bonus, bps, the
expected-goals columns and points. This is the series to fit form decay,
home/away splits and minutes risk against, and to backtest on.

Only finished gameweeks have data. Before the season's first deadline this
returns nothing at all, because FPL publishes no per-gameweek data until
matches have been played.

Input parameters:

- `end_gameweek`
- `player_ids`
- `start_gameweek` (integer)

### `fpl_team_news` (~143 tokens)

Club-level news: manager, new signings, departures and injury flags.

Covers what changes a club's shape rather than one player's form. Managers
come from the Premier League's own backend; signings, departures and
injuries come from FPL's feed. Pass `team` for one club, or omit for all.

Managers are not an FPL asset this season, so a managerial change matters
indirectly — rotation, set-piece duty, formation — not as points.

Input parameters:

- `include_headlines` (boolean)
- `limit_headlines` (integer)
- `signed_within_days` (integer)
- `team`

### `fpl_predicted_lineups` (~137 tokens)

Predict each club's starting XI, or return the confirmed one if published.

No API anywhere publishes predicted lineups; they are editorial judgement.
This is a **derived heuristic** ranked on how often each player actually
started recent gameweeks, minutes per appearance, availability, set-piece
duty and price. Every pick shows its score breakdown, so you can disagree
with the weighting.

When the Premier League publishes real team lists - roughly an hour before
kickoff - those are returned instead, marked source="confirmed".

Input parameters:

- `gameweek`
- `recent_gameweeks` (integer)
- `team`

### `fpl_set_captain` (~82 tokens)

Change the captain (and optionally vice-captain), keeping the XI as-is.

Runs as a preview by default. Show the preview to the user and get their
agreement before calling again with dry_run=false.

Input parameters:

- `captain` (required)
- `dry_run` (boolean)
- `team_id`
- `vice_captain`

### `fpl_set_lineup` (~204 tokens)

Set your full starting XI, bench order, captain and vice-captain.

\`starting_xi` is 11 players and `bench_order` is the remaining 4 with the
substitute goalkeeper first, then outfielders in the order they should come
on. Names or element ids both work.

\`chip` plays a chip with this lineup: "bboost" (Bench Boost) or "3xc"
(Triple Captain). The response reports whether FPL confirmed the chip as
active. Wildcard and Free Hit are played through `fpl_make_transfers`.

Runs as a preview by default. Show the preview to the user and get their
agreement before calling again with dry_run=false.

Input parameters:

- `bench_order` (array, required)
- `captain` (required)
- `chip`
- `dry_run` (boolean)
- `starting_xi` (array, required)
- `team_id`
- `vice_captain` (required)

### `fpl_make_transfers` (~174 tokens)

Transfer players out of and into your squad.

Pass matching lists of names or element ids. `chip` may be "wildcard" or
"freehit" to play that chip with these transfers. Bench Boost and Triple
Captain are played through `fpl_set_lineup`, not here.

Runs as a preview by default, reporting the cost in points, the resulting
bank balance and any rule breaches. `points_hit` is the cost of these
transfers; `points_hit_total` is the whole gameweek's hit. Show that preview
to the user and get their agreement before calling again with dry_run=false.

Input parameters:

- `chip`
- `dry_run` (boolean)
- `players_in` (array, required)
- `players_out` (array, required)
- `team_id`

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp#diagnostics

## Score history

- 2026-11-21: 51
- 2026-11-20: 66
- 2026-11-19: 51
- 2026-11-18: 51
- 2026-11-17: 51
- 2026-11-16: 51
- 2026-11-15: 51
- 2026-11-14: 66
- 2026-11-13: 51
- 2026-11-12: 66
- 2026-11-11: 51
- 2026-11-10: 66
- 2026-11-09: 51
- 2026-11-08: 66
- 2026-11-07: 66
- 2026-11-06: 51

## Common questions

### What is the Fantasy Premier League MCP server?

Fantasy Premier League is an MCP server listed in the public MCP registry as io.github.anubabajide/fpl. Research and manage a Fantasy Premier League team from any MCP-capable agent. This page covers its PyPI package (fantasy-premier-league-mcp).

### Is the Fantasy Premier League MCP server safe to use?

Fantasy Premier League scores 51 out of 100 on VerifyMCP. We recorded 13 known advisories against it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Fantasy Premier League MCP server expose?

Fantasy Premier League exposes 24 tools: fpl_setup, fpl_login, fpl_logout, fpl_auth_status, fpl_set_token, and 19 more. Their descriptions and schemas cost roughly 2,569 tokens of context every time the server is loaded.

### Is the Fantasy Premier League MCP server still maintained?

Fantasy Premier League is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Fantasy Premier League MCP server?

VerifyMCP ran 14 checks on Fantasy Premier League, covering Known CVEs, Install scripts, Dependency health, Source repository and 10 more. 2 items could not be completed, a gap on our side rather than a finding about Fantasy Premier League: Malware scan and Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- PyPI project: https://pypi.org/project/fantasy-premier-league-mcp/
- Socket report: https://socket.dev/pypi/package/fantasy-premier-league-mcp
- Repository: https://github.com/anubabajide/fpl-mcp
- Changelog RSS feed: https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp.json
- HTML version of this page: https://verifymcp.io/servers/anubabajide-fpl/fantasy-premier-league-mcp
