How do I install the fantasy pl mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `FPL_REFRESH_TOKEN`, `FPL_TEAM_ID`, `FPL_OIDC_CLIENT_ID`, `FPL_TOKEN_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Fantasy Pl MCP Server

A Model Context Protocol (MCP) server that provides access to Fantasy Premier League (FPL) data and tools. This server allows you to interact with

Local serverstdioPython

What is the Fantasy Pl MCP Server?

A Model Context Protocol (MCP) server that provides access to Fantasy Premier League (FPL) data and tools. This server allows you to interact with FPL data in

What you get

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

Configuration and credentials

Python 3.10 or higher - Claude Desktop (for AI integration)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search_fpl_players	Search for players by name, with optional position and team filters
get_player_information	Get detailed information and gameweek history for a player
analyze_players	Filter and analyze FPL players based on multiple criteria
compare_players	Compare multiple players across various metrics
get_price_changes	Get players whose price rose or fell in the current gameweek
get_gameweek_status	Get precise information about current, previous, and next gameweeks
analyze_player_fixtures	Analyze upcoming fixtures for a player with difficulty ratings
analyze_fixtures	Analyze upcoming fixtures for players, teams, or positions
get_blank_gameweeks	Get information about upcoming blank gameweeks
get_double_gameweeks	Get information about upcoming double gameweeks
get_gameweek_live_scores	Live player points and stats while matches are being played
get_dream_team	The official highest-scoring XI for a gameweek
suggest_captain	Rank your squad by captain score with per-component reasoning
check_fpl_authentication	Check if FPL authentication is working correctly
update_fpl_credentials	Update your stored FPL credentials from within a chat
get_my_team	View your authenticated team (requires authentication)
get_my_current_team	View your current team for the active gameweek (requires authentication)
get_team	View any team with a specific ID (requires authentication)
get_manager	Get manager details for a specific team ID (requires authentication)
get_manager_info	Get manager details (requires authentication)
get_manager_transfer_history	Get a manager's full transfer history
get_league_standings	Get standings for a classic league (requires authentication)
get_league_analytics	Analyze a league's managers, ownership trends, and performance

How to install the Fantasy Pl MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.10 or higher - Claude Desktop (for AI integration)

Example prompts to try

“Use Fantasy Pl MCP to get gameweek status.”
“Use Fantasy Pl MCP to analyze player fixtures.”
“Use Fantasy Pl MCP to get blank gameweeks.”

Frequently asked questions

A Model Context Protocol (MCP) server that provides access to Fantasy Premier League (FPL) data and tools. This server allows you to interact with FPL data in Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.