footballstack-mcp

Servidor MCP para la API de datos de fútbol FootballStack. Proporciona a un cliente LLM datos reales de fútbol — partidos, clasificaciones, alineaciones, eventos en vivo, xG a nivel de disparo con coordenadas de campo, y cuotas justas derivadas de modelos — en lugar de un marcador alucinado.

12 herramientas, 1 prompt. Node ≥ 20, sin paso de compilación.

Instalación

npx footballstack-mcp

Configura tu clave de API en el entorno. Plan gratuito: 1,000 solicitudes/mes. Obtén una clave en footballstackapi.com/sign-in.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "footballstack": {
      "command": "npx",
      "args": ["-y", "footballstack-mcp"],
      "env": { "FOOTBALLSTACK_API_KEY": "fs_live_..." }
    }
  }
}

Cursor / Windsurf / cualquier cliente MCP stdio

El mismo bloque, en el archivo de configuración MCP de ese cliente.

Related MCP server: worldcup-ai-forecaster

Herramientas

Prompt: scout_team_form — resuelve un equipo, obtén sus últimos 5 partidos, lee el xG detrás de los resultados.

Empieza con footballstack_search para resolver IDs. Adivinar IDs desperdicia cuota: los 404 y los resultados vacíos se contabilizan como cualquier otra solicitud.

Cobertura, declarada honestamente

El catálogo enumera 75 competiciones. La profundidad no es uniforme, y el catálogo es más amplio que la cobertura profunda.

• Más profundo: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României

• Europeo ampliado: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership

• Solo histórico / analítico: Premier League, La Liga, Serie A, Ligue 1 (el xG se deriva de Understat)

Llama a footballstack_competitions y verifica tu liga antes de construir sobre ella.

Comportamiento de la cuota

• Gratis: 1,000 solicitudes/mes, 10 req/min. Desarrollador $9/mes: 10,000 solicitudes/mes, 60 req/min, incluye xG, mapas de disparos, alineaciones, eventos en vivo y cuotas justas. Pro $29/mes: 50,000/mes, 180 req/min.

• Sin facturación por exceso. Cuando se agota la cuota, la API devuelve 429; este servidor lo muestra como un error quota_or_rate_limit en lugar de un resultado vacío.

• La cuota se restablece el día 1 de cada mes, UTC.

• Cada solicitud se contabiliza, incluidos los 404 y los resultados vacíos.

Cuándo esta es la herramienta equivocada

• Sondeo en vivo de alta frecuencia en muchas competiciones. Una cuota mensual no es la forma adecuada para ello — un plan por día o por segundo en otro lugar te costará menos.

• Ligas fuera de la lista de cobertura profunda anterior.

• Necesitas un SLA contractual, créditos de tiempo de actividad o un contacto de soporte designado. No se ofrecen a estos precios.

Desarrollo

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke funciona sin clave de API: footballstack_health devuelve el estado en vivo, y una herramienta protegida por clave devuelve un error legible missing_api_key para que puedas distinguir "no configurado" de "roto".

MIT.