Fantasy Premier League

You deploy and run the Fantasy Premier League MCP Server to access FPL data and analysis tools from MCP-compatible clients like Claude Desktop. This server provides rich player data, team information, gameweek details, and handy comparison capabilities, enabling you to ask natural language questions and receive structured, actionable results.

How to use

Start the server using one of the supported methods, then connect your MCP client to the local or remote endpoint. Once running, you can ask questions like “Compare Mohamed Salah and Erling Haaland over the last 5 gameweeks” or “Show me the top 5 forwards by points.” Use the hammer or command prompts in your MCP client to access FPL data through the server’s capabilities.

How to install

Prerequisites you need before installation:

• Python 3.10 or higher

• Internet access to install packages

Install from PyPI (Recommended)

pip install fpl-mcp

Install with development dependencies

pip install "fpl-mcp[dev]"

Install 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 .

Run the server

After installation, you can start the server in several ways:

fpl-mcp

python -m fpl_mcp

Configure Claude Desktop to connect to the running MCP server by adding one of the following configurations in your MCP setup.

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

Claude Desktop integration with full path

If you installed the package in a virtual environment, you can point Claude Desktop to the full path of the executable to avoid PATH issues.

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

Authentication and credentials

Some features require authentication to access private data. Set up your FPL credentials with a built-in tool or environment configuration as shown.

Using with Claude Desktop tips

• Use specific player names for accurate results, and include positions when searching (FWD, MID, DEF, GK). - For captain advice, consider form, fixtures, and underlying stats.

MCP Inspector for development

# If you have mcp[cli] installed
mcp dev -m fpl_mcp

# Or use npx
npx @modelcontextprotocol/inspector python -m fpl_mcp

Configuration and endpoints

The server exposes a set of endpoints and resources to fetch player data, teams, gameweeks, fixtures, and perform analyses.

Troubleshooting common issues

If the server cannot be found by Claude Desktop, ensure you are using an absolute path to the executable in your config. If the server disconnects immediately, check logs and dependencies, and try starting the server manually to surface errors.

Available resources and tools

The server provides a range of tools to analyze and compare players, fixtures, and team data. Examples include getting gameweek status, analyzing players and fixtures, comparing players, and checking authentication status.

Notes on data and limitations

The data comes from the Fantasy Premier League data sources, and some aspects may change if the upstream data source updates its API.

Security and credentials best practices

Store credentials securely in your environment or in a local config store. Use the recommended setup tools to avoid exposing sensitive information in plain text.

Additional notes

This server supports multiple MCP clients and can be extended with additional tools and resources as needed.

Available tools

get_gameweek_status

Retrieve precise information about the current, previous, and next gameweeks.

analyze_player_fixtures

Analyze upcoming fixtures for a player with difficulty ratings.

get_blank_gameweeks

Provide information about upcoming blank gameweeks.

get_double_gameweeks

Provide information about upcoming double gameweeks.

analyze_players

Filter and analyze FPL players based on multiple criteria.

analyze_fixtures

Analyze upcoming fixtures for players, teams, or positions.

compare_players

Compare multiple players across various metrics.

check_fpl_authentication

Verify that FPL authentication is functioning correctly.

get_my_team

View your authenticated team (requires authentication).

get_team

View any team with a specific ID (requires authentication).

get_manager_info

Get manager details (requires authentication).