Hispanic Legacy

Las contribuciones de España a la ciencia, la exploración y la cultura mundial, rigurosamente documentadas

Documentación

Hispanic Legacy — Servidor MCP

Las contribuciones de España a la ciencia, la exploración y la cultura mundiales, rigurosamente documentadas

Un servidor MCP remoto basado en un grafo de conocimiento curado. Cada afirmación que devuelve está vinculada a una fuente registrada: las herramientas entregan afirmaciones con sus citas y un valor de confianza, para que un agente pueda mostrar su trabajo en lugar de afirmar sin más.

Nada que instalar. Es un endpoint alojado de HTTP transmisible por streaming:

https://hispanic-legacy.com/mcp

También está listado en Smithery.

Añadirlo a un cliente

Claude Code

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

Claude Desktop / cualquier cliente que lea mcpServers

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

Sin clave de API, sin cuenta, sin autenticación. Solo lectura.

Comprueba que responde, sin ningún 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"}'

Herramientas

Ocho, cada una con un outputSchema, y cada una devuelve structuredContent.

herramienta	argumentos	qué hace
`get_overview`	—	Visión general del corpus: qué sabe esta instancia, recuentos por tipo, etiquetas publicadas, frescura. Empieza aquí cuando llegues y aún no sepas si este corpus puede responder a tu pregunta.
`search`	`query`, `limit?`	Búsqueda de texto completo sobre el grafo de conocimiento. Insensible a acentos y apóstrofos, así que consulta con las palabras del usuario; cada resultado lleva su puntuación de relevancia y los campos en los que coincidió.
`answer`	`question`	Responde a una pregunta a partir del corpus. Devuelve las afirmaciones del objeto coincidente con fuentes y confianza — nunca una respuesta sin fuente.
`get_entity`	`id`	Obtiene un objeto de conocimiento por id, con sus afirmaciones y las fuentes que cita cada afirmación.
`get_topic`	`tag`	Lista los objetos de conocimiento que llevan una etiqueta (los temas son etiquetas respaldadas por contenido).
`get_related`	`id`	Vecinos de grafo de un objeto: relaciones salientes y entrantes, cada una con su tipo de relación.
`get_sources`	`object_id?`	El registro completo de fuentes, o solo las fuentes citadas por un objeto. Úsalo para juzgar el corpus antes de confiar en él.
`get_latest`	`limit?`	Objetos de conocimiento verificados más recientemente — una señal de frescura.

La ruta prevista es get_overview → search o answer → get_entity → get_related. get_overview existe porque un agente que acaba de llegar necesita saber si este corpus puede ayudar antes de gastar una llamada adivinando.

Qué contiene el corpus


objetos de conocimiento	307
fuentes registradas	403
temas publicados	301

tipo	objetos
entidad	287
comparación	11
guía	5
glosario	3
faq	1

Materia: la expedición Balmis y la salud pública temprana, cartografía y navegación, botánica y las expediciones americanas, minería y metalurgia, universidades y archivos, y la historiografía de la Leyenda Negra — evidencia, no polémica.

Preguntas para las que está construido

¿Cómo se transportó realmente la vacuna contra la viruela a través del Atlántico en 1803?
¿Qué hizo la Casa de Contratación con las cartas que recopiló?
¿Qué afirmaciones sobre la Leyenda Negra se apoyan en fuentes primarias, y cuáles no?

Cómo se ve una respuesta real

Una llamada real al endpoint en vivo — answer con "cómo se transportó la vacuna contra la viruela a través del Atlántico" — devuelve este structuredContent, recortado:

{
  "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" }]
    }
  ]
}

Observa lo que viaja con la respuesta: el nivel de evidencia, una confianza, la fecha de última verificación, y la fuente detrás de la afirmación — no como prosa que un agente tenga que parsear, sino como campos sobre los que puede actuar. Un agente puede negarse a usar una afirmación débil, o citar la fuente primaria directamente.

Cuando el corpus no puede responder, answered es false. No improvisa, y el fallo queda registrado para que se pueda cubrir el vacío.

Superficies legibles por máquina

El endpoint MCP es una de varias. El mismo corpus se sirve como archivos planos que un agente puede leer directamente:

superficie	qué es
`/llms.txt`	el índice, como `text/plain`
`/llms-full.txt`	todo el corpus en un solo archivo
`/ai-index.json`	cada superficie que publica esta instancia, con su tipo de contenido
`/api/index.json`	un documento JSON por objeto de conocimiento
`/api/sources.json`	el registro de fuentes, completo
`/.well-known/mcp/server.json`	el manifiesto de este servidor

Cada objeto de conocimiento tiene una página humana y un gemelo de máquina con el mismo id, con una URL canónica que coincide en todas ellas.

Comportamiento que conviene saber antes de integrar

Solo POST. Cualquier otro método responde 405 con una cabecera Allow: POST, OPTIONS.
Límite de velocidad: 120 solicitudes por minuto por cliente, contadas en un almacén compartido, publicado en cada respuesta como RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (los tres expuestos vía CORS). Falla en abierto: si el almacén no está disponible, la solicitud se atiende.
Entrada malformada recibe un error JSON-RPC correcto según la especificación — -32700 para cuerpos no parseables, -32602 para una herramienta desconocida — nunca una página de error HTML.
Los cuerpos de solicitud están limitados y se validan antes del transporte.

Privacidad

Sin cuentas, sin cookies, sin anuncios. El uso se mide de forma agregada con identificadores hash rotados diariamente y una retención de 200 días; las IP brutas nunca se almacenan. Política completa: PRIVACY.md.

Procedencia y licencia

El contenido de conocimiento es CC-BY-4.0: úsalo, cítalo. El registro de fuentes es público precisamente para que una afirmación pueda comprobarse en lugar de confiarse — get_sources devuelve en qué se apoya cualquier afirmación dada.

Las afirmaciones llevan un nivel de evidencia y una fecha de last_verified. Cuando la evidencia es más débil, el objeto lo dice en lugar de redondear.

Cómo está construido

Compilado y servido por Citarium, un marco de código disponible para convertir un grafo de conocimiento en un sitio web, una API, un servidor MCP y archivos legibles por agentes desde una única fuente, bajo evaluación externa.

El código del marco está licenciado bajo la Business Source License 1.1 y su repositorio no es público. Lo que es público — y lo que realmente importa para confiar en una respuesta — es este servidor, el corpus que sirve, y la fuente registrada detrás de cada afirmación: get_sources devuelve en qué se apoya cualquier afirmación dada, para que pueda comprobarse en lugar de confiarse.

Este repositorio es la cara pública del servidor: su manifiesto y su documentación. El corpus en sí vive en hispanic-legacy.com.