Urantia Papers

Leia e pesquise os Urantia Papers por referência, palavra-chave ou significado, com entidades nomeadas e referências cruzadas bíblicas.

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidores MCP - Dê Acesso aos Agentes de IA aos Documentos de Urantia

Conecte o Claude Desktop, Cursor, Windsurf e outros agentes de IA à API e documentação dos Documentos de Urantia via MCP. 19 ferramentas, 2 modelos de recursos, 2 prompts, zero configuração.

Existem dois servidores MCP disponíveis, um para ler os Documentos de Urantia diretamente e outro para pesquisar neste site de documentação.

ServidorURLCapacidadesFinalidade
Servidor MCP da APIapi.urantia.dev/mcp19 ferramentas, 2 recursos, 2 promptsPesquisa, parágrafos, entidades, áudio, Bíblia (WEB) + referências cruzadas UB↔Bíblia
Servidor MCP de Documentaçãodocs.urantia.dev/mcp1 ferramentaPesquisar no site de documentação

Servidor MCP da API

A API dos Documentos de Urantia inclui um servidor Model Context Protocol (MCP) integrado que expõe endpoints da API como ferramentas, documentos/entidades como recursos e fluxos de trabalho de estudo como prompts que qualquer agente de IA pode usar nativamente.

https://api.urantia.dev/mcp

Listado nos registros oficiais

Este servidor está publicado nos registros canônicos que os clientes compatíveis com MCP consultam para descoberta:

  • Registro MCP (mantido pela Anthropic, oficial): dev.urantia/urantia-papers. Verificável: curl "https://registry.modelcontextprotocol.io/v0/servers?search=urantia"
  • Smithery: mercado comunitário com instalação em um clique + pontuação de qualidade 100/100

smithery badge

Instalação em um clique via Smithery

A maneira mais rápida de adicionar este servidor ao seu cliente MCP é via Smithery: ele gera o trecho de configuração correto para o seu cliente e cuida da instalação.

Configuração manual

Adicione o servidor à configuração do seu cliente MCP diretamente. Sem chave de API, sem instalação, sem etapa de build.

Adicione ao `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```

Reinicie o Claude Desktop. Você verá 19 ferramentas disponíveis.
Adicione ao `.mcp.json` na raiz do seu projeto:
```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```
Adicione às suas configurações de MCP:
```json theme={null}
{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}
```

Funciona com qualquer cliente que suporte transporte HTTP Streamable MCP.

Ferramentas Disponíveis

O servidor MCP expõe 19 ferramentas usando nomes com notação de ponto organizados em uma árvore de namespace navegável. Todas as ferramentas anunciam anotações somente leitura e vêm com esquemas de saída para respostas estruturadas.

Estrutura e Navegação

FerramentaDescrição
toc.getObtenha o sumário completo: todas as 4 partes e 197 documentos. Melhor ponto de partida.
papers.listListe todos os 197 documentos com metadados (id, título, partId, rótulos).
papers.getObtenha um único documento com todos os seus parágrafos. Suporta include_entities.
papers.sectionsObtenha todas as seções dentro de um documento, ordenadas por número de seção.

Parágrafos

FerramentaDescrição
paragraphs.getConsulte um parágrafo por referência. Suporta 3 formatos: "1:2.0.1", "2:0.1", "2.0.1".
paragraphs.contextObtenha um parágrafo com N parágrafos antes e depois (window configurável, 1-10).
paragraphs.randomObtenha um parágrafo aleatório. Ótimo para exploração.

Pesquisa

FerramentaDescrição
search.fulltextPesquisa de texto completo. Modos: and (padrão), or, phrase. Filtros: paper_id, part_id.
search.semanticPesquisa de similaridade semântica via embeddings vetoriais. Encontra passagens conceitualmente relacionadas.

Entidades

FerramentaDescrição
entities.listNavegue por mais de 4.400 entidades (seres, lugares, ordens, raças, religiões, conceitos). Filtre por type ou pesquise por q.
entities.getObtenha detalhes da entidade: nome, tipo, aliases, descrição, entidades relacionadas, contagem de citações.
entities.paragraphsObtenha todos os parágrafos que mencionam uma entidade específica.

Áudio

FerramentaDescrição
audio.getObtenha URLs de arquivos de áudio para um parágrafo. Aceita qualquer formato de referência.

Bíblia (World English Bible)

FerramentaDescrição
bible.booksListe todos os 81 livros (39 AT + 15 deuterocanônicos + 27 NT) com códigos OSIS, cânon, contagens de capítulos.
bible.bookObtenha os metadados de um único livro. Aceita OSIS, USFM, nomes completos e aliases (sem diferenciar maiúsculas de minúsculas).
bible.chapterObtenha todos os versículos de um capítulo, ordenados por número de versículo.
bible.verseObtenha um único versículo por bookCode, chapter, verse.
bible.verse.urantia_parallelsReferência cruzada reversa: os 10 principais parágrafos de Urantia semanticamente mais próximos de um versículo bíblico.
bible.search.semanticPesquisa semântica ao vivo em todos os 38.034 versículos bíblicos; os resultados chegam com seus parágrafos UB mais próximos já anexados.

Enriquecimento de referências cruzadas nas ferramentas existentes

paragraphs.get, paragraphs.random, search.fulltext e search.semantic aceitam dois booleanos opcionais que anexam vizinhos semânticos pré-computados a cada resultado:

ParâmetroO que você obtém
include_bible_parallelsOs 10 principais versículos bíblicos semanticamente mais próximos de cada parágrafo UB.
include_urantia_parallelsOs 10 principais parágrafos de Urantia semanticamente mais próximos de cada parágrafo UB (UB ↔ UB "veja também").

