Log inSubmit server
Fantasy Pl MCP logo

Fantasy Pl MCP

by rishijatia

Access Fantasy Premier League data, team details, player analysis, fixtures, live scores, leagues, and captain recommendations through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Fantasy Pl MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "rishijatia-fantasy-pl-mcp": {
      "command": "uvx",
      "args": [
        "fpl-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 23 tools correctly (25d ago).

Overview

The rishijatia/fantasy-pl-mcp MCP server connects MCP-compatible clients to Fantasy Premier League data and analysis features. It provides tools for player statistics, team and manager details, fixture difficulty, gameweek events, live scores, league analysis, and captain suggestions. Authenticated features use an FPL refresh token and can retrieve private team, transfer, and league information. Use it when an AI assistant needs structured FPL research or access to your own squad.

Use cases

  • Compare players across recent gameweeks
  • Analyze upcoming fixtures and blank or double gameweeks
  • Inspect an authenticated FPL squad and transfer state
  • Review league standings and manager transfer history
  • Rank squad players for captaincy

Key features

  • FPL player search and statistics
  • Player comparison and filtering
  • Fixture difficulty analysis
  • Live gameweek scores and dream teams
  • Authenticated team and manager data
  • League standings and analytics

Tools23

What Fantasy Pl MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · fpl-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars80Stargazers on the source repository.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed23Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Fantasy Pl MCP works

What rishijatia/fantasy-pl-mcp MCP server does

The rishijatia/fantasy-pl-mcp MCP server exposes Fantasy Premier League data through the Model Context Protocol. It is intended for MCP-compatible desktop clients such as Claude Desktop, Cursor, and Windsurf, and can also be run directly from Python for development or testing.

The server covers player discovery, statistics, historical gameweek data, prices, ownership, form, fixtures, teams, managers, leagues, and gameweek timing. It also includes tools for live gameweek scores, official dream teams, blank and double gameweeks, player comparisons, multi-criteria player analysis, and captain recommendations.

Unauthenticated data tools are useful for general FPL research. Private team and manager features require FPL authentication, including access to an authenticated squad, current transfer-page state, manager history, transfer history, and some league information.

How it works

The rishijatia/fantasy-pl-mcp MCP server runs as a Python package and communicates with the client over the MCP server configuration. It can be started with the fpl-mcp command or with python -m fpl_mcp. The repository also supports running the package from a Git checkout and testing it with MCP Inspector.

Tools accept structured inputs such as player names, player IDs, team IDs, league IDs, gameweek numbers, date ranges, limits, filters, and analysis modes. For example, player analysis can filter by position, club, price, points, ownership, and form, while fixture analysis can include blank and double gameweek information.

The package also declares read-only resources for player and team data, current and historical gameweeks, fixtures, and upcoming player fixtures. Prompt templates are provided for player analysis, transfer advice, team ratings, differential picks, and chip strategy.

Setup and configuration

Install Python 3.10 or newer, then install the package from PyPI, GitHub, or a local clone. Start it with fpl-mcp or python -m fpl_mcp. For Claude Desktop, configure the Python module or the full path to the installed executable; using an explicit path helps when the desktop application cannot find a virtual-environment command.

Authenticated features use an FPL OIDC refresh token rather than an email address and password. The fpl-mcp-config setup command provides an interactive credential setup flow. The server exchanges the refresh token for short-lived access tokens when calling the FPL API. check_fpl_authentication reports whether authentication works, and update_fpl_credentials can replace an expired refresh token and optionally update the stored team ID.

Tools and capabilities

The rishijatia/fantasy-pl-mcp MCP server includes tools for:

  • Searching players and retrieving detailed statistics, history, fixtures, prices, and ownership.
  • Filtering or comparing players across selected metrics and recent gameweeks.
  • Reviewing current, previous, and next gameweek status, including blank and double gameweeks.
  • Assessing upcoming fixtures for players, clubs, or positions with difficulty ratings.
  • Reading live points during a gameweek and retrieving the official dream team.
  • Inspecting authenticated teams, current transfer-page details, managers, transfers, and league standings.
  • Producing league analytics for overview, historical, composition, decision, and fixture analysis.
  • Ranking a squad for captaincy using expected points, form, points per game, and fixture difficulty.

Limitations and notes

Mobile use is not supported according to the project documentation. Team, manager, transfer, and private league operations depend on valid FPL authentication, while public analysis features do not require the authenticated team. Some requests use IDs, such as team, player, and league identifiers, while others accept names. The available data reflects the Fantasy Premier League API and its current gameweek state, so live results and transfer-page information can change during a gameweek.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Fantasy Pl MCP

rishijatia/fantasy-pl-mcp is an MCP server that connects AI clients to Fantasy Premier League data through tools for players, teams, managers, fixtures, gameweeks, leagues, live scores, and captain suggestions. Authenticated tools also access a user’s squad, transfer state, manager history, and private league information.

Install it with `pip install fpl-mcp`, then start it with `fpl-mcp` or `python -m fpl_mcp`. You can also install from GitHub or a local clone. Python 3.10 or newer is required.

Yes, rishijatia/fantasy-pl-mcp works with Cursor. Configure Cursor to launch the installed Python module or executable using its MCP server settings.

Authenticate with an FPL OIDC refresh token, not an email address and password. Run `fpl-mcp-config setup` to configure credentials, then use `check_fpl_authentication` to verify access. An expired token can be replaced with `update_fpl_credentials`.

Yes, it can identify upcoming blank and double gameweeks and include them in fixture analysis. Use `get_blank_gameweeks`, `get_double_gameweeks`, or the fixture analysis tools to inspect affected teams and upcoming schedules.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFantasy Pl MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rishijatia-fantasy-pl-mcp?style=directory)](https://allmcps.com/mcp/rishijatia-fantasy-pl-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/rishijatia-fantasy-pl-mcp"><img src="https://allmcps.com/api/badge/rishijatia-fantasy-pl-mcp?style=directory" alt="Fantasy Pl MCP on AllMCPs" /></a>