Un servidor asíncrono de Model Context Protocol (MCP) para Fantasy Premier League (FPL). Proporciona a los asistentes de codificación con IA y a los frameworks de agentes (Antigravity, Claude Desktop, Cursor, Custom Agents) 33 herramientas especializadas para analizar partidos, detectar diferenciales, gestionar plantillas, seguir las puntuaciones en vivo, supervisar las fluctuaciones de precios y optimizar los traspasos y las decisiones de capitanía.
🚀 33 herramientas especializadas: Cobertura completa de los endpoints oficiales de FPL (Bootstrap, Fixtures, FDR, Squad, History, Chips, Live Gameweek Scores, Mini-Leagues, Set-Piece Takers, Differentials y Price Movers).
🔒 Seguro y de solo lectura: Se centra en análisis profundos y recomendaciones de IA sin traspasos automáticos arriesgados.
⚡ Caché TTL en memoria: El caché inteligente por endpoint evita la limitación de la tasa de peticiones de los servidores de FPL y mantiene frescas las puntuaciones en vivo de la jornada.
🛡️ Compatibilidad pública y privada: Funciona de inmediato con los datos públicos con solo un ID de equipo. Admite autenticación de sesión / cookies para el acceso privado a la plantilla.
🔌 Transporte stdio estándar: Plug-and-play con cualquier cliente compatible con MCP.
Related MCP server: MCP Eleven
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.mdPython 3.11+
uv (recomendado) o pip
# Clone the repository
git clone https://github.com/dexhamter/fpl-mcp.git
cd fpl-mcp
# Install dependencies into virtual environment
uv syncCopia el archivo de entorno de ejemplo:
cp .env.example .envEdita .env con la información de tu equipo:
# 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=...Añade el servidor a tu ~/.gemini/config/mcp_config.json:
{
"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"
}
}
}
}Añádelo a tu claude_desktop_config.json:
{
"mcpServers": {
"fpl": {
"command": "uv",
"args": [
"--directory",
"/path/to/fpl-mcp",
"run",
"fpl-mcp"
]
}
}
}En Ajustes -> Funciones -> Servidores MCP:
Tipo: command
Comando: uv --directory /path/to/fpl-mcp run fpl-mcp
Herramienta | Argumentos | Descripción |
|
| Consulta todos los jugadores activos con filtrado y ordenación |
|
| Busca jugadores por nombre parcial o completo |
| None | Obtén los 20 equipos de la Premier League con sus valoraciones de fuerza |
| None | Fecha límite de la jornada, puntuación media, mejores entrenadores |
Herramienta | Argumentos | Descripción |
|
| Calendario de partidos de todas las jornadas o de una específica |
|
| Próximos partidos de un equipo con valoraciones FDR |
|
| Cuadro comparativo de FDR de todos los equipos |
Herramienta | Argumentos | Descripción |
| None | Plantilla actual de 15 jugadores, titulares, banquillo y capitanía |
|
| Clasificación general, puntos totales, saldo bancario y valor del equipo |
|
| Alineación de la plantilla para cualquier jornada finalizada |
|
| Trayectoria de clasificación y puntos jornada a jornada |
Herramienta | Argumentos | Descripción |
|
| xG, xA, índice ICT, puntos de bonus, minutos, forma |
|
| Registro detallado de los partidos de un jugador jornada a jornada |
|
| Clasificación ordenada por puntos, forma, PPG o ICT |
Herramienta | Argumentos | Descripción |
|
| Registro completo de traspasos de la temporada con costes de compra y venta |
| None | Fondos disponibles en el banco, traspasos gratuitos y valor del equipo |
|
| Algoritmo compuesto que evalúa traspasos según forma y FDR |
Herramienta | Argumentos | Descripción |
| None | Seguimiento de Wildcards, Free Hit, Bench Boost y Triple Captain |
|
| Detección de jornadas dobles/en blanco (Double/Blank Gameweek) y momento óptimo para usar los chips |
Herramienta | Argumentos | Descripción |
|
| Puntos provisionales de los jugadores en tiempo real, goles y asistencias |
|
| Total actualizado en tiempo real de tu plantilla con el multiplicador de capitán activo |
Herramienta | Argumentos | Descripción |
| None | Todas las miniligas clásicas y cara a cara (head-to-head) de tu equipo |
|
| Tabla de clasificación completa con posiciones y puntuaciones de la jornada |
|
| Registros cara a cara (W/D/L, puntos de partido) |
Herramienta | Argumentos | Descripción |
|
| Filtra jugadores con lesiones, sanciones o dudas |
|
| Lanzadores designados de penaltis, tiros libres y córners |
| None | Chequeo del estado de tus 15 jugadores con alertas de estado |
Herramienta | Argumentos | Descripción |
|
| Puntuación de capitán ponderada por múltiples factores (forma, ICT, FDR, local) |
|
| Elecciones de alto potencial y baja propiedad (<15 % por defecto) |
|
| Porcentaje de propiedad, impulso de traspasos y delta neto |
Herramienta | Argumentos | Descripción |
|
| Jugadores que subirán de precio próximamente según los traspasos netos recibidos |
|
| Jugadores que bajarán de precio próximamente según los traspasos netos realizados |
|
| Cambios de precio confirmados en esta jornada o en la temporada |
Una vez configurado con tu agente, puedes hacer preguntas en lenguaje natural como:
"¿A quién debería poner de capitán en la jornada 1? Compara mis mejores opciones según el calendario y la participación esperada en goles."
"Revisa mi plantilla por si hay problemas de lesiones antes de la fecha límite."
"Tengo £0.5m en el banco y necesito reemplazar a un centrocampista de menos de £7.5m con un calendario favorable. ¿A quién me sugieres?"
"Muéstrame los 5 delanteros diferenciales más destacados que estén en menos del 10 % de los equipos."
"¿Quién se encarga de los penaltis en el Arsenal y el Liverpool esta temporada?"
"¿Cuál es nuestra estrategia para las jornadas dobles y en blanco (Double y Blank Gameweek)? ¿Cuándo debería plantearme usar mi Bench Boost?"
Para mantener una baja latencia y cumplir con la etiqueta de los servidores de FPL, los datos se guardan en caché en memoria:
Tipo de endpoint | TTL por defecto |
Puntuaciones en vivo de la jornada ( | 60 segundos |
Plantilla e información del equipo ( | 120 - 300 segundos |
Bootstrap y estadísticas de jugadores ( | 300 segundos (5 min) |
Partidos y calendario ( | 600 segundos (10 min) |
Este proyecto está licenciado bajo la Licencia MIT.
Esta herramienta no está afiliada oficialmente a la Premier League ni a Fantasy Premier League, ni cuenta con su respaldo. Todos los datos se obtienen de los endpoints públicos de la API de FPL.
This server cannot be deployed
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
