Fantasy Premier League MCP Server

SportsPython

Access and analyze Fantasy Premier League data

Available Tools

get_player

Get detailed information about a specific player by name or ID

player_name_or_id

search_players

Search for players by name, team, position, or other criteria

querylimit

compare_players

Compare statistics between two players

player1_name_or_idplayer2_name_or_id

get_team

Get information about a Premier League team

team_name_or_id

get_gameweek

Get data for a specific gameweek

gameweek_number

get_league

Get information about a specific FPL league

league_idlimit

get_manager

Get information about a specific FPL manager

manager_id

The Fantasy Premier League MCP provides comprehensive access to FPL data and statistics through a Model Context Protocol server. It allows users to retrieve detailed player information, team statistics, gameweek data, and perform advanced analysis on Fantasy Premier League data directly within Claude Desktop and other MCP-compatible clients. With this MCP, users can search for players, compare player statistics, analyze league standings, and get insights into team performance - all without leaving their AI assistant interface. It's an essential tool for FPL managers looking to make data-driven decisions for their fantasy teams.

Overview

The Fantasy Premier League MCP server provides access to comprehensive FPL data and analysis tools directly within your AI assistant. This integration allows you to query player statistics, team information, gameweek data, and perform detailed comparisons without switching between applications.

Installation

Prerequisites

Python 3.10 or higher
Claude Desktop or another MCP-compatible client

Installation Methods

Method 1: Install from PyPI (Recommended)

pip install fpl-mcp

Method 2: Install with Development Dependencies

pip install "fpl-mcp[dev]"

Method 3: Install from GitHub

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

Method 4: 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 can run the server using one of these methods:

Using the CLI command

fpl-mcp

Using the Python module

python -m fpl_mcp

Configuring with Claude Desktop

Open Claude Desktop
Go to Settings > Model Context Protocol
Add the Fantasy Premier League MCP server configuration
Save and restart Claude Desktop if necessary

Usage Examples

Once the server is running and configured with your AI assistant, you can ask questions like:

"Show me the top 10 players by total points this season"
"Compare Mohamed Salah and Erling Haaland's statistics"
"What are the upcoming fixtures for Arsenal?"
"Who are the best value midfielders under 7.0m?"
"Show me the players with the most goals in the current season"
"Which defenders have the most clean sheets?"

The MCP server will retrieve the relevant data from the FPL API and present it in a structured format through your AI assistant.

Troubleshooting

If you encounter issues:

Ensure you have Python 3.10+ installed
Verify the server is running (you should see a message indicating it's running on a specific port)
Check your MCP client configuration to ensure it's pointing to the correct server address
Restart both the server and your MCP client if necessary

For more detailed help, visit the GitHub repository.