Ambos podem ser combinados. Os paralelos são pré-computados via similaridade de cosseno text-embedding-3-large, então adicioná-los é barato. Nota: estes são vizinhos semânticos, não paralelos linguísticos curados (por exemplo, Paramony de Faw), os melhores resultados tendem a ser conceituais em vez de citações de versículos.

Recursos

Além das ferramentas, o servidor expõe dois modelos de recursos que os clientes podem ler diretamente:

Modelo de URIDescrição
urantia://paper/{id}Um único documento renderizado como markdown de texto simples com cabeçalhos de seção e referências de parágrafos. Útil para contexto completo de documento em RAG ou sumarização.
urantia://entity/{id}Uma entidade (ser, lugar, ordem, raça, religião ou conceito) com descrição, aliases, entidades relacionadas e referências a todos os parágrafos que a mencionam.

Prompts

O servidor também publica dois modelos de prompt reutilizáveis para fluxos de trabalho de estudo comuns:

PromptArgumentosDescrição
study_assistanttopic (opcional)Prepara o modelo para atuar como guia de estudo dos Documentos de Urantia. Opcionalmente, foca a sessão em um tópico ou passagem específica.
comparative_theologytopic, traditionEstrutura uma comparação entre um ensinamento dos Documentos de Urantia e outra tradição religiosa ou filosófica (por exemplo, Budismo, Estoicismo).

Exemplos de Prompts

Uma vez conectado, tente perguntar ao seu agente de IA:

  • "Pesquise nos Documentos de Urantia passagens sobre amor": usa search.fulltext
  • "O que os Documentos de Urantia dizem sobre o que acontece após a morte?": usa search.semantic
  • "Leia o Documento 1 sobre o Pai Universal": usa o recurso urantia://paper/1
  • "Mostre-me o parágrafo 2:5.10 com contexto ao redor": usa paragraphs.context
  • "Encontre todas as entidades do tipo 'lugar'": usa entities.list
  • "Quais entidades são mencionadas no parágrafo 0:0.1?": usa paragraphs.get com include_entities
  • "Compare o que os Documentos de Urantia ensinam sobre a alma com a filosofia estoica": usa o prompt comparative_theology
  • "Encontre parágrafos de Urantia relacionados a Mateus 5:3": usa bible.verse.urantia_parallels
  • "Pesquise na Bíblia passagens sobre perdão e mostre os ensinamentos de Urantia relacionados": usa bible.search.semantic
  • "Mostre-me 0:0.1 com paralelos bíblicos e parágrafos de Urantia relacionados": usa paragraphs.get com include_bible_parallels e include_urantia_parallels

Como Funciona

O servidor MCP usa transporte HTTP Streamable, o que significa:

  • Sem processo local: ele roda no mesmo Cloudflare Worker que a API
  • Sem estado: cada requisição cria uma nova instância do servidor (sem sessões para gerenciar)
  • Mesmos limites de taxa que a API REST (100 requisições/minuto por IP)
  • Mesmos dados: as ferramentas MCP consultam o banco de dados diretamente, retornando os mesmos resultados que os endpoints REST

MCP vs REST

Ambos dão acesso aos mesmos dados. Escolha com base no seu caso de uso:

MCP (api.urantia.dev/mcp)REST (api.urantia.dev/*)
Melhor paraAgentes de IA (Claude, Cursor, etc.)Aplicativos, scripts, exploração manual
ProtocoloJSON-RPC sobre HTTP StreamableHTTP padrão
AutenticaçãoNenhumaNenhuma
Superfície19 ferramentas, 2 recursos, 2 promptsTodos os endpoints + /tools/openai, /tools/anthropic para uso com SDK
Formato de respostaBlocos de conteúdo MCPJSON com wrappers data/meta

Servidor MCP de Documentação

O Mintlify fornece um servidor MCP hospedado que permite que agentes de IA pesquisem nestas páginas de documentação, útil para descobrir endpoints, entender padrões de uso e aprender a API.

https://docs.urantia.dev/mcp

Configuração

Adicione ao `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%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"]
    }
  }
}
```
Adicione ao `.mcp.json` na raiz do seu projeto:
```json theme={null}
{
  "mcpServers": {
    "urantia-dev-docs": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest", "https://docs.urantia.dev/mcp"]
    }
  }
}
```

Ferramenta Disponível

FerramentaDescrição
SearchUrantiaDevPesquise na documentação para encontrar referências de endpoints, exemplos de código, guias e padrões de uso.

Exemplos de Prompts

  • "Como faço para pesquisar na API dos Documentos de Urantia?"
  • "Quais formatos de referência de parágrafo a API suporta?"
  • "Mostre-me como usar o endpoint de entidades"
  • "Quais vozes de áudio estão disponíveis?"

Usando Ambos os Servidores MCP

Para a melhor experiência, adicione ambos os servidores ao seu 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 da API (api.urantia.dev/mcp): 19 ferramentas para os Documentos de Urantia, a World English Bible e referências cruzadas entre eles
  • Servidor MCP de Documentação (docs.urantia.dev/mcp): 1 ferramenta para pesquisar neste site de documentação

Construindo um Servidor MCP Personalizado

Se você precisar de lógica personalizada (por exemplo, combinar múltiplas ferramentas, cache ou pré-processamento de resultados), você pode construir seu próprio servidor MCP que chama nossa API REST. Veja o tutorial Construa um Servidor MCP para um guia passo a passo.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.