Cómo conectar football-data.org a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → football-data.org, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

football-data.org + Gemini

football-data.org API v4: competiciones de fútbol, clasificaciones, calendarios y resultados, enfrentamientos directos, equipos, plantillas, jugadores y máximos goleadores. El plan gratuito cubre 12 competiciones principales con un API token.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

FOOTBALL_DATA_API_TOKEN

Paso 1 — Obtener credenciales

1. Regístrate gratis en https://www.football-data.org/client/register. El token de la API llega por correo y también aparece en la página de tu cuenta al iniciar sesión.
2. Ponlo en FOOTBALL_DATA_API_TOKEN (32 letras minúsculas y dígitos); se envía en la cabecera X-Auth-Token.
3. Llama a football_data_list_competitions para ver qué cubre el token y después a football_data_get_standings o football_data_list_competition_matches con un código de competición como PL, BL1, SA, PD o CL.

El plan gratuito cubre 12 competiciones (PL, ELC, BL1, SA, PD, FL1, DED, PPL, BSA, CL, EC, WC) con resultados en diferido y permite 10 peticiones por minuto; los resultados en directo, las alineaciones y las estadísticas de partido necesitan un plan de pago. Todo lo que queda fuera del plan responde 403, que es el plan y no un token roto; un token no válido responde 400. season es el año de inicio (2025 significa 2025/26) y todas las horas están en UTC. Para la previa de un partido, llama a football_data_get_head2head con el id del partido y a football_data_list_team_matches para ambos equipos.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de football-data.org.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse