World Cup History MCP

World Cup History MCP

por Zafronix · npm: @zafronix/wc-mcp · licença MIT

Servidor Model Context Protocol que dá ao Claude / Cursor / qualquer agente compatível com MCP acesso fundamentado a todas as Copas do Mundo desde 1930. 23 torneios. Mais de 1.168 partidas. Mais de 2.500 jogadores. 206 estádios. Tudo exposto como 15 ferramentas tipadas para que o modelo pare de alucinar escalações, placares, chaveamentos e altitudes de estádios.

Alimentado pela API pública Zafronix World Cup — plano gratuito com chave, 1.000 req/dia, sem cartão de crédito.

Por quê

LLMs não são confiáveis em:

• Resultados exatos de torneios anteriores à janela dos dados de treinamento.
• Detalhes de elencos (números de camisa, datas de nascimento, capitães).
• Caminhos nas fases eliminatórias e placares exatos.
• Dados de estádios (capacidade, altitude, ano de inauguração).

Este MCP encapsula a API Zafronix WC para que o modelo possa chamar uma ferramenta e obter a resposta canônica em vez de adivinhar.

Instalação

npm install -g @zafronix/wc-mcp

Ou execute a partir do código-fonte:

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

Obtenha uma chave de API gratuita

https://api.zafronix.com/signup

1.000 requisições/dia no plano gratuito, sem cartão de crédito.

Configuração (Claude Desktop)

Edite ~/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"
      }
    }
  }
}

Reinicie o Claude Desktop. Você verá um ícone 🔌 na barra de entrada — clique nele para confirmar que wc está conectado.

Configuração (Cursor)

Configurações → MCP → Adicionar novo servidor:

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

Ferramentas

Ferramenta	O que faz
list_tournaments	Todas as Copas de 1930→2026 (ano, sede, campeão).
get_tournament	Torneio completo: times, chaveamentos, prêmios, elencos.
compare_tournaments	Estatísticas lado a lado de 2 a 6 anos.
search_players	Busca por nome de jogador em toda a história.
get_player_career	Todas as Copas em que um jogador participou.
list_teams	Todas as nações que já jogaram, com filtro opcional por confederação.
get_team	Resumo entre torneios para um país.
get_team_roster	Elenco completo de um time em um ano.
list_stadiums	Todas as sedes de Copas com elevação e coordenadas.
get_stadium	Uma única sede por slug.
list_matches	Filtro por ano / fase / data.
get_match	Partida individual com placar, público e árbitro.
get_trivia	Curiosidades factuais selecionadas por ano.
get_standings	Tabelas de grupos calculadas com critérios de desempate da FIFA.
get_bracket	Chaveamento completo das fases eliminatórias.

Exemplos de prompts (no Claude Desktop, com este MCP ativado)

• "Compare Pelé e Messi na Copa do Mundo."
• "Qual foi o estádio de Copa do Mundo com maior altitude da história, e como os totais de gols lá se compararam aos estádios ao nível do mar?"
• "Mostre o elenco da Itália em 2006 com posições e clubes."
• "Trace o caminho da Argentina até o título em 2022 — cada partida, cada placar."
• "Liste todas as nações africanas que chegaram às quartas de final da Copa do Mundo."

Desenvolvimento

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

O servidor fala stdio. Você pode testá-lo com a CLI do MCP:

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

Licença

MIT.