Skip to main content
Glama
reecetwhite

fpl-mcp

by reecetwhite
OverviewSchemaRelated ServersScoreDiscussions
Python

Features

  • Player Data — Search, filter, and compare players by stats, price, form, ownership

  • Team Analysis — View Premier League team info and strength ratings

  • Fixtures — Browse gameweek fixtures, team schedules, and FDR ratings

  • Your Team — Fetch your FPL squad (via manager ID or API token)

  • Differentials — Find low-ownership, high-form picks

  • Auto-caching — Data cached locally with manual refresh option

Related MCP server: football-api-mcp

Prerequisites

  • Python 3.11+

  • just (command runner)

Installation

git clone https://github.com/yourusername/fpl-mcp.git
cd fpl-mcp

just create-venv
just install

Configuration (optional)

Copy .env.example to .env to configure your manager ID:

cp .env.example .env
# Your FPL manager ID (from URL: fantasy.premierleague.com/entry/XXXXXX/...)
FPL_MANAGER_ID=123456

# Optional: API token for authenticated requests
FPL_API_TOKEN=

Client Setup

Claude Code

Add to ~/.claude/mcp_servers.json:

{
  "fpl-mcp": {
    "command": "/path/to/fpl-mcp/.venv/bin/python",
    "args": ["-m", "src.server"],
    "cwd": "/path/to/fpl-mcp",
    "env": {
      "FPL_MANAGER_ID": "123456"
    }
  }
}

Claude Desktop

Add to Claude Desktop config:

{
  "mcpServers": {
    "fpl-mcp": {
      "command": "/path/to/fpl-mcp/.venv/bin/python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/fpl-mcp",
      "env": {
        "FPL_MANAGER_ID": "123456"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "fpl-mcp": {
      "command": "/path/to/fpl-mcp/.venv/bin/python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/fpl-mcp",
      "env": {
        "FPL_MANAGER_ID": "123456"
      }
    }
  }
}

Usage

Command

Description

just info

Show project info

just run

Run the MCP server

just test

Run tests

just lint

Lint with ruff

just fmt

Format with ruff

Tools

Player Tools

Tool

Description

get_player

Get player info by ID

search_player

Search players by name (partial match)

filter_players

Filter by position, team, price, form, points, availability

get_top_players

Rank by metric: points, form, ppg, xG, xA, value

get_differentials

Find low-ownership picks with high form

compare_players

Side-by-side comparison of multiple players

Team Tools

Tool

Description

get_team

Get team info by ID

search_team

Search teams by name

get_all_teams

List all 20 PL teams sorted by strength

Fixture Tools

Tool

Description

get_gameweek_fixtures

All fixtures for a gameweek

get_team_fixtures

Team's fixtures (optionally by gameweek)

get_team_upcoming

Next N fixtures with FDR ratings

get_next_gameweeks

Overview of upcoming gameweeks

Manager Tools

Tool

Description

get_my_team

Fetch your current FPL squad

Utility

Tool

Description

refresh_cache

Force refresh cached FPL data

License

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/reecetwhite/fpl-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server