README.md
Turn Claude into your FPL analyst.
FPL Intelligence — MCP Server
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+.
pip install fpl-intelligence
Step 2 — Connect to Claude Desktop
fpl-intelligence --setup
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:
https://fantasy.premierleague.com/entry/YOUR_TEAM_ID/event/30
Your league ID is in the mini-league URL:
https://fantasy.premierleague.com/leagues/YOUR_LEAGUE_ID/standings/c
14 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 |
community_consensus |
What are FPL YouTubers saying? Captain picks, transfers, and chip advice from top creators |
Example Prompts
"Give me the full breakdown on team 5456980 — captain, transfers, everything"
"I have 2 free transfers and 1.5m in the bank. Who should I bring in?"
"Salah vs Palmer vs Saka — who's the best pick for the next 5 gameweeks?"
"I want to bring in Haaland for a -4. Is it worth the hit?"
"I still have my bench boost and triple captain. When should I use them?"
"Find me some differentials under 3% ownership that are actually returning points"
"It's 60 minutes into the games — how's my team doing? Any auto-subs?"
"Show me everything about mini-league 1189955 — who's going to win?"
"How do I beat my rivals in league 1189955? I'm team 5456980"
"Which players are about to drop in price tonight? I need to sell before the deadline"
"What are FPL YouTubers saying about this gameweek? Who are they captaining?"
"Get the community consensus on transfers — who are the experts bringing in?"
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
git clone https://github.com/dohyung1/x402-fpl-api.git
cd x402-fpl-api
uv sync
Then use the full absolute path to uv and the repo in your Claude Desktop config:
{
"mcpServers": {
"fpl": {
"command": "/full/path/to/uv",
"args": ["run", "--directory", "/full/path/to/x402-fpl-api", "mcp_server.py"]
}
}
}
Find your
uvpa
Tools (14)
fpl_manager_hubFull personalized analysis including captain, transfers, differentials, fixtures, and price risks.captain_pickTop 5 captain picks scored by form, xG, fixtures, and ICT index.transfer_suggestionsWho to bring in and ship out based on your squad and budget.player_comparisonHead-to-head compare 2-4 players across every metric.is_hit_worth_itProjects net points over N gameweeks to determine if a transfer hit is worth it.chip_strategyOptimal gameweek for each chip, factoring in DGW predictions.differential_finderFinds hidden gems outperforming their ownership.fixture_outlookTeams ranked by upcoming fixture difficulty.price_predictionsIdentifies players rising and falling in price.live_pointsProvides live scores, projected bonus, and auto-sub scenarios.rival_trackerAnalyzes mini-league rivals including differentials, weaknesses, and predicted moves.league_analyzerCalculates win probabilities for your league.squad_scoutDeep scout using FPL data like ep_next, set pieces, and suspension risks.community_consensusAggregates captain picks, transfers, and chip advice from top FPL creators.Configuration
claude_desktop_config.json
{"mcpServers": {"fpl": {"command": "/full/path/to/uv", "args": ["run", "--directory", "/full/path/to/x402-fpl-api", "mcp_server.py"]}}}Try it
→Analyze my FPL team 5456980 — who should I captain, who should I transfer in, and when should I use my chips?
→Salah vs Palmer vs Saka — who's the best pick for the next 5 gameweeks?
→I want to bring in Haaland for a -4. Is it worth the hit?
→Find me some differentials under 3% ownership that are actually returning points
→How do I beat my rivals in league 1189955? I'm team 5456980