Urantia Papers

npx add-mcp 'https://api.urantia.dev/mcp'

Servidores MCP: Dale a los Agentes de IA Acceso a los Documentos de Urantia

Conecta Claude Desktop, Cursor, Windsurf y otros agentes de IA a la API y documentación de los Documentos de Urantia mediante MCP. 19 herramientas, 2 plantillas de recursos, 2 indicaciones, cero configuración.

Hay dos servidores MCP disponibles: uno para leer los Documentos de Urantia directamente y otro para buscar en este sitio de documentación.

Servidor	URL	Capacidades	Propósito
Servidor MCP de API	api.urantia.dev/mcp	19 herramientas, 2 recursos, 2 indicaciones	Búsqueda, párrafos, entidades, audio, Biblia (WEB) + referencias cruzadas UB↔Biblia
Servidor MCP de Documentación	docs.urantia.dev/mcp	1 herramienta	Buscar en el sitio de documentación

Servidor MCP de API

La API de los Documentos de Urantia incluye un servidor Model Context Protocol (MCP) integrado que expone los endpoints de la API como herramientas, los documentos/entidades como recursos y los flujos de estudio como indicaciones que cualquier agente de IA puede usar de forma nativa.

https://api.urantia.dev/mcp

Listado en los registros oficiales

Este servidor está publicado en los registros canónicos que los clientes compatibles con MCP consultan para su descubrimiento:

• Registro MCP (gestionado por Anthropic, oficial): dev.urantia/urantia-papers. Verificable: curl "https://registry.modelcontextprotocol.io/v0/servers?search=urantia"
• Smithery: mercado comunitario con instalación en un clic + puntuación de calidad 100/100

Instalación en un clic mediante Smithery

La forma más rápida de añadir este servidor a tu cliente MCP es a través de Smithery: genera el fragmento de configuración correcto para tu cliente y gestiona la instalación.

Configuración manual

Añade el servidor a la configuración de tu cliente MCP directamente. Sin clave de API, sin instalación, sin paso de compilación.

Añade a `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```

Reinicia Claude Desktop. Verás 19 herramientas disponibles.

Añade a `.mcp.json` en la raíz de tu proyecto:

```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```

Añade a tu configuración de MCP:

```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```

Funciona con cualquier cliente que admita transporte HTTP Streamable MCP.

Herramientas disponibles

El servidor MCP expone 19 herramientas con nombres en notación de puntos organizados en un árbol de espacios de nombres navegable. Todas las herramientas anuncian anotaciones de solo lectura e incluyen esquemas de salida para respuestas estructuradas.

Estructura y navegación

Herramienta	Descripción
toc.get	Obtén la tabla de contenidos completa: las 4 partes y 197 documentos. El mejor punto de partida.
papers.list	Lista los 197 documentos con metadatos (id, título, partId, etiquetas).
papers.get	Obtén un documento completo con todos sus párrafos. Admite include_entities.
papers.sections	Obtén todas las secciones dentro de un documento, ordenadas por número de sección.

Párrafos

Herramienta	Descripción
paragraphs.get	Busca un párrafo por referencia. Admite 3 formatos: "1:2.0.1", "2:0.1", "2.0.1".
paragraphs.context	Obtén un párrafo con N párrafos antes y después (configurable window, 1-10).
paragraphs.random	Obtén un párrafo aleatorio. Ideal para exploración.

Búsqueda

Herramienta	Descripción
search.fulltext	Búsqueda de texto completo. Modos: and (predeterminado), or, phrase. Filtros: paper_id, part_id.
search.semantic	Búsqueda de similitud semántica mediante incrustaciones vectoriales. Encuentra pasajes conceptualmente relacionados.

Entidades

Herramienta	Descripción
entities.list	Explora más de 4.400 entidades (seres, lugares, órdenes, razas, religiones, conceptos). Filtra por type o busca por q.
entities.get	Obtén detalles de la entidad: nombre, tipo, alias, descripción, entidades relacionadas, recuento de citas.
entities.paragraphs	Obtén todos los párrafos que mencionan una entidad específica.

Audio

Herramienta	Descripción
audio.get	Obtén las URL de archivos de audio para un párrafo. Acepta cualquier formato de referencia.

Biblia (World English Bible)

Herramienta	Descripción
bible.books	Lista los 81 libros (39 AT + 15 deuterocanónicos + 27 NT) con códigos OSIS, canon, recuentos de capítulos.
bible.book	Obtén los metadatos de un solo libro. Acepta OSIS, USFM, nombres completos y alias (sin distinción de mayúsculas).
bible.chapter	Obtén todos los versículos de un capítulo, ordenados por número de versículo.
bible.verse	Obtén un solo versículo por bookCode, chapter, verse.
bible.verse.urantia_parallels	Referencia cruzada inversa: los 10 párrafos de Urantia semánticamente más cercanos a un versículo bíblico.
bible.search.semantic	Búsqueda semántica en vivo sobre los 38.034 versículos bíblicos; los resultados llegan con sus párrafos UB más cercanos ya adjuntos.

Enriquecimiento de referencias cruzadas en herramientas existentes

paragraphs.get, paragraphs.random, search.fulltext y search.semantic aceptan dos booleanos opcionales que adjuntan vecinos semánticos precalculados a cada resultado:

Parámetro	Qué obtienes
include_bible_parallels	Los 10 versículos bíblicos semánticamente más cercanos a cada párrafo UB.
include_urantia_parallels	Los 10 párrafos de Urantia semánticamente más cercanos a cada párrafo UB (UB ↔ UB "ver también").

