explaingit

ananthmenon10/xfpl

★ 0GoAudience · developerComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

Read-only Go CLI for Fantasy Premier League that ranks captain picks, plans chips, and tracks live rank and effective ownership. Also runs as an MCP server.

Mindmap

mindmap
  root((xfpl))
    Inputs
      FPL API
      LiveFPL scrape
      Session cookie
    Outputs
      Captain ranking
      Chip plan
      Live rank
    Use Cases
      Pick captain
      Plan Wildcard
      Compare players
    Tech Stack
      Go
      MCP
      CLI

Things people build with this

USE CASE 1

Rank captain options for the upcoming gameweek from the terminal

USE CASE 2

Plan when to play Wildcard or Bench Boost against blank and double gameweeks

USE CASE 3

Wire the tool into Claude Desktop or Cursor as an MCP server

USE CASE 4

Compare two FPL players side by side before a transfer

Tech stack

GoMCPCLI

Getting it running

Difficulty · moderate Time to first run · 30min

Needs Go 1.26+ and a session cookie copied from the FPL website set as an environment variable.

Apache 2.0 permits commercial use, modification, and distribution with attribution and a notice of changes.

In plain English

xfpl is a command line tool for Fantasy Premier League, the popular soccer game where players pick a squad of real Premier League footballers and earn points based on how those players perform each week. The tool runs in a terminal and is read only, meaning it shows you information but does not make transfers or changes to your team. It combines data from the official Fantasy Premier League API with extra numbers scraped from a third party site called LiveFPL, including live overall rank, effective ownership, and price change tracking. The README highlights several commands. The captain command ranks players for the captain pick using a formula that mixes expected points, fixture difficulty, home or away, expected goal involvement per 90 minutes, minutes risk, and a multiplier for double gameweeks. The explain rank command breaks down which five players contributed most to a given manager's score in the current week. The chip plan command looks at the chips you still have, like Wildcard or Bench Boost, and matches them against blank or double gameweeks in the remaining fixtures. There are also commands to look up players by name, compare players side by side, and view past captain choices and live point breakdowns. Installation is described several ways. The recommended path is go install, which fetches and compiles the tool from source and requires Go version 1.26 or higher. There is also a Homebrew formula planned, a Node based installer called Printing Press that can install both the binary and an agent skill at once, and pre built downloads. Once installed, you set an environment variable called FANTASY_PREMIER_LEAGUE_SESSION_COOKIE with a cookie copied from the FPL website, then run xfpl doctor to check the setup. The tool also ships as an MCP server, meaning AI assistants like Claude Desktop, Cursor, and Claude Code can call its commands directly. There is a one click bundle file for Claude Desktop on Apple Silicon Macs and Windows, plus a manual JSON configuration option for other platforms. The README explains how to find your team ID from the FPL website URL and how to look up a friend's team ID by searching a shared league. The licence is Apache 2.0.

Copy-paste prompts

Prompt 1
Install xfpl with go install, set FANTASY_PREMIER_LEAGUE_SESSION_COOKIE, and run doctor to confirm setup
Prompt 2
Add xfpl as an MCP server in my Claude Desktop config on Apple Silicon using the one click bundle
Prompt 3
Write a shell script that runs xfpl captain every Friday and emails me the top three picks
Prompt 4
Show me how to call the xfpl chip plan command and pipe the output into a markdown report
Prompt 5
Use xfpl explain rank to find which five players drove my score this gameweek
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.