API-Football a MCP: Pilota API-Football desde cualquier agente IA

💡 ¿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

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.

Configuración

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.

Requisitos previos: API_FOOTBALL_KEY

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige API-Football e introduce las variables listadas en los Requisitos previos.

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?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT