World Cup History MCP

World Cup History MCP

por Zafronix · npm: @zafronix/wc-mcp · con licencia MIT

Servidor del Model Context Protocol que brinda a Claude / Cursor / cualquier agente compatible con MCP acceso fundamentado a cada Copa Mundial de la FIFA desde 1930. 23 torneos. Más de 1.168 partidos. Más de 2.500 jugadores. 206 estadios. Todo expuesto como 15 herramientas tipadas para que el modelo deje de alucinar alineaciones, resultados, cuadros y altitudes de estadios.

Impulsado por la API pública de la Copa Mundial de Zafronix — plan gratuito con clave, 1.000 solicitudes/día, sin tarjeta.

Por qué

Los LLM no son fiables en:

• Resultados exactos de torneos anteriores a la ventana de datos de entrenamiento.
• Detalles de plantillas (números de camiseta, fechas de nacimiento, capitanes).
• Recorridos de las rondas eliminatorias y resultados exactos.
• Datos de estadios (capacidad, altitud, año de inauguración).

Este MCP envuelve la API de la Copa Mundial de Zafronix para que el modelo pueda llamar a una herramienta y obtener la respuesta canónica en lugar de adivinar.

Instalación

npm install -g @zafronix/wc-mcp

O ejecutar desde el código fuente:

git clone https://github.com/zafronix/wc-mcp
cd wc-mcp
npm install
npm run build

Obtén una clave de API gratuita

https://api.zafronix.com/signup

1.000 solicitudes/día en el plan gratuito, sin tarjeta.

Configuración (Claude Desktop)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wc": {
      "command": "npx",
      "args": ["-y", "@zafronix/wc-mcp"],
      "env": {
        "WC_API_KEY": "zwc_pk_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Verás un icono 🔌 en la barra de entrada: haz clic en él para confirmar que wc está conectado.

Configuración (Cursor)

Settings → MCP → Add new server:

{
  "mcpServers": {
    "wc": {
      "command": "npx",
      "args": ["-y", "@zafronix/wc-mcp"],
      "env": { "WC_API_KEY": "zwc_pk_..." }
    }
  }
}

Herramientas

Herramienta	Qué hace
list_tournaments	Cada Copa Mundial 1930→2026 (año, sede, campeón).
get_tournament	Torneo completo: equipos, cuadros, premios, plantillas.
compare_tournaments	Estadísticas comparativas de 2 a 6 años.
search_players	Búsqueda de jugadores por nombre en toda la historia.
get_player_career	Cada Copa Mundial en la que participó un jugador.
list_teams	Cada selección que haya participado, con filtro opcional por confederación.
get_team	Resumen entre torneos para un país.
get_team_roster	Plantilla completa de un equipo en un año.
list_stadiums	Cada sede de la Copa Mundial con altitud y coordenadas.
get_stadium	Una sede individual por slug.
list_matches	Filtro por año / fase / fecha.
get_match	Un partido individual con resultado, asistencia y árbitro.
get_trivia	Datos curiosos seleccionados por año.
get_standings	Tablas de grupos calculadas con criterios de desempate de la FIFA.
get_bracket	Cuadro completo de eliminatorias.

Ejemplos de prompts (en Claude Desktop, con este MCP habilitado)

• "Compara a Pelé y Messi en la Copa Mundial."
• "¿Cuál fue el estadio de la Copa Mundial a mayor altitud de la historia, y cómo se compararon los goles allí con los de los estadios a nivel del mar?"
• "Muéstrame la plantilla de Italia de 2006 con posiciones y clubes."
• "Traza el camino de Argentina hacia el título en 2022: cada partido, cada resultado."
• "Enumera todas las selecciones africanas que han llegado a los cuartos de final de la Copa Mundial."

Desarrollo

npm run dev          # tsx watch mode
WC_API_KEY=... npm start

El servidor usa stdio. Puedes probarlo con la CLI de MCP:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Licencia

MIT.