Fantasy Premier League MCP Server

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)

pip install fpl-mcp

Option 1b: Install with Development Dependencies

pip install "fpl-mcp[dev]"

Option 2: Install from GitHub

pip install git+https://github.com/rishijatia/fantasy-pl-mcp.git

Option 3: Clone and Install Locally

git clone https://github.com/rishijatia/fantasy-pl-mcp.git
cd fantasy-pl-mcp
pip install -e .

Running the Server

After installation, you have several options to run the server:

1. Using the CLI command

fpl-mcp

2. Using the Python module

python -m fpl_mcp

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)

{
  "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"
    }
  }
}

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 "Sear

... View full README on GitHub