Futbol Atlas

Futbol Atlas — servidor MCP

As Regras do Jogo e as principais competições do futebol mundial, com cada afirmação citada a fontes primárias

Um servidor MCP remoto sobre um grafo de conhecimento curado. Cada afirmação que ele retorna está vinculada a uma fonte registrada: as ferramentas devolvem afirmações com suas citações e um valor de confiança, para que um agente possa mostrar seu trabalho em vez de apenas afirmar.

Nada para instalar. É um endpoint hospedado de HTTP transmitível:

https://futbolatlas.app/mcp

Também listado no Smithery.

Adicionar a um cliente

Claude Code

claude mcp add --transport http futbol-atlas https://futbolatlas.app/mcp

Claude Desktop / qualquer cliente que leia mcpServers

{
  "mcpServers": {
    "futbol-atlas": {
      "type": "streamable-http",
      "url": "https://futbolatlas.app/mcp"
    }
  }
}

Sem chave de API, sem conta, sem autenticação. Somente leitura.

Verifique se responde, sem nenhum cliente:

curl -s https://futbolatlas.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ferramentas

Oito, cada uma com um outputSchema, cada uma retornando structuredContent.

ferramenta	argumentos	o que faz
get_overview	—	Visão geral do corpus: o que esta instância conhece, contagens por tipo, tags publicadas, atualidade. Comece aqui ao chegar e ainda não souber se este corpus pode responder à sua pergunta.
search	query, limit?	Busca de texto completo no grafo de conhecimento. Insensível a acentos e apóstrofos, então consulte nas próprias palavras do usuário; cada resultado traz sua pontuação de relevância e os campos em que houve correspondência.
answer	question	Responda a uma pergunta a partir do corpus. Retorna as afirmações do objeto correspondente com fontes e confiança — nunca uma resposta sem fonte.
get_entity	id	Busca um objeto de conhecimento por id, com suas afirmações e as fontes que cada afirmação cita.
get_topic	tag	Lista os objetos de conhecimento que carregam uma tag (tópicos são tags com respaldo de conteúdo).
get_related	id	Vizinhos no grafo de um objeto: relações de saída e de entrada, cada uma com seu tipo de relação.
get_sources	object_id?	O registro completo de fontes, ou apenas as fontes citadas por um objeto. Use para avaliar o corpus antes de confiar nele.
get_latest	limit?	Objetos de conhecimento verificados mais recentemente — um sinal de atualidade.

O caminho pretendido é get_overview → search ou answer → get_entity → get_related. get_overview existe porque um agente que acabou de chegar precisa saber se este corpus pode ajudar antes de gastar uma chamada adivinhando.

O que há no corpus

objetos de conhecimento	141
fontes registradas	132
tópicos publicados	96

tipo	objetos
entidade	114
glossário	12
faq	7
guia	5
comparação	3

Assunto: as dezessete Regras do Jogo como a IFAB as escreve, protocolo de VAR e suas categorias de revisão, formatos de competição e caminhos de classificação, impedimento, mão na bola e a redação que os decide.

Perguntas que ele foi construído para responder

• O que exatamente a Regra 11 diz sobre a posição de um jogador no momento em que a bola é jogada?
• Quando o VAR pode intervir, e quando é proibido?
• Como uma equipe se classifica para a fase de liga da Champions League?

Como é uma resposta de verdade

Uma chamada real ao endpoint ao vivo — answer com "quando o VAR pode intervir" — retorna este structuredContent, reduzido:

{
  "answered": true,
  "entity": {
    "id": "var",
    "name": "VAR (Video Assistant Referee)",
    "evidence_tier": "primary",
    "confidence": 0.94,
    "last_verified": "2026-08-08",
    "canonical_url": "https://futbolatlas.app/k/var"
  },
  "claims": [
    {
      "text": "The VAR may assist the referee only for a clear and obvious error or a serious missed incident in these match-changing categories: goal/no goal, penalty/no penalty, direct red card, and mistaken identity when the referee cautions or sends off the wrong player of the offending team.",
      "sources": [{ "title": "Video Assistant Referee (VAR) protocol (Laws of the Game 2026/27)" }]
    }
  ]
}

