LiveFPL MCP Server

Un servidor MCP que expone predicciones de subida/bajada de precio de jugadores de Fantasy Premier League desde LiveFPL.

Los datos se sirven desde el host JSON público de LiveFPL (https://livefpl.us) — los mismos endpoints que carga el propio sitio web. No se requiere cuenta, clave API ni autenticación.

Fuente de datos (ingeniería inversa)

La página https://www.livefpl.net/prices carga su tabla de predicción de precios desde:

La página de la liga es HTML renderizado en servidor (sin API JSON) — las clasificaciones en vivo de la jornada están incrustadas en la página, por lo que el servidor obtiene y parsea ese HTML.

Campos de prices.json

Clave por id de jugador. Para cada jugador:

• progress — progreso actual hacia un cambio de precio, como fracción del umbral. Positivo ⇒ subiendo, negativo ⇒ bajando. +1.0 significa que la subida es inminente; -1.0 significa que la bajada es inminente. Se muestra en el sitio como la columna "Now".

• progress_tonight — progreso previsto para el próximo corte de cambio. Se muestra como la columna "Prediction". Es lo que usan las herramientas para ordenar.

• per_hour — tasa de cambio del progreso por hora (columna "Per hr").

• cost, name, team, type (GK/DEF/MID/FW).

Herramientas

El grafo de tendencia de transferencias se deriva en el cliente a partir de top_transfers.json (de la misma manera que la página de LiveFPL construye su gráfico de burbujas): neto por jugador = transferencias entrantes − transferencias salientes, tamaño del nodo = volumen total, aristas = pares de transferencias (saliente → entrante).

Cada resultado de jugador incluye progress_now_pct, prediction_pct, per_hour_pct, direction (rise/fall/stable) y predicted_new_cost.

Instalación

cd livefpl-mcp
uv sync

Ejecución

uv run livefpl-mcp

El servidor habla MCP sobre stdio.

Configuración del cliente Claude Desktop / MCP

Añade a tu configuración de cliente MCP (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "livefpl": {
      "command": "uv",
      "args": ["--directory", "C:\\path-to-mcp\\livefpl-mcp", "run", "livefpl-mcp"]
    }
  }
}

Ejemplos de prompts

• "¿Qué defensas de FPL están a punto de subir de precio?"

• "Muéstrame los 10 jugadores que más van a bajar esta noche."

• "¿Cuál es la predicción de precio para Haaland?"

• "¿Cuáles son las transferencias más populares ahora mismo?"

• "Muestra las puntuaciones en vivo de la liga 230412."

• "¿Quién está ganando la jornada en mi liga 230412 ahora mismo?"

Notas

• Las predicciones son de LiveFPL, no del algoritmo oficial de FPL; la precisión es mejor en jornadas simples (LiveFPL señala que las reglas de doble jornada son menos seguras).

• Los datos se obtienen en vivo en cada llamada a la herramienta.

Licencia

MIT