Skip to main content
Glama
deenesjakoruzh
dexhamter

fpl-mcp

by dexhamter
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

⚽ FPL MCP — Model Context Protocol Server für Fantasy Premier League

Python 3.11+ MCP Standard License: MIT Built with uv

Ein asynchroner Model Context Protocol (MCP)-Server für Fantasy Premier League (FPL). Statten Sie KI-Codierungsassistenten und Agent-Frameworks (Antigravity, Claude Desktop, Cursor, Custom Agents) mit 33 speziellen Tools aus, um Spielpläne zu analysieren, Differenzialspieler zu scouten, Mannschaften zu verwalten, Live-Ergebnisse zu verfolgen, Preisfluktuationen zu überwachen und Transfers sowie Kapitänsentscheidungen zu optimieren.

🌟 Hauptfunktionen

  • 🚀 33 Spezialisierte Tools: Vollständige Abdeckung der offiziellen FPL-Endpunkte (Bootstrap, Fixtures, FDR, Squad, History, Chips, Live Gameweek Scores, Mini-Leagues, Set-Piece Takers, Differentials und Price Movers).

  • 🔒 Sicher & Nur-Lese: Fokussiert auf tiefgehende Analysen und KI-Empfehlungen ohne riskante automatisierte Transfers.

  • ⚡ In-Memory-TTL-Caching: Intelligentes Caching pro Endpunkt verhindert Rate-Limiting durch FPL-Server und hält Live-Gameweek-Ergebnisse aktuell.

  • 🛡️ Öffentliche & Private Unterstützung: Funktioniert sofort für öffentliche Daten mit nur einer Team-ID. Unterstützt Sitzungsauthentifizierung / Cookies für den Zugriff auf private Mannschaften.

  • 🔌 Standard-Stdio-Transport: Plug-and-play mit jedem MCP-konformen Client.

Related MCP server: MCP Eleven

🏗️ Architektur

fpl-mcp/
├── src/fpl_mcp/
│   ├── server.py          # MCP Server entrypoint (stdio transport)
│   ├── client.py          # Async FPL HTTP client with TTL caching
│   ├── auth.py            # Session cookie & credential manager
│   ├── cache.py           # In-memory thread-safe TTL cache
│   ├── constants.py       # API endpoints, TTLs, positions & chip maps
│   └── tools/
│       ├── registry.py    # Aggregator & dynamic tool dispatcher
│       ├── bootstrap.py   # Players, teams, and season status
│       ├── fixtures.py    # Fixtures schedule & FDR matrix
│       ├── squad.py       # Team picks, history, and manager info
│       ├── players.py     # Deep player statistics (xG, xA, ICT, PPG)
│       ├── transfers.py   # Transfer history, bank, and AI transfer scout
│       ├── chips.py       # Chip tracker & Double/Blank GW strategy engine
│       ├── live.py        # Real-time provisional GW scores & bonus points
│       ├── leagues.py     # Classic & Head-to-Head mini-league tables
│       ├── news.py        # Injury reports, bans, and set-piece takers
│       ├── picks.py       # Algorithmically ranked captain picks & differentials
│       └── prices.py      # Predicted price risers/fallers & confirmed changes
├── pyproject.toml
└── README.md

🚀 Schnellstart

1. Voraussetzungen

  • Python 3.11+

  • uv (empfohlen) oder pip

2. Installation

# Clone the repository
git clone https://github.com/dexhamter/fpl-mcp.git
cd fpl-mcp

# Install dependencies into virtual environment
uv sync

3. Konfiguration

Kopieren Sie die Beispiel-Umgebungsdatei:

cp .env.example .env

Bearbeiten Sie .env mit Ihren Team-Informationen:

# Your FPL Team ID (found in the URL: https://fantasy.premierleague.com/entry/{ID}/event/1)
FPL_TEAM_ID=1234567

# Optional: FPL login credentials or browser session cookie for private team data
FPL_EMAIL=your@email.com
FPL_PASSWORD=your_password
# FPL_COOKIE=pl_profile=...

⚙️ Verbindung zu MCP-Clients