Observe o que acompanha a resposta: o nível de evidência, uma confiança, a data em que foi verificado pela última vez e a fonte por trás da afirmação — não como prosa que um agente precisa interpretar, mas como campos sobre os quais ele pode agir. Um agente pode recusar usar uma afirmação fraca ou citar a fonte primária diretamente.

Quando o corpus não consegue responder, answered é false. Ele não improvisa, e a falha é registrada para que a lacuna possa ser preenchida.

Superfícies legíveis por máquina

O endpoint MCP é um de vários. O mesmo corpus é servido como arquivos simples que um agente pode ler diretamente:

superfície	o que é
/llms.txt	o índice, como text/plain
/llms-full.txt	o corpus inteiro em um arquivo
/ai-index.json	toda superfície que esta instância publica, com seu tipo de conteúdo
/api/index.json	um documento JSON por objeto de conhecimento
/api/sources.json	o registro de fontes, completo
/.well-known/mcp/server.json	o manifesto deste servidor

Cada objeto de conhecimento tem uma página humana e um gêmeo de máquina no mesmo id, com uma URL canônica que concorda entre todos eles.

O version no server.json deste repositório

É a versão do corpus, não a do framework (ADR-017): um corpus que cresceu em quarenta objetos precisa ser republicável sem esperar que alguém faça um lançamento de software, e um patch do framework não deve anunciar "nova versão" para corpora que não mudaram. O valor autoritativo é o que o site gera e serve — o campo version de /.well-known/mcp/server.json, junto com _citarium.corpus_version.

A cópia neste repositório é mantida manualmente e se desviou: ficou em 0.6.5 enquanto o site servia 2026.809.141. Antes de publicar no Registro MCP, copie o valor servido. Os dois arquivos não são idênticos de propósito — este carrega ?via=registry em seu remoto e o servido carrega ?via=manifest, para que o tráfego de cada canal possa ser distinguido.

Comportamento que vale saber antes de integrar

• Somente POST. Todo outro método responde 405 com um cabeçalho Allow: POST, OPTIONS.
• Limite de taxa: 120 requisições por minuto por cliente, contadas em um armazenamento compartilhado, publicado em cada resposta como RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset (todos os três expostos via CORS). Falha aberta: se o armazenamento estiver inacessível, a requisição é atendida.
• Entrada malformada recebe um erro JSON-RPC correto conforme a especificação — -32700 para corpos não analisáveis, -32602 para uma ferramenta desconhecida — nunca uma página de erro HTML.
• Corpos de requisição são limitados e validados antes do transporte.

Privacidade

Sem contas, sem cookies, sem anúncios. O uso é medido de forma agregada com identificadores hash rotacionados diariamente e retenção de 200 dias; IPs brutos nunca são armazenados. Política completa: PRIVACY.md.

Proveniência e licença

O conteúdo de conhecimento é CC-BY-4.0: use, cite. O registro de fontes é público justamente para que uma afirmação possa ser verificada em vez de confiada — get_sources retorna no que qualquer afirmação se apoia.

As afirmações carregam um nível de evidência e uma data de last_verified. Onde a evidência é mais fraca, o objeto diz isso em vez de arredondar.

Como é construído

Compilado e servido por Citarium, um framework de código-fonte disponível para transformar um grafo de conhecimento em um site, uma API, um servidor MCP e arquivos legíveis por agentes a partir de uma única fonte, sob avaliação externa.

O código do framework é licenciado sob a Business Source License 1.1 e seu repositório não é público. O que é público — e o que realmente importa para confiar em uma resposta — é este servidor, o corpus que ele serve e a fonte registrada por trás de cada afirmação: get_sources retorna no que qualquer afirmação se apoia, para que possa ser verificada em vez de confiada.

Este repositório é a face pública do servidor: seu manifesto e sua documentação. O corpus em si vive em futbolatlas.app.