dohyung1/x402-fpl-api

Turn Claude into your FPL analyst. Captain picks, transfer advice, rival scouting, chip timing, league predictions — powered by real-time FPL data.
Quick Start
Step 1 — Install
Requires Python 3.12+.
Step 2 — Connect to Claude Desktop
Step 3 — Restart Claude Desktop
Quit (**Cmd+Q** on macOS) and reopen. Look for fpl under the MCP servers icon (hammer icon).
Step 4 — Ask Claude anything about FPL
> "Analyze my FPL team **5456980** — who should I captain, who should I transfer in, and when should I use my chips?"
That's it. Bank balance, free transfers, and chips are all auto-detected from your team ID.
Where's my team ID?
Go to fantasy.premierleague.com → click **Points** → grab the number from the URL:
Your league ID is in the mini-league URL:
12 Tools
| Tool | What it does |
|---|---|
| fpl_manager_hub | Full personalized analysis — captain, transfers, differentials, fixtures, price risks |
| captain_pick | Top 5 captain picks scored by form, xG, fixtures, and ICT index |
| transfer_suggestions | Who to bring in and ship out based on your squad and budget |
| player_comparison | Head-to-head compare 2-4 players across every metric |
| is_hit_worth_it | Should you take a -4? Projects net points over N gameweeks |
| chip_strategy | Optimal gameweek for each chip — factors in DGW predictions |
| differential_finder | Hidden gems outperforming their ownership |
| fixture_outlook | Teams ranked by upcoming fixture difficulty |
| price_predictions | Who's rising and falling tonight |
| live_points | Live score, projected bonus, auto-sub scenarios |
| rival_tracker | Spy on mini-league rivals — differentials, weaknesses, predicted moves |
| league_analyzer | Win probabilities for your league — who's the favourite and why |
| squad_scout | Deep scout using FPL's hidden data — ep_next, set pieces, suspension risks |
Example Prompts
How It Works
FPL Intelligence connects to the official FPL API — the same free, public data that powers the FPL website. All data is real-time. See the full FPL API reference on Postman for endpoint documentation.
The server runs locally on your machine and talks to Claude Desktop via MCP. No API keys, no accounts, no data leaves your machine except FPL API calls.
Install from Source
Then use the **full absolute path** to uv and the repo in your Claude Desktop config:
> Find your uv path with which uv (e.g. /Users/you/.cargo/bin/uv).
Troubleshooting
FPL API calls are blocked / 403 errors
The FPL API blocks requests that don't look like they come from a browser.
**Test if the API is reachable:**
Returns 200? The API works — the issue is likely Claude Desktop's sandbox (see below). Returns 403? Your network is blocking it.
**Claude Desktop sandbox:** Claude Desktop may prompt you to approve network access to fantasy.premierleague.com. If you dismissed this, restart Claude Desktop and watch for the prompt. Check logs at ~/Library/Logs/Claude/ (macOS).