Cómo conectar SportMonks Football a Gemini vía MCP

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

SportMonks Football + Gemini

SportMonks Football API v3: ligas, temporadas, partidos y resultados, marcadores en vivo, clasificaciones, goleadores, equipos, plantillas, jugadores, estadios, cuotas previas al partido y pronósticos, con la sintaxis de include y filtros de SportMonks. La cobertura depende de tu plan de SportMonks.

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:

SPORTMONKS_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de SportMonks con un token de API. Existe un plan gratuito con pocas ligas; los planes de pago añaden ligas y complementos como cuotas y pronósticos.

1. Inicia sesión en my.sportmonks.com y abre API, luego Tokens.
2. Crea un token y cópialo.
3. Pega solo el token en SPORTMONKS_API_TOKEN, sin espacios ni el prefijo api_token=. El conector lo envía en la cabecera Authorization.
4. Instala el conector y ejecuta sportmonks_list_my_leagues: muestra las ligas que cubre tu plan, con sus ids.

Tu plan decide los datos: lo que puedes leer depende de tu plan de SportMonks, sobre todo de las ligas incluidas. Los datos fuera del plan no dan error: la respuesta llega vacía, con un aviso de que tu suscripción actual no tiene acceso. Por eso la IA empieza por tus ligas y trabaja con ellas. Las cuotas y los pronósticos necesitan además el complemento correspondiente.

Qué lee: ligas y temporadas; partidos y resultados de un día o de un rango de fechas; marcadores en vivo y los partidos que se juegan ahora mismo; clasificaciones, también en vivo; goleadores, asistencias y tarjetas; equipos, plantillas y jugadores con sus estadísticas; enfrentamientos directos; estadios; cuotas previas al partido de las casas de apuestas de tu plan; y las probabilidades y value bets del modelo de SportMonks.

Primero los ids: SportMonks trabaja con ids. Algunos ids de liga: 8 Premier League, 9 Championship, 82 Bundesliga, 384 Serie A, 564 LaLiga, 301 Ligue 1, 2 Champions League. Las clasificaciones, los goleadores y las plantillas necesitan el id de una temporada, que la IA toma de la temporada actual de la liga. Los equipos, jugadores y estadios se buscan por nombre con las herramientas de búsqueda.

Includes y filtros: una respuesta básica solo trae ids. La IA añade datos relacionados con includes, por ejemplo participants;scores;state;events.type para un partido con sus equipos, marcador, estado y goles, y acota las listas con filtros como fixtureLeagues:9. Limita los includes a lo que pediste, porque hacen las respuestas mucho más grandes. Las listas llegan en páginas de hasta 50.

Solo lectura: todas las herramientas solo leen. No cambia nada en tu cuenta de SportMonks, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Cuotas y pronósticos son información: las cuotas son decimales. Los value bets son lo que encuentra el modelo de SportMonks; son información, no consejos de apuestas.

Horas y rangos: las horas llegan en UTC salvo que la IA pida una zona horaria, y te da las horas de inicio en la tuya. Un rango de fechas cubre como máximo 100 días.

Límites: SportMonks permite 3.000 llamadas por hora y entidad (partidos, equipos, jugadores, etc.). Cada respuesta indica cuántas llamadas quedan y cuándo se reinicia el contador; tras un 429 la IA espera al reinicio. Prefiere una lista filtrada a muchas llamadas sueltas.

Errores frecuentes: 401 significa que SportMonks rechazó el token: crea uno nuevo en API y vuelve a pegarlo. 403 significa que el token funciona pero ese recurso no está en tu plan. Una respuesta vacía con "No result(s) found" suele indicar que la liga o el complemento no está en tu plan.

El conector solo cubre fútbol; no hace apuestas ni cambia tu plan ni tus tokens de SportMonks.

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 SportMonks Football.

Herramientas disponibles

Ejemplos de prompts

• "Muéstrame la clasificación actual de LaLiga con la racha de cada equipo en los últimos cinco partidos."
• "¿Cuándo son los próximos cinco partidos del Real Betis, y cómo acabaron los últimos cinco?"
• "¿Qué partidos se están jugando ahora mismo en mis ligas, y cómo van?"
• "¿Quiénes son los máximos goleadores y asistentes de LaLiga esta temporada?"
• "¿Qué le da el modelo de SportMonks al clásico del domingo, y qué cuotas previas tiene bet365?"

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