MCP server for the Urantia Papers

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 19 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

Claude, ChatGPT, 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

MCP Registry, as dev.urantia/urantia-papers
Smithery
Glama
cursor.directory

Reference

Available Tools

The MCP server exposes 19 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.

Tool	Description
`toc.get`	Get the full table of contents: all 4 parts and 197 papers. Best starting point.
`papers.list`	List all 197 papers with metadata (id, title, partId, labels).
`papers.get`	Get a single paper with all its paragraphs. Supports `include_entities`.
`papers.sections`	Get all sections within a paper, ordered by section number.

Paragraphs

Tool	Description
`paragraphs.get`	Look up a paragraph by reference. Supports 3 formats: `"1:2.0.1"`, `"2:0.1"`, `"2.0.1"`.
`paragraphs.context`	Get a paragraph with N paragraphs before and after (configurable `window`, 1-10).
`paragraphs.random`	Get a random paragraph. Great for exploration.

Search

Tool	Description
`search.fulltext`	Full-text search. Modes: `and` (default), `or`, `phrase`. Filters: `paper_id`, `part_id`.
`search.semantic`	Semantic similarity search via vector embeddings. Finds conceptually related passages.

Entities

Tool	Description
`entities.list`	Browse 4,400+ entities (beings, places, orders, races, religions, concepts). Filter by `type` or search by `q`.
`entities.get`	Get entity details: name, type, aliases, description, related entities, citation count.
`entities.paragraphs`	Get all paragraphs that mention a specific entity.

Audio

Tool	Description
`audio.get`	Get audio file URLs for a paragraph. Accepts any reference format.

Bible (World English Bible)

Tool	Description
`bible.books`	List all 81 books (39 OT + 15 deuterocanonical + 27 NT) with OSIS codes, canon, chapter counts.
`bible.book`	Get a single book’s metadata. Accepts OSIS, USFM, full names, and aliases (case-insensitive).
`bible.chapter`	Get all verses in a chapter, ordered by verse number.
`bible.verse`	Get a single verse by `bookCode`, `chapter`, `verse`.
`bible.verse.urantia_parallels`	Reverse cross-reference: top-10 Urantia paragraphs semantically nearest a Bible verse.
`bible.search.semantic`	Live semantic search over all 38,034 Bible verses; results arrive with their nearest UB paragraphs already attached.

Cross-reference enrichment on existing tools

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

Param	What you get
`include_bible_parallels`	Top-10 Bible verses semantically nearest each UB paragraph.
`include_urantia_parallels`	Top-10 Urantia paragraphs semantically nearest each UB paragraph (UB ↔ UB “see also”).

Both can be combined. Parallels are pre-computed via text-embedding-3-large cosine similarity, so adding them is cheap. Note: these are semantic neighbors, not curated linguistic parallels (e.g. Faw’s Paramony), best results trend conceptual rather than verse-citation.

Resources

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

URI Template	Description
`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:

Prompt	Arguments	Description
`study_assistant`	`topic` (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_theology`	`topic`, `tradition`	Structures 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 for	AI agents (Claude, Cursor, etc.)	Apps, scripts, manual exploration
Protocol	JSON-RPC over Streamable HTTP	Standard HTTP
Auth	None	None
Surface	19 tools, 2 resources, 2 prompts	All endpoints + `/tools/openai`, `/tools/anthropic` for SDK use
Response format	MCP content blocks	JSON 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

Tool	Description
`SearchUrantiaDev`	Search 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.

Getting Started

Data

SDKs

Integrations

Open Source

Support

Legal

MCP server for the Urantia Papers

Set up

Claude Code

Cursor

Gemini CLI

Claude, ChatGPT, Grok, and Gemini

Any other client

Where it is listed

Reference

Available Tools

Structure & Navigation

Paragraphs

Search

Entities

Audio

Bible (World English Bible)

Cross-reference enrichment on existing tools

Resources

Prompts

Example Prompts

How It Works

MCP vs REST

Docs MCP Server

Setup

Available Tool

Example Prompts

Building a Custom MCP Server

​Set up

​Claude Code

​Cursor

​Gemini CLI

​Claude, ChatGPT, Grok, and Gemini

​Any other client

​Where it is listed

​Reference

​Available Tools

​Structure & Navigation

​Paragraphs

​Search

​Entities

​Audio

​Bible (World English Bible)

​Cross-reference enrichment on existing tools

​Resources

​Prompts

​Example Prompts

​How It Works

​MCP vs REST

​Docs MCP Server

​Setup

​Available Tool

​Example Prompts

​Building a Custom MCP Server

Set up

Claude Code

Cursor

Gemini CLI

Claude, ChatGPT, Grok, and Gemini

Any other client

Where it is listed

Reference

Available Tools

Structure & Navigation

Paragraphs

Search

Entities

Audio

Bible (World English Bible)

Cross-reference enrichment on existing tools

Resources

Prompts

Example Prompts

How It Works

MCP vs REST

Docs MCP Server

Setup

Available Tool

Example Prompts

Building a Custom MCP Server