mcp-fpl
Provides tools for accessing Fantasy Premier League and Premier League data via the public FPL API, including fixtures with difficulty ratings, live scores and events, team and player details, mini-league standings, league history, squad information, and in-league player ownership.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-fpl
Fantasy Premier League tools as an MCP server — for classic FPL and FPL Draft — plus a small page where members of your leagues get their own API key, already linked to their team(s). Data comes live from the keyless public FPL and FPL Draft APIs.
Tool | |
| gameweek schedule with FDR difficulty and kickoff times |
| live scores, events, and how your players are doing right now |
| Premier League teams and strength ratings |
| any player: price, form, ownership, availability, next fixtures |
| your picked squad for a gameweek (Draft: XI + bench, points, auto subs) |
| your classic and/or Draft mini-leagues |
| a mini-league table (Draft H2H: plus the gameweek's matches) |
| how standings/squads in a classic league changed over time (needs Postgres + |
| your squad vs. the rest of a mini-league in one call: shared players, differentials, captains (Draft: squads side by side) |
| who has a player — or a list of players — in a mini-league (Draft: the owner, or that he is free) |
| most-owned / most-captained players in a classic mini-league |
| Draft: best unowned players (waiver / free-agent targets) |
| Draft: waivers and free-agent moves, trades, draft picks |
| your key's client and default teams/leagues |
| admin-only: listed and callable only for keys with |
Endpoints: /mcp (key in header) or /mcp/<key>, /join; the longer /mcp/fpl[/<key>]
and /mcp/join keep working.
"My" team and league come from the caller's key: fpl: {entry_id, league_id} (classic)
and/or fpl: {draft_entry_id, draft_league_id} (Draft) in the clients file, or the team(s) a
/join key was issued for. An explicit entry_id / league_id argument always wins. There is
no server-wide default, so nobody gets someone else's team by accident.
Classic vs Draft are separate games with separate ids. The tools that serve both take
game="classic"|"draft"; without it they use the one game the key is linked to, and a key
linked to both asks for it. Player ids differ between the two APIs for some players, so they
are matched on the player's code.
Part of the Jarvis tool servers; built on jarvis-mcp-kit (API keys, rate limits, logs).
Self-service keys — /join
Members of the leagues in FPL_LEAGUES (classic) and FPL_DRAFT_LEAGUES (Draft) open
https://<host>/join and enter their team — classic, Draft or both, in two separate fields —
as the team's id or its exact name (case-insensitive; no partial matches, no candidate lists).
They get one key linked to those teams, with setup for Claude, ChatGPT, the OpenAI API, Cursor,
VS Code, Gemini CLI and self-hosted assistants.
One key per team: a team that already has a key gets none, and the page answers that with the
same message as an unknown team, so it never reveals which teams are taken. A lost key is
replaced after the admin revokes it (admin tool revoke_issued_key or
mcp-fpl keys revoke <entry_id> [--draft]; list with mcp-fpl keys list). No proof of
ownership (league tables are public) — instead: 10 attempts per IP per hour and a notification
for every key to JOIN_NOTIFY_WEBHOOK_URL.
Related MCP server: mcp-fleaflicker
Storage and jobs
With DATABASE_URL (its own Postgres database and login) the server caches reference data and
league squad scans, keeps a permanent daily league history, stores issued keys, and logs every
tool call to fpl_tool_calls (client, tool, arguments, outcome, error, duration, result size,
server version — not the results, and never the users' conversations, which the server does
not see) to show how the tools are used and where they fail. Without it
caches stay in memory, history is unavailable and keys go to $MCP_FPL_DATA_DIR/keys.json.
mcp-fpl collect # today's league snapshot for every league in FPL_LEAGUES (cron 04:00)
mcp-fpl warm-cache # refresh the current gameweek's squad scans (every few hours)
mcp-fpl backfill # rebuild per-gameweek history from the FPL API (once, after deploy)
mcp-fpl calls --days 7 # tool-call log: calls, clients, failures and timing per toolLogged calls are kept for good; with MCP_CALL_LOG_DAYS set, collect deletes older ones.
Run
cp .env.example .env # FPL_LEAGUES, DATABASE_URL, MCP_PUBLIC_URL, …
cp config/clients.example.yaml config/clients.yaml
uv run jarvis-mcp-keys new me --servers fpl --set fpl.entry_id=1234567 --set fpl.league_id=765432
uv run --env-file .env mcp-fpl serve # http://localhost:8010/mcp, /joinKubernetes: deploy/kubernetes.yaml is a generic example (Deployment, Service, CronJobs,
Ingress); give the server its own hostname and expose /mcp and /join.
Connect
Claude app (custom connector): easiest via
/join; or URLhttps://<host>/mcp/jvk_…Claude Code:
claude mcp add --transport http fpl https://<host>/mcp --header "Authorization: Bearer jvk_…"Jarvis: an entry in its
config/subagents.yaml.
Variable | |
| classic leagues to collect/warm and to accept on |
| FPL Draft leagues to accept on |
| Postgres for caches, history, issued keys |
| base URL shown on the join page |
| where to POST |
| join page switches |
| cache freshness |
| tool-call log on/off (default on with a database) and optional retention in days (default: keep all) |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Fantasy Premier League predictions, fixture difficulty, team news and your own FPL team and leagues.
FPL data, points predictions, and transfer, captain and chip advice for any team.
Your Fantasy Premier League team in your AI: analyses, injuries, prices, fixtures and player cards.
Fantasy Premier League tools: rate a team, captains, player points, fixtures, injuries. No login.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Fantasy Premier League data through natural language queries. Supports retrieving fixtures, league standings, player performance, and other FPL statistics via the official FPL API.1613 npm3MIT
- AlicenseNot gradedqualityBmaintenanceEnables reading and scoring Fleaflicker fantasy football leagues, including rosters, standings, matchups, boxscores, draft boards, and stat line scoring using league-specific rules, with no authentication required.MIT
- AlicenseNot gradedqualityDmaintenanceProvides tools and resources to interact with the Fantasy Premier League API, enabling player analysis, fixture insights, and team management through natural language.63 npmMIT
- AlicenseAqualityDmaintenanceExposes Fantasy Premier League player price predictions, live league standings, and transfer trend data via MCP tools, using LiveFPL's public endpoints without authentication.9MIT