🤖 Antigravity / Gemini CLI

Fügen Sie den Server zu Ihrer ~/.gemini/config/mcp_config.json hinzu:

{
  "mcpServers": {
    "fpl": {
      "command": "C:/Users/your_user/Documents/fpl/.venv/Scripts/python.exe",
      "args": ["-m", "fpl_mcp.server"],
      "env": {
        "PYTHONPATH": "C:/Users/your_user/Documents/fpl/src"
      }
    }
  }
}

🟣 Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/fpl-mcp",
        "run",
        "fpl-mcp"
      ]
    }
  }
}

💻 Cursor / Windsurf

In Einstellungen -> Features -> MCP-Server:

  • Typ: command

  • Befehl: uv --directory /pfad/zu/fpl-mcp run fpl-mcp

🛠️ Tool-Katalog (33 Tools)

1. Allgemeine & Bootstrap-Daten

Tool

Argumente

Beschreibung

get_all_players

position, team, max_price, min_form

Alle aktiven Spieler mit Filterung & Sortierung abfragen

search_player

query (erforderlich)

Spieler nach Teil- oder Vollnamen suchen

get_all_teams

Keine

Alle 20 Premier-League-Teams mit Stärkebewertungen abrufen

get_game_settings

Keine

Gameweek-Deadline, Durchschnittspunktzahl, Top-Manager

2. Spielpläne & Schwierigkeit (FDR)

Tool

Argumente

Beschreibung

get_fixtures

gameweek

Alle oder spezifische Gameweek-Spielpläne

get_team_fixtures

team_name (erforderlich), next_n

Kommender Spielplan für ein Team mit FDR-Bewertungen

get_fdr_table

next_n

Vergleichendes FDR-Raster über alle Teams

3. Mannschaft & Manager-Übersicht

Tool

Argumente

Beschreibung

get_my_squad

Keine

Aktueller 15-Spieler-Kader, Startelf, Bank, Kapitänswahl

get_entry_info

team_id

Gesamtrang, Gesamtpunkte, Bankguthaben und Teamwert

get_gw_picks

gameweek (erforderlich), team_id

Mannschaftsaufstellung für jede abgeschlossene Gameweek

get_season_history

team_id

Gameweek-für-Gameweek-Rang und Punkteverlauf

4. Spieleranalysen

Tool

Argumente

Beschreibung

get_player_stats

player_id, player_name

xG, xA, ICT-Index, Bonuspunkte, Minuten, Form

get_player_history

player_id, player_name

Detailliertes Spielprotokoll pro Gameweek für einen Spieler

get_top_performers

sort_by, position, max_price, limit

Rangliste nach Punkten, Form, PPG oder ICT

5. Transfers & Budget

Tool

Argumente

Beschreibung

get_transfer_history

team_id

Vollständiges Saisontransferprotokoll mit Kauf-/Verkaufskosten

get_bank_balance

Keine

Verfügbare Bankguthaben, freie Transfers, Teamwert

get_transfer_suggestions

position, max_price, next_n_gws

Zusammengesetzter Algorithmus zum Scouting von Transfers nach Form & FDR

6. Chip-Strategie

Tool

Argumente

Beschreibung

get_chip_status

Keine

Tracker für Wildcards, Free Hit, Bench Boost, Triple Captain

get_chip_advice

next_n

Doppel-/Leere-Gameweek-Erkennung und optimale Chip-Timing

7. Live-Gameweek-Ergebnisse

Tool

Argumente

Beschreibung

get_live_gw_scores

gameweek, sort_by, limit

Echtzeit-vorläufige Spielerpunkte, Tore, Vorlagen

get_my_live_score

gameweek

Echtzeit-Laufsumme für Ihre Mannschaft mit aktivem Kapitäns-Multiplikator

8. Mini-Ligen & Tabellen

Tool

Argumente

Beschreibung

get_my_leagues

Keine

Alle klassischen und Kopf-an-Kopf-Mini-Ligen für Ihr Team

get_classic_league_standings

league_id (erforderlich), page

Vollständige Ranglistentabelle mit Rängen und Event-Punkten

