Skip to main content
Glama
Sign In
fpl-mcp

fpl-mcp

by reecetwhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: fantrax-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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessOutdated data

Resources

Related MCP Connectors

Related MCP Servers

  • Fantasy Premier League MCP

    rishijatia
    A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that provides access to Fantasy Premier League data, allowing users to compare players, find team information, view gameweek data, and get FPL-related advice through Claude for Desktop and other MCP-compatible clients.
    23
    65 PyPI
    80
    MIT

  • fantrax-mcp

    joshwolf
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for Fantrax fantasy baseball that provides tools to read league info, rosters, standings, free agents, and related data.
    -

  • fpl-mcp

    mgphp
    A
    license
    A
    quality
    D
    maintenance
    An MCP server for Fantasy Premier League that allows querying gameweek info, player recommendations, squad management, and executing transfers via FPL's public API with optional cookie authentication.
    4
    7 npm
    1
    ISC

  • rag-nfl-analyst

    JustinUbes
    F
    license
    Not graded
    quality
    C
    maintenance
    MCP server for NFL fantasy football retrieval, providing access to NFL stats and Sleeper league data through retrieval-oriented tools.
    -