FPL MCP

Verwalte deine Fantasy-Premier-League-Mannschaft mit KI. Ein MCP- Server, der es einem LLM-Client wie Claude ermöglicht, dein FPL-Team auszulesen, Spieler und Spielpläne zu analysieren, Transfers vorzuschlagen, deine Miniliga-Rivalen auszuspionieren und tatsächlich Transfers zu tätigen, deinen Kapitän festzulegen und Chips zu spielen – alles über Chat in natürlicher Sprache.

⚠️ Inoffiziell. Weder mit der Premier League verbunden, noch von ihr unterstützt oder mit ihr in Verbindung stehend. Nutzt die öffentliche FPL-API. Läuft vollständig auf deinem eigenen Rechner – dein Sitzungstoken verlässt nie deinen Computer, und dein Passwort wird von diesem Tool oder dem Modell nie gesehen.

Demo

Ein Satz, mehrere Aktionen – ein Transfer, ein Kapitänswechsel und ein Aufstellungswechsel, alles im echten Team ausgeführt:

"Verkaufe João Pedro, hole Havertz, mache Haaland zum Kapitän und stelle Yates für Le Fée in die Startelf"

Related MCP server: FPL MCP Server

Was es anders macht

Die meisten FPL-Tools können Daten nur lesen und geben Ratschläge, die du dann von Hand umsetzt. Dieses hier:

• Verwaltet dein Team tatsächlich – Transfers, Kapitänswahl, Aufstellung und Chips werden real ausgeführt.

• Meldet dich an, ohne jemals dein Passwort zu berühren – ein echter Browser öffnet sich, du meldest dich auf der offiziellen FPL-Seite an, und nur das Sitzungstoken wird erfasst.

• Spioniert deine Miniliga aus – die Kader der Rivalen sind öffentlich, also berechnet es die Eigentumsverhältnisse innerhalb deiner Liga und verrät dir deinen Vorteil und die Gefahren.

• Schlägt Transfers mit einem positionsbewussten Modell vor – drei Strategien: beste Punkte, sichere Standardwahlen oder Differenzialspieler, um im Ranking zu klettern.

Werkzeuge

So funktioniert die Anmeldung (und warum sie sicher ist)

FPL ist auf einen tokenbasierten Login (PingOne OIDC) umgestiegen. Statt nach deinem Passwort zu fragen, macht login_to_fpl Folgendes:

1. Es öffnet ein echtes Browserfenster auf der offiziellen FPL-Website.

2. Du meldest dich dort selbst an.

3. Das Sitzungstoken wird aus dem Netzwerkverkehr gelesen und lokal in token.txt gespeichert.

Dein Passwort wird nur auf der eigenen FPL-Seite eingegeben – es erreicht weder diesen Code noch das Modell. Es wird keine Bot-Erkennung umgangen; ein Mensch meldet sich an. Die vollständige technische Dokumentation findest du unter docs/FINDINGS.md.

Voraussetzungen

• Python 3.12+

• uv

• Node.js (nur, wenn du den MCP Inspector für die Entwicklung nutzt)

Einrichtung

git clone https://github.com/MoayadAbbara/FPL-MCP.git
cd FPL-MCP
uv sync --extra browser      # includes Playwright for browser login
uv run playwright install chromium

Mit Claude verbinden

Registriere den Server bei deinem MCP-Client. Für Claude Code:

claude mcp add fpl -- uv run --directory /path/to/FPL-MCP python src/server.py

Oder füge ihn zur MCP-Konfiguration deines Clients hinzu (.mcp.json / claude_desktop_config.json):

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": ["run", "python", "src/server.py"],
      "cwd": "/path/to/FPL-MCP"
    }
  }
}

Starte den Client neu und sprich einfach mit ihm.

Verwendung

Sobald die Verbindung steht, nutze natürliche Sprache:

"Sign in to FPL"
"Show my team"
"Any injury news on Arsenal players?"
"Compare Haaland and Gyökeres"
"Suggest transfers — differential mode"
"Analyse my mini-league 123456"
"Transfer out Haaland, bring in João Pedro, and make Watkins captain"

Das Modell ruft die richtigen Werkzeuge auf und teilt dir bei allem, was dein Team verändert, mit, was es getan hat.

Architektur

Mehrschichtig – jede Schicht kennt nur die darunterliegende:

src/
  tools/    MCP tool surface (thin glue: fetch -> domain -> format -> text)
  format/   raw data -> compact, model-friendly text
  domain/   pure FPL logic (scoring, suggestions, roster maths) — no HTTP, no MCP
  api/      FPL HTTP client
  auth/     token capture (browser) and storage
  server.py entry point

Rohes FPL-JSON erreicht das Modell nie; alles durchläuft domain/ und dann format/, sodass nur entscheidungsrelevante Felder übrig bleiben.

Entwicklung

uv run ruff format . && uv run ruff check --fix .   # format + lint
uv run python src/server.py                          # run the server (stdio)

Hinweise

• Die saisonabhängigen Werkzeuge (suggest_transfers, analyze_mini_league) funktionieren am besten, sobald die Saison begonnen hat; vor der ersten Frist geben sie eine klare "Noch nicht"-Meldung aus.

• Die Automatisierung der Teamverwaltung könnte gegen die Nutzungsbedingungen der FPL verstoßen. Nutze es für dein eigenes Team, behalte es privat und höre auf, wenn du darum gebeten wirst.

Lizenz

MIT