A Model Context Protocol (MCP) server that provides access to Fantasy Premier League (FPL) data and tools, enabling interaction with detailed player statistics, team information, and gameweek data in Claude Desktop and other MCP-compatible clients.

Installation

PyPI (Recommended)

pip install fpl-mcp

PyPI with development dependencies

pip install "fpl-mcp[dev]"

From GitHub

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

Clone and install locally

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

CLI command

fpl-mcp

Configuration

Claude Desktop (Python module)

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "python",
      "args": ["-m", "fpl_mcp"]
    }
  }
}

Claude Desktop (full path)

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

Available Tools

Tool	Description
get_gameweek_status	Get precise information about current, previous, and upcoming gameweeks
analyze_player_fixtures	Analyze upcoming matches for a player with difficulty ratings
get_blank_gameweeks	Get information about upcoming blank gameweeks
get_double_gameweeks	Get information about upcoming double gameweeks
analyze_players	Filter and analyze FPL players by multiple criteria
analyze_fixtures	Analyze upcoming matches for players, teams, or positions
compare_players	Compare multiple players across various metrics
check_fpl_authentication	Check if FPL authentication is working correctly
get_my_team	View your authorized team (requires authentication)
get_team	View any team with a specific ID (requires authentication)
get_manager_info	Get manager details (requires authentication)

Features

• Rich player data: Access detailed player statistics from the FPL API
• Team information: Get details about Premier League teams
• Gameweek data: View current and past gameweeks
• Player search: Find players by name or team
• Player comparison: Compare detailed statistics between any two players

Environment Variables

Optional

• FPL_EMAIL - Your Fantasy Premier League email for authentication
• FPL_PASSWORD - Your Fantasy Premier League password for authentication
• FPL_TEAM_ID - Your Fantasy Premier League team ID for authentication

Usage Examples

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

Show upcoming fixtures for [Team]

Notes

Supports Claude Desktop, Cursor, Windsurf, and other MCP-compatible desktop LLMs. Mobile versions are not currently supported. Requires Python 3.10 or higher. Authentication is optional but required for features like accessing your team. The FPL API is not officially documented and may change without warning.