Futbol Atlas

Futbol Atlas — servidor MCP

As Regras do Jogo e as principais competições do futebol mundial, cada afirmação citada em 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 HTTP hospedado e transmitível por stream:

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 ele 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, atualização. 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 possuem uma tag (tópicos são tags com respaldo de conteúdo).
get_related	id	Vizinhos do 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-o para avaliar o corpus antes de confiar nele.
get_latest	limit?	Objetos de conhecimento verificados mais recentemente — um sinal de atualização.

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, o 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 intervir?
• Como uma equipe se classifica para a fase de liga da Champions League?

Como uma resposta realmente se parece

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 verificada 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 entre 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	todas as superfícies 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.

Comportamento que vale saber antes de integrar

• Somente POST. Qualquer outro método responde 405 com um cabeçalho Allow: POST, OPTIONS.
• Limite de taxa: 120 solicitaçõ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). Ele falha aberto: se o armazenamento estiver inacessível, a solicitaçã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.
• Os corpos das solicitações 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 rotativos diários 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-o, cite-o. O registro de fontes é público precisamente para que uma afirmação possa ser verificada em vez de confiada — get_sources retorna em que qualquer afirmação se baseia.

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

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 agente 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 em que qualquer afirmação se baseia, 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.