fpl-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fpl-mcpshow me the top 10 players by total points"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Features
Player Data — Search, filter, and compare players by stats, price, form, ownership
Team Analysis — View Premier League team info and strength ratings
Fixtures — Browse gameweek fixtures, team schedules, and FDR ratings
Your Team — Fetch your FPL squad (via manager ID or API token)
Differentials — Find low-ownership, high-form picks
Auto-caching — Data cached locally with manual refresh option
Related MCP server: fantrax-mcp
Prerequisites
Python 3.11+
just (command runner)
Installation
git clone https://github.com/yourusername/fpl-mcp.git
cd fpl-mcp
just create-venv
just installConfiguration (optional)
Copy .env.example to .env to configure your manager ID:
cp .env.example .env# Your FPL manager ID (from URL: fantasy.premierleague.com/entry/XXXXXX/...)
FPL_MANAGER_ID=123456
# Optional: API token for authenticated requests
FPL_API_TOKEN=Client Setup
Claude Code
Add to ~/.claude/mcp_servers.json:
{
"fpl-mcp": {
"command": "/path/to/fpl-mcp/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/fpl-mcp",
"env": {
"FPL_MANAGER_ID": "123456"
}
}
}Claude Desktop
Add to Claude Desktop config:
{
"mcpServers": {
"fpl-mcp": {
"command": "/path/to/fpl-mcp/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/fpl-mcp",
"env": {
"FPL_MANAGER_ID": "123456"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:
{
"mcpServers": {
"fpl-mcp": {
"command": "/path/to/fpl-mcp/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/fpl-mcp",
"env": {
"FPL_MANAGER_ID": "123456"
}
}
}
}Usage
Command | Description |
| Show project info |
| Run the MCP server |
| Run tests |
| Lint with ruff |
| Format with ruff |
Tools
Player Tools
Tool | Description |
| Get player info by ID |
| Search players by name (partial match) |
| Filter by position, team, price, form, points, availability |
| Rank by metric: points, form, ppg, xG, xA, value |
| Find low-ownership picks with high form |
| Side-by-side comparison of multiple players |
Team Tools
Tool | Description |
| Get team info by ID |
| Search teams by name |
| List all 20 PL teams sorted by strength |
Fixture Tools
Tool | Description |
| All fixtures for a gameweek |
| Team's fixtures (optionally by gameweek) |
| Next N fixtures with FDR ratings |
| Overview of upcoming gameweeks |
Manager Tools
Tool | Description |
| Fetch your current FPL squad |
Utility
Tool | Description |
| Force refresh cached FPL data |
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
OpenLigaDB MCP — community-run, keyless football / soccer match data.
MCP server exposing live Helldivers 2 galactic war data.
Related MCP Servers
- AlicenseBqualityAmaintenanceA Model Context Protocol server that provides access to Fantasy Premier League data, allowing users to compare players, find team information, view gameweek data, and get FPL-related advice through Claude for Desktop and other MCP-compatible clients.23123 PyPI80MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for Fantrax fantasy baseball that provides tools to read league info, rosters, standings, free agents, and related data.-
- AlicenseAqualityCmaintenanceAn MCP server for Fantasy Premier League that allows querying gameweek info, player recommendations, squad management, and executing transfers via FPL's public API with optional cookie authentication.412 npm1ISC
- FlicenseNot gradedqualityCmaintenanceMCP server for NFL fantasy football retrieval, providing access to NFL stats and Sleeper league data through retrieval-oriented tools.-