Cómo conectar API-Football a ChatGPT vía MCP

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

API-Football + ChatGPT

Deja que tu IA siga el fútbol con API-Football: resultados en directo y eventos de los partidos, calendarios, clasificaciones, estadísticas de equipos y jugadores, alineaciones, lesiones, fichajes, enfrentamientos directos, predicciones y cuotas de casas de apuestas para ligas y copas de todo el mundo. Con una clave API de tu cuenta de API-Sports.

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:

API_FOOTBALL_KEY

Paso 1 — Obtener credenciales

1. Crea una cuenta gratuita en dashboard.api-football.com. Al iniciar sesión, el panel te muestra tu clave API. Para probar el conector basta con el plan gratuito.
2. Pega la clave en API_FOOTBALL_KEY e instala el conector. Se envía a API-Sports como cabecera x-apisports-key. Usa la clave del panel de API-Sports: una clave comprada a través de un marketplace de APIs usa otra cabecera y aquí no funciona.
3. Llama primero a af_status. Muestra tu plan, el límite diario de peticiones y cuántas llevas usadas, y no cuenta para la cuota.
4. Para cualquier análisis, empieza por af_analysis_playbook. No hace ninguna llamada a la API y devuelve la secuencia de herramientas para cada tipo de petición: previa o predicción, crónica tras el partido, forma del equipo, clasificación, mejores jugadores, scouting, plantilla, lesiones, fichajes, cuotas o seguimiento en directo.

Primero, los nombres se convierten en ids: casi todas las herramientas necesitan ids numéricos, y la IA nunca debe adivinarlos. Busca una competición con af_leagues y el filtro search (por ejemplo la Bundesliga, id 78, o el Mundial, id 1), que además lista las temporadas disponibles, y un equipo con af_teams. af_fixtures con el id del equipo y next en 1 devuelve el próximo partido y su fixture id, que necesitan af_predictions, af_fixture_lineups, af_fixture_events, af_fixture_statistics y af_fixture_players. Los jugadores salen de af_players con equipo y temporada, o de af_player_profiles para buscarlos por nombre.

Temporadas y horas: season es el año de 4 cifras en que empieza la temporada: 2025 significa 2025/26, y el Mundial 2026 es 2026. Las fechas van en formato YYYY-MM-DD. Las horas están en UTC salvo que la IA pase timezone con un valor de af_timezone.

Cuota diaria: cada llamada a una herramienta de datos es una petición a API-Sports y cuenta para la cuota diaria de tu plan. Las instrucciones del conector dan por hecho el plan gratuito, que permite 100 peticiones al día; los planes de pago permiten más. af_status y af_analysis_playbook no cuestan nada. Una previa completa (predicción, cuotas, alineaciones, estadísticas y lesiones de ambos equipos, goleadores, estadísticas de jugadores, enfrentamientos directos) lleva una docena de llamadas, y los resultados paginados como los de af_players cuestan una petición por página, así que los filtros precisos (liga, temporada, equipo, fecha) ahorran mucho.

Predicciones y cuotas son datos, no consejos de apuestas: af_predictions devuelve para un partido los porcentajes de victoria, empate y derrota calculados por API-Football, un consejo y una comparación de forma. af_odds_prematch y af_odds_live devuelven cuotas de casas de apuestas, que la IA puede convertir en probabilidades implícitas y comparar con la predicción. Ninguno de los dos garantiza el resultado. Puede que no haya cuotas para partidos menores o todavía lejanos; af_odds_mapping lista los partidos con cuotas, y af_odds_bookmakers, af_odds_bets y af_odds_live_bets las casas de apuestas y los mercados.

Qué cubren los datos: las alineaciones suelen confirmarse una hora antes del inicio. En af_injuries, Missing Fixture significa que el jugador está fuera y Questionable que es duda. No hay herramienta de árbitros: el árbitro solo aparece en el partido, a menudo tarde. Los enfrentamientos directos están bien cubiertos para clubes y muy poco para selecciones.

Solo lectura: las 40 herramientas solo leen datos. No se cambia nada en tu cuenta de API-Sports y ninguna herramienta está desactivada al instalar.

Errores comunes: API-Football puede responder HTTP 200 y fallar igualmente; el motivo aparece entonces en el campo errors y response viene vacío. Una entrada token significa que la clave es incorrecta o falta: revisa API_FOOTBALL_KEY. Una entrada plan significa que la temporada o la función no está incluida en tu plan: mejóralo en el panel de API-Sports o pregunta por una temporada que tu plan cubra. Cuando se agota la cuota diaria, las llamadas fallan hasta que se reinicia; af_status muestra cuántas peticiones quedan. Un response vacío sin errores significa que nada coincide con los filtros, por ejemplo cuotas aún no publicadas o una temporada que no ha empezado.

El conector no hace apuestas, no cubre los otros deportes de API-Sports ni envía avisos en directo: los resultados en directo llegan cuando la IA los pide. Tampoco es el conector de football-data.org, que usa su propio token de football-data.org.

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: API-Football.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "Hazme una previa completa del próximo partido de Argentina: probabilidades de victoria, cuotas de las casas de apuestas, alineaciones probables, lesionados y la forma reciente de los dos equipos."
• "Enséñame la clasificación actual de la Bundesliga y los 10 máximos goleadores de esta temporada."
• "¿Qué partidos de la Serie A se están jugando ahora mismo, cómo van y quién ha marcado hasta ahora?"
• "¿Quién está lesionado o sancionado en el Real Madrid ahora mismo y qué jugadores fichó el club en el último mercado de fichajes?"

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

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