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

MCP server for the Urantia Papers

Connect Claude, Cursor, or any MCP client to the Urantia Papers. 28 tools, 2 resource templates, 2 prompts. No key needed.

The Urantia Papers API has a built-in Model Context Protocol (MCP) server. An AI agent that connects to it can read and search the Urantia Papers and quote them by reference.

https://api.urantia.dev/mcp

It has 28 read-only tools, 2 resource templates, and 2 prompts. It needs no key, no account, and no local process.

Not a developer? See AI Assistants for steps in Claude, ChatGPT, Grok, and Gemini.

Set up

Claude Code

Install the plugin. It adds the server and a research skill:

/plugin marketplace add urantia-hub/urantia-papers-claude-code-plugin
/plugin install urantia-papers@urantia-papers

Or add the server only:

claude mcp add --transport http urantia-papers https://api.urantia.dev/mcp

Cursor

Install the plugin from cursor.directory/plugins/urantia-papers, or add the server to your MCP settings:

{
  "mcpServers": {
    "urantia-papers": {
      "type": "http",
      "url": "https://api.urantia.dev/mcp"
    }
  }
}

Gemini CLI

Install the extension. It adds the server and the research skill:

gemini extensions install https://github.com/urantia-hub/urantia-papers-claude-code-plugin

ChatGPT

Install the Urantia Papers plugin from the ChatGPT plugin directory.

Claude, Grok, and Gemini

Add the address above as a custom connector. AI Assistants has the steps for each one.

Any other client

Use the same mcpServers block as for Cursor. The server works with any client that supports the Streamable HTTP transport.

Where it is listed

Reference

Available Tools

The MCP server exposes 28 tools using dot-notation names organized into a navigable namespace tree. All tools advertise read-only annotations and ship with output schemas for structured responses.

Structure & Navigation

ToolDescription
toc.getGet the full table of contents: all 4 parts and 197 papers. Best starting point.
papers.listList all 197 papers with metadata (id, title, partId, labels).
papers.getGet a single paper with all its paragraphs. Supports include_entities.
papers.sectionsGet all sections within a paper, ordered by section number.

Paragraphs

ToolDescription
paragraphs.getLook up a paragraph by reference. Supports 3 formats: "1:2.0.1", "2:0.1", "2.0.1".
paragraphs.contextGet a paragraph with N paragraphs before and after (configurable window, 1-10).
paragraphs.randomGet a random paragraph. Great for exploration.

Search

ToolDescription
search.fulltextFull-text search. Modes: and (default), or, phrase. Filters: paper_id, part_id.
search.semanticSemantic similarity search via vector embeddings. Finds conceptually related passages.

Entities

ToolDescription
entities.listBrowse 4,400+ entities (beings, places, orders, races, religions, concepts). Filter by type or search by q.
entities.getGet entity details: name, type, aliases, description, related entities, citation count.
entities.paragraphsGet all paragraphs that mention a specific entity.

Audio

ToolDescription
audio.getGet audio file URLs for a paragraph. Accepts any reference format.

Bible (World English Bible)

ToolDescription
bible.booksList all 81 books (39 OT + 15 deuterocanonical + 27 NT) with OSIS codes, canon, chapter counts.
bible.bookGet a single book's metadata. Accepts OSIS, USFM, full names, and aliases (case-insensitive).
bible.chapterGet all verses in a chapter, ordered by verse number.
bible.verseGet a single verse by bookCode, chapter, verse.
bible.verse.urantia_parallelsReverse cross-reference: top-10 Urantia paragraphs semantically nearest a Bible verse.
bible.search.semanticLive semantic search over all 38,034 Bible verses; results arrive with their nearest UB paragraphs already attached.

Works (the Bible and 21 other texts)

ToolDescription
works.listList the Bible and the 21 public domain texts, with tradition, kind, and summary.
works.searchKeyword search across the works, or one work with work. A reference such as "John 3:16" or "Dhp 183" returns that passage.
works.search.semanticSearch the works by meaning, with the nearest Urantia paragraphs on each result.
works.readRead a reference in one work: a verse, a passage, a range, or a chapter, each with its link.
works.urantia_parallelsThe 10 Urantia paragraphs closest in meaning to one unit of a work.

Quotes and citations

ToolDescription
quotes.verifyCheck whether a quote is in the Urantia Papers: exact, close, or not_found, with the reference.
cite.getA citation of one paragraph in APA, MLA, Chicago, or BibTeX.

Editions

ToolDescription
editions.listThe editions of the English text, from the 1955 first printing to srt-2024 (the default), with the count of changes each one adopted.
editions.variantsThe changes to the text since 1955. Filter by paper, ref, kind, edition (the changes adopted in that edition), or from and to (each change between two editions).

Cross-reference enrichment on existing tools

paragraphs.get, paragraphs.random, search.fulltext, and search.semantic accept three optional booleans that attach pre-computed semantic neighbors to each result:

