Fantasy Premier League MCP Server

Supported Platforms

• Claude Desktop
• Cursor
• Windsurf
• Other MCP Compatible Desktop LLMs

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)

pip install fpl-mcp
```\n\n### Option 1b: Install with Development Dependencies
```bash
pip install "fpl-mcp[dev]"
```\n\n### Option 2: Install from GitHub
```bash
pip install git+https://github.com/rishijatia/fantasy-pl-mcp.git
```\n\n### Option 3: Clone and Install Locally
```bash
git clone https://github.com/rishijatia/fantasy-pl-mcp.git
cd fantasy-pl-mcp
pip install -e .

Running the Server# 1. Using the CLI command

fpl-mcp
```\n\n### 2. Using the Python module
```bash
python -m fpl_mcp
```\n\n### 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)**
```json
{
  "mcpServers": {
    "fantasy-pl": {
      "command": "python",
      "args": ["-m", "fpl_mcp"]
    }
  }
}

Method 2: Using the installed command with full path (if installed with pip)

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "/full/path/to/your/venv/bin/fpl-mcp"
    }
  }
}

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"

License

This project is licensed under the MIT License - see the LICENSE file for details.