FPL MCP

Gestiona tu equipo de Fantasy Premier League con IA. Un servidor MCP que permite a un cliente LLM como Claude leer tu equipo de FPL, analizar jugadores y partidos, sugerir fichajes, espiar a tus rivales de mini-liga y ejecutar fichajes, elegir capitán y jugar comodines — todo desde un chat en lenguaje natural.

⚠️ No oficial. No está afiliado, respaldado ni conectado con la Premier League. Utiliza la API pública de FPL. Se ejecuta íntegramente en tu propia máquina — tu token de sesión nunca sale de tu ordenador y esta herramienta o el modelo nunca ven tu contraseña.

Demo

Una sola frase, varias acciones — un fichaje, un cambio de capitán y un cambio en la alineación, todo ejecutado en el equipo real:

"Saca a João Pedro, trae a Havertz, pon a Haaland de capitán y mete a Yates en el once inicial por Le Fée"

Related MCP server: FPL MCP Server

Qué lo hace diferente

La mayoría de las herramientas de FPL solo leen datos y dan consejos que luego aplicas a mano. Esta:

• Gestiona tu equipo de verdad — fichajes, capitanía, alineación y comodines, ejecutados de forma real.

• Te identifica sin tocar jamás tu contraseña — se abre un navegador real, inicias sesión en la página oficial de FPL y solo se captura el token de sesión.

• Espía tu mini-liga — las plantillas de los rivales son públicas, así que calcula la propiedad dentro de tu liga y te dice tu ventaja y las amenazas.

• Sugiere fichajes con un modelo que tiene en cuenta la posición — tres estrategias: máximos puntos, opciones de plantilla seguras o diferenciales para subir en la clasificación.

Herramientas

Cómo funciona el inicio de sesión (y por qué es seguro)

FPL migró a un inicio de sesión basado en tokens (PingOne OIDC). En lugar de pedir tu contraseña, login_to_fpl:

1. Abre una ventana de navegador real en el sitio oficial de FPL.

2. Tú inicias sesión allí mismo.

3. El token de sesión se lee del tráfico de red y se guarda localmente en token.txt.

Tu contraseña se escribe únicamente en la propia página de FPL — nunca llega a este código ni al modelo. No se elude ninguna detección de bots; inicia sesión una persona. Consulta docs/FINDINGS.md para el informe técnico completo.

Requisitos

• Python 3.12+

• uv

• Node.js (solo si usas MCP Inspector para el desarrollo)

Configuración

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

Conéctalo a Claude

Registra el servidor en tu cliente MCP. Para Claude Code:

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

O añádelo a la configuración MCP de tu cliente (.mcp.json / claude_desktop_config.json):

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

Reinicia el cliente y, a continuación, simplemente habla con él.

Uso

Una vez conectado, usa lenguaje natural:

"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"

El modelo llama a las herramientas adecuadas y, para cualquier cosa que modifique tu equipo, te dice lo que ha hecho.

Arquitectura

Por capas — cada capa solo conoce a la que tiene debajo:

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

El JSON crudo de FPL nunca llega al modelo; todo pasa por domain/ y luego por format/ para que solo queden los campos relevantes para la decisión.

Desarrollo

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

Notas

• Las herramientas que dependen de la temporada (suggest_transfers, analyze_mini_league) funcionan mejor una vez que la temporada ha comenzado; antes del primer deadline devuelven un claro mensaje de "todavía no".

• Automatizar la gestión del equipo puede chocar con los Términos de Servicio de FPL. Úsalo para tu propio equipo, mantenlo personal y detente si te lo piden.

Licencia

MIT