Hispanic Legacy

As contribuições da Espanha para a ciência, exploração e cultura mundiais, com fontes rigorosas

Documentação

Hispanic Legacy — servidor MCP

As contribuições da Espanha para a ciência, exploração e cultura mundiais, com fontes rigorosas

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 (streamable HTTP):

https://hispanic-legacy.com/mcp

Também listado no Smithery.

Adicione-o a um cliente

Claude Code

claude mcp add --transport http hispanic-legacy https://hispanic-legacy.com/mcp

Claude Desktop / qualquer cliente que leia mcpServers

{
  "mcpServers": {
    "hispanic-legacy": {
      "type": "streamable-http",
      "url": "https://hispanic-legacy.com/mcp"
    }
  }
}

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

Verifique se ele responde, sem nenhum cliente:

curl -s https://hispanic-legacy.com/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.

ferramentaargumentoso que faz
get_overviewVisã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.
searchquery, 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.
answerquestionResponda 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_entityidBusca um objeto de conhecimento por id, com suas afirmações e as fontes que cada afirmação cita.
get_topictagLista os objetos de conhecimento que possuem uma tag (tópicos são tags com respaldo de conteúdo).
get_relatedidVizinhos no grafo de um objeto: relações de saída e de entrada, cada uma com seu tipo de relação.
get_sourcesobject_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_latestlimit?Objetos de conhecimento verificados mais recentemente — um sinal de atualização.

O caminho pretendido é get_overviewsearch ou answerget_entityget_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 conhecimento307
fontes registradas403
tópicos publicados301
tipoobjetos
entidade287
comparação11
guia5
glossário3
faq1

Assunto: a expedição Balmis e a saúde pública inicial, cartografia e navegação, botânica e as expedições americanas, mineração e metalurgia, universidades e arquivos, e a historiografia da Lenda Negra — evidência, não polêmica.

Perguntas que ele foi construído para responder

  • Como a vacina contra a varíola foi realmente transportada através do Atlântico em 1803?
  • O que a Casa de Contratación fez com os mapas que coletou?
  • Quais afirmações sobre a Lenda Negra se baseiam em fontes primárias, e quais não?

Como é uma resposta na prática

Uma chamada real ao endpoint ao vivo — answer com "como a vacina contra a varíola foi transportada através do Atlântico" — retorna este structuredContent, resumido:

{
  "answered": true,
  "entity": {
    "id": "keeping-the-vaccine-alive-in-spanish-america",
    "name": "Keeping the vaccine alive: vaccine boards, conservators and human reservoirs in Spanish America, 1805-1815",
    "evidence_tier": "secondary",
    "confidence": 0.8,
    "last_verified": "2026-08-12",
    "canonical_url": "https://hispanic-legacy.com/k/keeping-the-vaccine-alive-in-spanish-america"
  },
  "claims": [
    {
      "text": "A colonial vaccine board published its own numbers, and they survive in print. The Semanario of Bogotá carried in 1808 a \"Noticia del número de personas que se han vacunado en esta capital…\"",
      "sources": [{ "title": "Semanario de la Nueva Granada, publicada por una sociedad de patriotas Granadinos, bajo la dirección de Francisco José de Caldas" }]
    }
  ]
}

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-se a 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ícieo que é
/llms.txto índice, como text/plain
/llms-full.txto corpus inteiro em um arquivo
/ai-index.jsontodas as superfícies que esta instância publica, com seu tipo de conteúdo
/api/index.jsonum documento JSON por objeto de conhecimento
/api/sources.jsono registro de fontes, completo
/.well-known/mcp/server.jsono 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.

Comportamentos que vale a pena conhecer antes de integrar

  • Somente POST. Todos os outros métodos respondem 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 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-o, cite-o. 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 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.

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 no 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 hispanic-legacy.com.