Ambos se pueden combinar. Los paralelos se precalculan mediante similitud coseno text-embedding-3-large, por lo que añadirlos es económico. Nota: estos son vecinos semánticos, no paralelos lingüísticos curados (por ejemplo, Paramony de Faw); los mejores resultados tienden a ser conceptuales más que de citas de versículos.

Recursos

Además de las herramientas, el servidor expone dos plantillas de recursos que los clientes pueden leer directamente:

Plantilla de URI	Descripción
urantia://paper/{id}	Un documento completo renderizado como markdown de texto plano con encabezados de sección y referencias de párrafos. Útil para contexto de documento completo en RAG o resumen.
urantia://entity/{id}	Una entidad (ser, lugar, orden, raza, religión o concepto) con descripción, alias, entidades relacionadas y referencias a todos los párrafos que la mencionan.

Indicaciones

El servidor también publica dos plantillas de indicaciones reutilizables para flujos de estudio comunes:

Indicación	Argumentos	Descripción
study_assistant	topic (opcional)	Prepara al modelo para actuar como guía de estudio de los Documentos de Urantia. Opcionalmente enfoca la sesión en un tema o pasaje específico.
comparative_theology	topic, tradition	Estructura una comparación entre una enseñanza de los Documentos de Urantia y otra tradición religiosa o filosófica (por ejemplo, budismo, estoicismo).

Ejemplos de indicaciones

Una vez conectado, prueba a preguntar a tu agente de IA:

• "Busca en los Documentos de Urantia pasajes sobre el amor": usa search.fulltext
• "¿Qué dicen los Documentos de Urantia sobre lo que ocurre después de la muerte?": usa search.semantic
• "Lee el Documento 1 sobre el Padre Universal": usa el recurso urantia://paper/1
• "Muéstrame el párrafo 2:5.10 con contexto circundante": usa paragraphs.context
• "Encuentra todas las entidades de tipo 'lugar'": usa entities.list
• "¿Qué entidades se mencionan en el párrafo 0:0.1?": usa paragraphs.get con include_entities
• "Compara lo que los Documentos de Urantia enseñan sobre el alma con la filosofía estoica": usa la indicación comparative_theology
• "Encuentra párrafos de Urantia relacionados con Mateo 5:3": usa bible.verse.urantia_parallels
• "Busca en la Biblia pasajes sobre el perdón y muestra las enseñanzas de Urantia relacionadas": usa bible.search.semantic
• "Muéstrame 0:0.1 con paralelos bíblicos y párrafos de Urantia relacionados": usa paragraphs.get con include_bible_parallels y include_urantia_parallels

Cómo funciona

El servidor MCP utiliza transporte HTTP Streamable, lo que significa:

• Sin proceso local: se ejecuta en el mismo Cloudflare Worker que la API
• Sin estado: cada solicitud crea una instancia de servidor nueva (sin sesiones que gestionar)
• Mismos límites de velocidad que la API REST (100 solicitudes/minuto por IP)
• Mismos datos: las herramientas MCP consultan la base de datos directamente, devolviendo los mismos resultados que los endpoints REST

MCP vs REST

Ambos te dan acceso a los mismos datos. Elige según tu caso de uso:

	MCP (api.urantia.dev/mcp)	REST (api.urantia.dev/*)
Mejor para	Agentes de IA (Claude, Cursor, etc.)	Aplicaciones, scripts, exploración manual
Protocolo	JSON-RPC sobre HTTP Streamable	HTTP estándar
Autenticación	Ninguna	Ninguna
Superficie	19 herramientas, 2 recursos, 2 indicaciones	Todos los endpoints + /tools/openai, /tools/anthropic para uso con SDK
Formato de respuesta	Bloques de contenido MCP	JSON con envoltorios data/meta

Servidor MCP de Documentación

Mintlify proporciona un servidor MCP alojado que permite a los agentes de IA buscar en estas páginas de documentación, útil para descubrir endpoints, comprender patrones de uso y aprender la API.

https://docs.urantia.dev/mcp

Configuración

Añade a `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json theme={null}
{
  "mcpServers": {
    "urantia-dev-docs": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest", "https://docs.urantia.dev/mcp"]
    }
  }
}
```

Añade a `.mcp.json` en la raíz de tu proyecto:

```json theme={null}
{
  "mcpServers": {
    "urantia-dev-docs": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest", "https://docs.urantia.dev/mcp"]
    }
  }
}
```

Herramienta disponible

Herramienta	Descripción
SearchUrantiaDev	Busca en la documentación para encontrar referencias de endpoints, ejemplos de código, guías y patrones de uso.

Ejemplos de indicaciones

• "¿Cómo busco en la API de los Documentos de Urantia?"
• "¿Qué formatos de referencia de párrafos admite la API?"
• "Muéstrame cómo usar el endpoint de entidades"
• "¿Qué voces de audio están disponibles?"

Uso de ambos servidores MCP

Para la mejor experiencia, añade ambos servidores a tu cliente:

{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    },
    "urantia-dev-docs": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest", "https://docs.urantia.dev/mcp"]
    }
  }
}

• Servidor MCP de API (api.urantia.dev/mcp): 19 herramientas para los Documentos de Urantia, la World English Bible y referencias cruzadas entre ellos
• Servidor MCP de Documentación (docs.urantia.dev/mcp): 1 herramienta para buscar en este sitio de documentación

Creación de un servidor MCP personalizado

Si necesitas lógica personalizada (por ejemplo, combinar múltiples herramientas, almacenamiento en caché o preprocesamiento de resultados), puedes crear tu propio servidor MCP que llame a nuestra API REST. Consulta el tutorial Crear un servidor MCP para obtener una guía paso a paso.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.