X402 Fpl API

What dohyung1/x402-fpl-api MCP server does

The dohyung1/x402-fpl-api MCP server exposes Fantasy Premier League analysis through MCP for use with Claude Desktop. It combines public FPL data with the team, league, and squad details needed for personalized recommendations.

A manager can ask for a complete team review, captain rankings, transfer suggestions, differential candidates, fixture assessments, price movement predictions, or live points status. League-focused tools inspect rivals and estimate league outcomes. The server also covers chip timing, hit decisions, player comparisons, and squad risks such as rotation or suspension concerns.

How it works

The server connects to the official FPL API, which is the same free public data source used by the FPL website. It runs on the local machine and communicates with Claude Desktop using MCP. Network requests go to the FPL API; the README states that no API keys or accounts are required.

Personalized features use identifiers supplied in prompts. A team ID can be found in the URL on the FPL website after opening the Points view. A league ID appears in a mini-league standings URL. The manager hub can determine information such as bank balance, free transfers, and available chips from the team data.

Setup and configuration

Python 3.12 or newer is required. The published package is installed with:

pip install fpl-intelligence

The package provides an automatic Claude Desktop setup command:

fpl-intelligence --setup

After setup, restart Claude Desktop and look for the fpl server in the MCP server menu. For a source checkout, the README uses git clone, uv sync, and a Claude Desktop configuration that runs mcp_server.py through uv run from the repository directory.

Tools and capabilities

The dohyung1/x402-fpl-api MCP server includes these documented tools:

• fpl_manager_hub for full team analysis
• captain_pick for five scored captain options
• transfer_suggestions for recommended incoming and outgoing players
• player_comparison for comparing two to four players
• is_hit_worth_it for evaluating a points hit across future gameweeks
• chip_strategy for selecting chip gameweeks, including predicted double gameweeks
• differential_finder for low-ownership players
• fixture_outlook for ranking upcoming fixture difficulty
• price_predictions for likely price rises and falls
• live_points for live scores, projected bonus, and auto-substitution scenarios
• rival_tracker for mini-league rival analysis
• league_analyzer for league win probabilities
• squad_scout for hidden-data scouting, set pieces, rotation, and suspension risks

Limitations and notes

The server depends on the availability of the official FPL API. The README notes that requests may receive 403 responses when browser-like request headers are not accepted, when a network or VPN blocks Premier League domains, or when Claude Desktop needs network access approval. The API may also be unavailable around deadlines or between seasons, particularly in June and July.

Use a numeric FPL team ID rather than a username. Claude Desktop is the client documented in the setup instructions; no compatibility claim is provided here for other MCP clients. The project is released under the MIT license.