ParamWhat you get
include_bible_parallelsTop-10 Bible verses semantically nearest each UB paragraph.
include_urantia_parallelsTop-10 Urantia paragraphs semantically nearest each UB paragraph (UB ↔ UB "see also").
include_scripture_parallelsThe 3 passages nearest in meaning from each of the 21 world religions texts, for each UB paragraph.

All three can be combined. Parallels are pre-computed via text-embedding-3-large cosine similarity, so adding them is cheap. They are found by meaning, so they link passages on the same subject also when the words differ. See How the links are made.

Spanish text

toc.get, papers.list, papers.get, papers.sections, paragraphs.get, paragraphs.context, and paragraphs.random accept lang: "es" for the Spanish translation of the text and titles. Each Spanish paragraph has language and a translation label (an AI translation, CC0). search.fulltext and search.semantic also accept lang: "es": the keyword search reads the Spanish text, and the semantic search takes a question in Spanish and returns the Spanish paragraphs. See Translations.

Editions of the text

paragraphs.get, paragraphs.context, and papers.get accept edition for an older edition of the English text: "1955", "srt-2009", "srt-2015", "srt-2018", "srt-2021", or "srt-2024" (the default). include_variants: true adds each change to a paragraph since 1955, with its year, 1955 page, and reason. editions.list and editions.variants list the editions and all the changes. See Editions of the text.

The answer to initialize has instructions: a short guide to the references, the tools, and the editions, for the agent to read.

Resources

In addition to tools, the server exposes two resource templates clients can read directly:

URI TemplateDescription
urantia://paper/{id}A single paper rendered as plaintext markdown with section headings and paragraph references. Useful for full-paper context in RAG or summarization.
urantia://entity/{id}An entity (being, place, order, race, religion, or concept) with description, aliases, related entities, and references to all paragraphs that mention it.

Prompts

The server also publishes two reusable prompt templates for common study workflows:

PromptArgumentsDescription
study_assistanttopic (optional)Primes the model to act as a study guide for the Urantia Papers. Optionally focuses the session on a specific topic or passage.
comparative_theologytopic, traditionStructures a comparison between a teaching of the Urantia Papers and another religious or philosophical tradition (e.g. Buddhism, Stoicism).

Example Prompts

Once connected, try asking your AI agent:

  • "Search the Urantia Papers for passages about love": uses search.fulltext
  • "What do the Urantia Papers say about what happens after death?": uses search.semantic
  • "Read Paper 1 about the Universal Father": uses the urantia://paper/1 resource
  • "Show me paragraph 2:5.10 with surrounding context": uses paragraphs.context
  • "Find all entities of type 'place'": uses entities.list
  • "What entities are mentioned in paragraph 0:0.1?": uses paragraphs.get with include_entities
  • "Compare what the Urantia Papers teach about the soul with Stoic philosophy": uses the comparative_theology prompt
  • "Find Urantia paragraphs related to Matthew 5:3": uses bible.verse.urantia_parallels
  • "Search the Bible for passages about forgiveness and show the related Urantia teachings": uses bible.search.semantic
  • "Show me 0:0.1 with both Bible parallels and related Urantia paragraphs": uses paragraphs.get with include_bible_parallels and include_urantia_parallels

How It Works

The MCP server uses Streamable HTTP transport, which means:

  • No local process: it runs on the same Cloudflare Worker as the API
  • Stateless: each request creates a fresh server instance (no sessions to manage)
  • Same rate limits as the REST API (200 requests per minute for each IP address)
  • Same data: MCP tools query the database directly, returning the same results as the REST endpoints

MCP vs REST

Both give you access to the same data. Choose based on your use case:

MCP (api.urantia.dev/mcp)REST (api.urantia.dev/*)
Best forAI agents (Claude, Cursor, etc.)Apps, scripts, manual exploration
ProtocolJSON-RPC over Streamable HTTPStandard HTTP
AuthNoneNone
Surface28 tools, 2 resources, 2 promptsAll endpoints + /tools/openai, /tools/anthropic for SDK use
Response formatMCP content blocksJSON with data/meta wrappers

Docs MCP Server

Mintlify provides a hosted MCP server that lets AI agents search these documentation pages, useful for discovering endpoints, understanding usage patterns, and learning the API.

https://docs.urantia.dev/mcp

Setup

Add the address to your client as a second server:

{
  "mcpServers": {
    "urantia-dev-docs": {
      "type": "http",
      "url": "https://docs.urantia.dev/mcp"
    }
  }
}

Available Tool

ToolDescription
SearchUrantiaDevSearch across the documentation to find endpoint references, code examples, guides, and usage patterns.

Example Prompts

  • "How do I search the Urantia Papers API?"
  • "What paragraph reference formats does the API support?"
  • "Show me how to use the entities endpoint"
  • "What audio voices are available?"

Building a Custom MCP Server

If you need custom logic (e.g., combining multiple tools, caching, or preprocessing results), you can build your own MCP server that calls our REST API. See the Build an MCP Server tutorial for a step-by-step guide.

This documentation is built and hosted on Mintlify, a developer documentation platform.