get_h2h_league_standings

league_id (erforderlich), page

Kopf-an-Kopf-Bilanzen (S/U/N, Matchpunkte)

9. Team-News & Standardsituationen

Tool

Argumente

Beschreibung

get_player_news

status

Spieler mit Verletzungen, Sperren oder Zweifeln filtern

get_set_piece_takers

team_name

Designierte Elfmeter-, Freistoß- und Eckenschützen

check_my_squad_news

Keine

Gesundheitscheck über Ihre 15 Spieler mit Statuswarnungen

10. Kapitänswahl & Differenzialspieler

Tool

Argumente

Beschreibung

get_captain_suggestions

from_my_squad, gameweek, top_n

Mehrfaktor-gewichtete Kapitänspunktzahl (Form, ICT, FDR, Heim)

get_differentials

max_ownership, position, max_price

Hochpotenzielle Spieler mit geringer Besitzquote (<15% Standard)

get_ownership_stats

position, sort_by, limit

Besitzquote %, Transferdynamik und Netto-Delta

11. Preisbewegungen

Tool

Argumente

Beschreibung

get_price_risers

position, limit

Bevorstehende Preissteigerungen basierend auf Netto-Transfereingängen

get_price_fallers

position, limit

Bevorstehende Preissenkungen basierend auf Netto-Transferausgängen

get_price_changes

direction, since

Bestätigte Preisänderungen in dieser Gameweek oder Saison

💡 Beispiel-Assistenten-Prompts

Sobald Sie mit Ihrem Agenten konfiguriert sind, können Sie natürliche Sprachfragen stellen wie:

  • "Wen sollte ich für Gameweek 1 zum Kapitän machen? Vergleiche meine besten Optionen basierend auf Spielplänen und erwarteter Torbeteiligung."

  • "Überprüfe meine Mannschaft auf Verletzungssorgen vor der Deadline."

  • "Ich habe £0,5 Mio. auf der Bank und muss einen Mittelfeldspieler unter £7,5 Mio. mit einfachen kommenden Spielplänen ersetzen. Wen schlägst du vor?"

  • "Zeig mir die Top-5-Differenzialstürmer, die von weniger als 10% der Manager besessen werden."

  • "Wer ist in dieser Saison für Elfmeter bei Arsenal und Liverpool zuständig?"

  • "Was ist unsere Strategie für Doppel- und Leere-Gameweeks? Wann sollte ich meinen Bench Boost in Betracht ziehen?"

⏱️ Caching-Richtlinie

Um niedrige Latenz zu gewährleisten und die FPL-Server-Etikette einzuhalten, werden Daten im Speicher zwischengespeichert:

Endpunkttyp

Standard-TTL

Live-Gameweek-Ergebnisse (live.py)

60 Sekunden

Mannschaft & Eintragsinfos (squad.py)

120 - 300 Sekunden

Bootstrap & Spielerstatistiken (bootstrap.py, players.py)

300 Sekunden (5 Min.)

Spielpläne & Zeitplan (fixtures.py)

600 Sekunden (10 Min.)

📜 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

⚽ Haftungsausschluss

Dieses Tool ist nicht offiziell mit der Premier League oder Fantasy Premier League verbunden oder von ihnen unterstützt. Alle Daten werden von öffentlichen FPL-API-Endpunkten abgerufen.

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

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Fantasy Premier League MCP

    rishijatia
    A
    license
    B
    quality
    B
    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
    94 PyPI
    80
    MIT

  • MCP Eleven

    ivan-escribano
    F
    license
    Not graded
    quality
    D
    maintenance
    An open-source MCP server that turns any AI assistant into a football data analytics and scouting platform, enabling natural language queries over 40+ stats, 20+ leagues, and 10,000+ players.
    1
    -

  • fpl-mcp

    reecetwhite
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Fantasy Premier League API, enabling querying of players, teams, fixtures, and your FPL team through any MCP-compatible client.
    -

  • fpl-mcp

    mgphp
    A
    license
    A
    quality
    C
    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
    10 npm
    1
    ISC