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.
| Servidor | URL | Capacidades | Finalidade |
|---|---|---|---|
| Servidor MCP da API | api.urantia.dev/mcp | 19 ferramentas, 2 recursos, 2 prompts | Pesquisa, parágrafos, entidades, áudio, Bíblia (WEB) + referências cruzadas UB↔Bíblia |
| Servidor MCP de Documentação | docs.urantia.dev/mcp | 1 ferramenta | Pesquisar 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
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
| Ferramenta | Descrição |
|---|---|
toc.get | Obtenha o sumário completo: todas as 4 partes e 197 documentos. Melhor ponto de partida. |
papers.list | Liste todos os 197 documentos com metadados (id, título, partId, rótulos). |
papers.get | Obtenha um único documento com todos os seus parágrafos. Suporta include_entities. |
papers.sections | Obtenha todas as seções dentro de um documento, ordenadas por número de seção. |
Parágrafos
| Ferramenta | Descrição |
|---|---|
paragraphs.get | Consulte um parágrafo por referência. Suporta 3 formatos: "1:2.0.1", "2:0.1", "2.0.1". |
paragraphs.context | Obtenha um parágrafo com N parágrafos antes e depois (window configurável, 1-10). |
paragraphs.random | Obtenha um parágrafo aleatório. Ótimo para exploração. |
Pesquisa
| Ferramenta | Descrição |
|---|---|
search.fulltext | Pesquisa de texto completo. Modos: and (padrão), or, phrase. Filtros: paper_id, part_id. |
search.semantic | Pesquisa de similaridade semântica via embeddings vetoriais. Encontra passagens conceitualmente relacionadas. |
Entidades
| Ferramenta | Descrição |
|---|---|
entities.list | Navegue por mais de 4.400 entidades (seres, lugares, ordens, raças, religiões, conceitos). Filtre por type ou pesquise por q. |
entities.get | Obtenha detalhes da entidade: nome, tipo, aliases, descrição, entidades relacionadas, contagem de citações. |
entities.paragraphs | Obtenha todos os parágrafos que mencionam uma entidade específica. |
Áudio
| Ferramenta | Descrição |
|---|---|
audio.get | Obtenha URLs de arquivos de áudio para um parágrafo. Aceita qualquer formato de referência. |
Bíblia (World English Bible)
| Ferramenta | Descrição |
|---|---|
bible.books | Liste todos os 81 livros (39 AT + 15 deuterocanônicos + 27 NT) com códigos OSIS, cânon, contagens de capítulos. |
bible.book | Obtenha os metadados de um único livro. Aceita OSIS, USFM, nomes completos e aliases (sem diferenciar maiúsculas de minúsculas). |
bible.chapter | Obtenha todos os versículos de um capítulo, ordenados por número de versículo. |
bible.verse | Obtenha um único versículo por bookCode, chapter, verse. |
bible.verse.urantia_parallels | Referência cruzada reversa: os 10 principais parágrafos de Urantia semanticamente mais próximos de um versículo bíblico. |
bible.search.semantic | Pesquisa 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âmetro | O que você obtém |
|---|---|
include_bible_parallels | Os 10 principais versículos bíblicos semanticamente mais próximos de cada parágrafo UB. |
include_urantia_parallels | Os 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 URI | Descriçã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:
| Prompt | Argumentos | Descrição |
|---|---|---|
study_assistant | topic (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_theology | topic, tradition | Estrutura 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.getcominclude_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.getcominclude_bible_parallelseinclude_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 para | Agentes de IA (Claude, Cursor, etc.) | Aplicativos, scripts, exploração manual |
| Protocolo | JSON-RPC sobre HTTP Streamable | HTTP padrão |
| Autenticação | Nenhuma | Nenhuma |
| Superfície | 19 ferramentas, 2 recursos, 2 prompts | Todos os endpoints + /tools/openai, /tools/anthropic para uso com SDK |
| Formato de resposta | Blocos de conteúdo MCP | JSON 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
| Ferramenta | Descrição |
|---|---|
SearchUrantiaDev | Pesquise 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.