rishijatia/fantasy-pl-mcp

A Model Context Protocol (MCP) server that provides access to Fantasy Premier League (FPL) data and tools. This server allows you to interact with FPL data in Claude for Desktop and other MCP-compatible clients.
*Demo of the Fantasy Premier League MCP Server in action*
Supported Platforms
- Claude Desktop
- Cursor
- Windsurf
- Other MCP Compatible Desktop LLMs
Mobile is currently not supported.
Features
- **Rich Player Data**: Access comprehensive player statistics from the FPL API
- **Team Information**: Get details about Premier League teams
- **Gameweek Data**: View current and past gameweek information
- **Player Search**: Find players by name or team
- **Player Comparison**: Compare detailed statistics between any two players
Requirements
- Python 3.10 or higher
- Claude Desktop (for AI integration)
Installation
Option 1: Install from PyPI (Recommended)
Option 1b: Install with Development Dependencies
Option 2: Install from GitHub
Option 3: Clone and Install Locally
Running the Server
After installation, you have several options to run the server:
1. Using the CLI command
2. Using the Python module
3. Using with Claude Desktop
Configure Claude Desktop to use the installed package by editing your claude_desktop_config.json file:
**Method 1: Using the Python module directly (most reliable)**
**Method 2: Using the installed command with full path (if installed with pip)**
Replace /full/path/to/your/venv/bin/fpl-mcp with the actual path to the executable. You can find this by running which fpl-mcp in your terminal after activating your virtual environment.
> **Note:** Using just "command": "fpl-mcp" may result in a spawn fpl-mcp ENOENT error since Claude Desktop might not have access to your virtual environment's PATH. Using the full path or the Python module approach helps avoid this issue.
Usage
In Claude for Desktop
1. Start Claude for Desktop
2. You should see FPL tools available via the hammer icon
3. Example queries:
- "Compare Mohamed Salah and Erling Haaland over the last 5 gameweeks"
- "Find all Arsenal midfielders"
- "What's the current gameweek status?"
- "Show me the top 5 forwards by points"
Fantasy-PL MCP Usage Instructions
Basic Commands:
- Compare players: "Compare [Player1] and [Player2]"
- Find players: "Find players from [Team]" or "Search for [Player Name]"
- Fixture difficulty: "Show upcoming fixtures for [Team]"
- Captain advice: "Who should I captain between [Player1] and [Player2]?"
Advanced Features:
- Statistical analysis: "Compare underlying stats for [Player1] and [Player2]"
- Form check: "Show me players in form right now"
- Differential picks: "Suggest differentials under 10% ownership"
- Team optimization: "Rate my team and suggest transfers"
Tips:
- Be specific with player names for accurate results
- Include positions when searching (FWD, MID, DEF, GK)
- For best captain advice, ask about form, fixtures, and underlying stats
- Request comparison of specific metrics (xG, shots in box, etc.
MCP Inspector for Development
For development and testing:
Available Resources
- fpl://static/players - All player data with comprehensive statistics
- fpl://static/players/{name} - Player data by name search
- fpl://static/teams - All Premier League teams
- fpl://static/teams/{name} - Team data by name search
- fpl://gameweeks/current - Current gameweek data
- fpl://gameweeks/all - All gameweeks data
- fpl://fixtures - All fixtures for the current season
- fpl://fixtures/gameweek/{gameweek_id} - Fixtures for a specific gameweek
- fpl://fixtures/team/{team_name} - Fixtures for a specific team
- fpl://players/{player_name}/fixtures - Upcoming fixtures for a specific player
- fpl://gameweeks/blank - Information about upcoming blank gameweeks
- fpl://gameweeks/double - Information about upcoming double gameweeks