Skip to main content
Glama
FPL MCP Server

FPL MCP Server

by owen-lacey

FPL MCP Server

A Model Context Protocol (MCP) server for the Fantasy Premier League API.

Installation

npm install -g fpl-mcp

Install from Source

git clone https://github.com/owen-lacey/fpl-mcp.git
cd fpl-mcp
npm install
npm run build

Related MCP server: Fantasy Premier League MCP Server

Quick Start

Using with Claude Desktop

If installed via NPM, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "fpl-api": {
      "command": "npx",
      "args": ["fpl-mcp@latest"]
    }
  }
}

If installed from source, use:

{
  "mcpServers": {
    "fpl-api": {
      "command": "node",
      "args": ["/path/to/fpl-mcp/build/src/server.js"]
    }
  }
}

Inspect the MCP tools

Use the Model Inspector to explore available tools:

npx @modelcontextprotocol/inspector npx fpl-mcp

Usage Example

You can connect this MCP server to Claude Desktop and interact with FPL data using natural language.

Screenshot of Claude Desktop using FPL MCP server


Endpoints Supported

See docs/fpl-api-cheatsheet.md for all FPL API endpoints exposed as MCP tools.


Example Prompts

Use these prompts to interact with the MCP server via your LLM:

  • "Show me the fixtures for gameweek 5."

  • "How am I doing in my private leagues (team id is 12345)?"

  • "How did mo salah get on in GW1?"

You can ask natural language questions about any supported endpoint. The LLM will use the appropriate MCP tool to fetch the data.


Development

Publishing to npm

This repository includes a GitHub Actions workflow that automatically publishes to npm when the version number in package.json changes.

Setup

  1. Create an npm access token:

    • Log in to npmjs.com

    • Go to Access Tokens in your account settings

    • Generate a new "Automation" token

  2. Add the token to GitHub Secrets:

    • Go to your repository Settings > Secrets and variables > Actions

    • Create a new secret named NPM_TOKEN

    • Paste your npm token as the value

  3. Publish a new version:

    • Update the version in package.json (e.g., 1.0.1 → 1.0.2)

    • Commit and push to the main branch

    • The workflow will automatically build and publish to npm

    • A git tag (e.g., v1.0.2) will be created automatically


License

MIT

Available Tools

16 tools
getBestClassicPrivateLeaguesGet Best Classic Private LeaguesB

Fetch list of best classic private leagues

Inputs: no named parameters.

getChipDataGet Chip DataC

Fetch all chip data

Inputs: no named parameters.

getElementSummaryGet Element SummaryC

Fetch details for a specific player (element)

Inputs: elementId (required).

getEntryGet EntryC

Fetch general info about a team by entry ID

Inputs: entryId (required).

getEntryHistoryGet Entry HistoryC

Fetch this and previous season performance of a team

Inputs: entryId (required).

getEntryPicksGet Entry PicksC

Fetch squad picks of a team for a specific week

Inputs: entryId (required), gw (required).

getEntryTransfersGet Entry TransfersC

Fetch all transfers of a team

Inputs: entryId (required).

getFixturesGet FixturesB

Fetch all FPL fixtures

Inputs: no named parameters.

getFixturesForGameweekGet Fixtures For GameweekC

Fetch fixtures for a specific gameweek

Inputs: gw (required).

getGameweekDataGet Gameweek DataB

Fetch all gameweek data

Inputs: no named parameters.

getLeagueStandingsGet League StandingsD

Fetch information about a league by ID

Inputs: leagueId (required).

getLeagueStandingsPageGet League Standings PageB

Fetch a page of league standings for leagues with more than 50 teams

Inputs: leagueId (required), page (required).

getLiveEventGet Live EventB

Fetch focused live stats for a gameweek. Optionally filter to specific players by providing elementIds array.

Inputs: gw (required), elementIds.

getPlayerDataGet Player DataB

Fetch all player data

Inputs: no named parameters.

getRegionsGet RegionsB

Fetch FPL region list

Inputs: no named parameters.

getTeamDataGet Team DataC

Fetch all team data

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific FPL resources like leagues, players, teams, fixtures, or gameweeks, with no overlap in functionality. The descriptions precisely indicate what each tool fetches, making it easy for an agent to select the correct one without confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern starting with 'get' followed by a descriptive noun phrase (e.g., getElementSummary, getFixturesForGameweek), with no deviations in style or convention. This predictability enhances usability and clarity across the entire set.

    Tool Count5/5

    With 16 tools, the server is well-scoped for the FPL domain, covering a comprehensive range of data points from player details to league standings without being excessive. Each tool serves a specific, necessary function, making the count appropriate for thorough data retrieval in fantasy football.

    Completeness5/5

    The tool set provides complete coverage for fetching FPL data, including CRUD-like operations for players, teams, leagues, fixtures, and gameweeks, with no obvious gaps. It supports both general queries (e.g., getPlayerData) and specific ones (e.g., getElementSummary), ensuring agents can access all needed information without dead ends.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects LLMs to the Fantasy Premier League API for intelligent team management, enabling natural language player research, competitor analysis, transfer decisions, and strategic planning using friendly names instead of IDs.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to analyze Fantasy Premier League data, providing tools for player search, fixture analysis, manager comparisons, and strategy prompts for transfer planning and lineup selection.
      19
      36 PyPI
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language querying of football/soccer data via the API-Football service, providing access to leagues, teams, players, fixtures, standings, and statistics.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools and resources to interact with the Fantasy Premier League API, enabling player analysis, fixture insights, and team management through natural language.
      63 npm
      MIT