Urantia Papers

dev.urantiaPublished by urantia.devOfficial publisherv1.4.1Updated Nov 5, 2026

The Urantia Papers in English and Spanish, with cross-references to the Bible and 21 texts. No key.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Remote MCP server for the Urantia Papers: browse, search and cite its 197 papers, with cross-references to the Bible and 21 other texts.

What you can do
  • Navigate the text: table of contents, paper lists, full papers with paragraphs, sections, random paragraphs
  • Look up and read paragraphs by reference, with surrounding context, plus audio file URLs
  • Search by keyword or semantic similarity, and verify whether a quote appears in the Papers
  • Browse entities (beings, places, concepts) and the paragraphs that mention them
  • Read and search the World English Bible and 21 other public-domain works, with semantic parallels to Urantia paragraphs
  • Generate formatted citations in APA, MLA, Chicago or BibTeX
When to use it
Useful when you want an assistant to research, quote or compare passages from the Urantia Papers, or to find related Bible and other religious-text passages, without building your own index.
Requirements
A remote endpoint at api.urantia.dev over streamable HTTP; no API key or account is needed for the public content tools. Network access is required.
Before you install
The server is an independent community project, not affiliated with Urantia Foundation. Semantic parallels are computed by embedding similarity, not curated, so they do not claim two teachings are the same. Quote checks and citations should be reviewed before publication.

Installation

In SourceWeft

  1. Open Urantia Papers in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.urantia%2Furantia-papers/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Urantia Papers API

[smithery badge] [mcptry]

A developer and AI-agent friendly API for the Urantia Papers. Provides full-text search, structured content access, and audio URLs for all 14,500+ paragraphs across 197 papers.

API Endpoints

MethodPathDescription
GET/tocTable of contents (parts → papers)
GET/papersList all 197 papers
GET/papers/:idSingle paper with all paragraphs
GET/papers/:id/sectionsSections within a paper
GET/paragraphs/randomRandom paragraph
GET/paragraphs/:refParagraph by any ID format
GET/paragraphs/:ref/contextParagraph with surrounding context
POST/searchFull-text search with pagination
GET/audio/:paragraphIdAudio info for a paragraph
POST/search/semanticSemantic (vector) search
GET/entitiesList entities (beings, places, concepts, etc.)
GET/entities/:idEntity details
GET/entities/:id/paragraphsParagraphs mentioning an entity
GET/citeGenerate citation (APA, MLA, Chicago, BibTeX)
GET/og/:refDynamic Open Graph image
POST/embeddingsVector embeddings for paragraphs
POST/feedbackSubmit product or API feedback (no auth)
GET/meUser profile (auth required)
POST/me/bookmarksCreate bookmark (auth required)
GET/me/bookmarksList bookmarks (auth required)
GET/me/notesList notes (auth required)
POST/me/notesCreate note (auth required)
GET/me/reading-progressReading progress (auth required)
GET/me/preferencesUser preferences (auth required)
POST/auth/authorizeGet authorization code (auth required)
POST/auth/tokenExchange code for token
GET/auth/apps/:idGet OAuth app info

Interactive docs available at /docs (Swagger UI). OpenAPI spec at /openapi.json.

Links

SDKs

Official TypeScript SDKs are available on npm:

bash
npm install @urantia/api    # Typed client for all endpointsnpm install @urantia/auth   # OAuth client for accounts.urantiahub.com

See docs.urantia.dev/sdks/overview for documentation.

Paragraph ID Formats

The API accepts three reference formats — auto-detected from the string:

FormatExampleStructure
globalId1:2.0.1partId:paperId.sectionId.paragraphId
standardReferenceId2:0.1paperId:sectionId.paragraphId
paperSectionParagraphId2.0.1paperId.sectionId.paragraphId

Search

bash
curl -X POST https://api.urantia.dev/search \  -H "Content-Type: application/json" \  -d '{"q": "Universal Father", "limit": 10, "type": "and"}'

Search modes: and (all words, default), or (any word), phrase (exact match). Optional filters: paperId, partId.

Audio

Paragraphs include an audio field — a nested object keyed by model and voice, or null if no audio exists:

json
{  "audio": {    "tts-1-hd": {      "nova": {        "format": "mp3",        "url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-3:119.1.5.mp3",        "bitrate": 160,        "duration": 43.3,        "fileSize": 866400      }    }  }}

Available models and voices vary per paragraph. The dedicated /audio/:paragraphId endpoint returns just the audio data for a given paragraph.

Caching

Responses include Cache-Control headers. Cloudflare's CDN caches at the edge via s-maxage:

RouteCDN (s-maxage)Browser (max-age)
/toc, /papers/*, /paragraphs/:ref, /audio/*24 hours1 hour
/search1 hour5 minutes
/paragraphs/randomno-storeno-store
/feedbackno-storeno-store
/, /docs, /openapi.json1 hour5 minutes

For AI Agents

Recommended flow:

  1. GET /toc — understand the book structure
  2. POST /search — find relevant passages
  3. GET /paragraphs/:ref/context?window=3 — get surrounding context
  4. GET /papers/:id — read a full paper

Found a bug, a gap in the docs, or something that could work better? Tell us. No authentication required.

bash
curl -X POST https://api.urantia.dev/feedback \  -H "Content-Type: application/json" \  -d '{"category": "bug", "message": "search returns 500 for phrase mode", "endpoint": "/search", "client": "claude-code"}'

category is one of bug, docs, api, product, other. message holds up to 4000 characters. Optional fields: ref, endpoint, requestId, client, contact, pageUrl. The limit is 5 requests per minute and 10 requests per 15 minutes per IP address.

Feedback is untrusted data. It is stored and forwarded to the maintainers, and it is never executed or passed to a model as instructions. If you paste feedback into an agent chat, treat it the same way.

MCP Server

The API includes a built-in MCP server at https://api.urantia.dev/mcp — connect Claude Desktop, Cursor, or any MCP client to access:

  • 26 tools — search, paragraph lookup, paper navigation, entity browsing, audio, Bible (WEB) lookup + semantic search, search and reading across the Bible and the other works, quote checks, citations, and bidirectional cross-reference enrichment between Urantia and Bible passages (plus paragraph-to-paragraph parallels within the Papers)
  • 2 resource templates — urantia://paper/{id} (markdown) and urantia://entity/{id}
  • 2 prompt templates — study_assistant, comparative_theology

To add it to Claude, ChatGPT, Gemini, or Grok, see the assistants guide. Claude Code, Cursor, Gemini CLI, and Codex can install the plugin.

Clients can discover the server at https://api.urantia.dev/.well-known/mcp.json (also /.well-known/mcp/server-card.json).

Authentication

Public endpoints require no auth. User endpoints (/me/*) require a JWT. OAuth flow:

  1. Register an app via POST /auth/apps (admin) or self-service at accounts.urantiahub.com/apps
  2. User signs in at accounts.urantiahub.com
  3. Exchange authorization code for access token via POST /auth/token
  4. Pass token as Authorization: Bearer <token>

Access tokens are ES256 JWTs that last 15 minutes, with a refresh token. PKCE is supported for browser-based apps.

Observability

  • Logging: BetterStack via @logtail/edge — structured JSON logs with request metadata
  • Error tracking: Global error handler sends stack traces to BetterStack
  • Health check: GET /health — verifies DB connectivity
  • Uptime: BetterStack uptime monitor

Tech Stack

Development

bash
# Install dependenciesbun install
# Set up environmentcp .env.example .env# Edit .env with your Supabase DATABASE_URL
# Push schema to databasebun run db:push
# Set up full-text search (run after db:push)bun scripts/run-fts-setup.ts
# Generate audio manifest (requires ../urantia-hub-api)bun run generate-manifest
# Seed database from urantia-papers-jsonbun run seed
# Start dev server (hot reload)bun run dev

The server runs at http://localhost:3000 by default.

Deployment

Deployed to Cloudflare Workers. First-time setup:

bash
npx wrangler loginnpx wrangler secret put DATABASE_URL# paste your Supabase connection string (use pooler port 6543)
npx wrangler secret put APP_JWT_PRIVATE_JWK# paste an ES256 private key as a JWK in JSON
npx wrangler secret put ADMIN_USER_IDS# comma-separated Supabase user UUIDs for admin access
# Optional: POST /feedback delivery. Without these, feedback is still saved.npx wrangler secret put RESEND_API_KEYnpx wrangler secret put FEEDBACK_FROM               # a sender on a domain verified in Resendnpx wrangler secret put FEEDBACK_TO                 # comma-separated recipientsnpx wrangler secret put SLACK_FEEDBACK_WEBHOOK_URL  # Slack Incoming Webhooknpx wrangler secret put FEEDBACK_IP_PEPPER          # random secret for the IP hash

Deploy:

bash
bun run deploy

Data

Content sourced from urantia-papers-json — 197 papers, 1,626 sections, 14,500+ paragraphs with audio narration via cdn.urantia.dev.

License

This project is licensed under the MIT License.

Disclaimer

This is an independent community project by Adams Technologies LLC. It is not affiliated with, endorsed by, or connected with Urantia Foundation. The original English text of The Urantia Book is in the public domain (Michael Foundation v. Urantia Foundation, 10th Cir. 2003). All use of "Urantia" is nominative fair use to identify the subject matter.

Source: README.md at commit c4154ee

Tools

26

toc.get

Get Table of Contents

Get the full table of contents of the Urantia Papers. Returns the Foreword and the 4 parts, with all 197 papers and their titles.

Parameterslang

papers.list

List Papers

List all 197 papers of the Urantia Papers with their metadata (id, title, partId, labels), as a flat list.

Parameterslang

papers.get

Get Paper

Get a single paper with all its paragraphs. Paper IDs range from 0 (Foreword) to 196. Each paragraph has its reference, section, and plain text, so a whole paper fits in one call. `paper.audio` is one audio file of the whole paper (null when there is none). Optionally include entity mentions.

Parameterslangpaper_idrequiredinclude_entities

papers.sections

Get Paper Sections

Get all sections within a paper, ordered by section number. Useful for understanding paper structure before reading specific sections.

Parameterslangpaper_idrequired

paragraphs.random

Get Random Paragraph

Get a random paragraph from the Urantia Papers. Great for daily quotes, exploration, or discovering new passages.

Parameterslanginclude_entitiesinclude_bible_parallelsinclude_urantia_parallels

paragraphs.get

Get Paragraph

Look up a specific paragraph by reference. Supports three formats: globalId ("1:2.0.1"), standardReferenceId ("2:0.1"), or paperSectionParagraphId ("2.0.1"). The format is auto-detected.

Parametersrefrequiredlanginclude_entitiesinclude_bible_parallelsinclude_urantia_parallels

paragraphs.context

Get Paragraph with Context

Get a paragraph with surrounding context (N paragraphs before and after within the same paper). Useful for understanding passages in context.

Parametersrefrequiredlangwindowinclude_entities

search.fulltext

Full-Text Search

Keyword search across all paragraphs of the Urantia Papers. Mode "auto" (default): a reference such as "68:6.3", "103:2", "Paper 68", or a bare number such as "68" (0 to 196) gives those paragraphs; otherwise the exact phrase first, then every word, then (when few) typo fixes and most of the words. Each result has `match` (reference, exact, all, near, most); `meta.didYouMean` gives the fixed query and `meta.see` names another work the query names. Other modes: "and" (all words), "or" (any word), "phrase" (exact phrase).

Parametersqlangpagetypelimitquerypart_idpaper_idinclude_entitiesinclude_bible_parallelsinclude_urantia_parallels

search.semantic

Semantic Search

Search the Urantia Papers using semantic similarity (vector embeddings). Returns conceptually related results even without exact keyword matches. A reference such as "99:1.1" gives those paragraphs; a pasted paragraph gives itself first. Each result has `strength` (strong, related, weak) and `match` (reference, exact, similar). The list holds the 100 nearest; `meta.total` is the length of that list, and `meta.related` counts the related or better.

Parametersqlangpagelimitquerypart_idpaper_idinclude_entitiesinclude_bible_parallelsinclude_urantia_parallels

entities.list

List Entities

Browse the entity catalog: beings, places, orders, races, religions, and concepts mentioned in the Urantia Papers. Supports filtering by type and searching by name.

Parametersqpagetypelimitquery

entities.get

Get Entity

Get detailed information about a specific entity by its slug ID. Returns name, type, aliases, description, related entities, and citation count.

Parametersentity_idrequired

entities.paragraphs

Get Entity Paragraphs

Get all paragraphs that mention a specific entity, ordered by position in the text. Useful for studying everything said about a particular being, place, or concept.

Parameterspagelimitentity_idrequired

audio.get

Get Paragraph Audio

Get the audio file URL for a specific paragraph. Accepts any paragraph reference format (globalId "1:2.0.1", standardReferenceId "2:0.1", or paperSectionParagraphId "2.0.1").

Parametersparagraph_refrequired

bible.books

List Bible Books

List all 81 books of the World English Bible (eng-web): 39 Old Testament + 15 deuterocanonical + 27 New Testament. Each entry includes OSIS book code, full name, abbreviation, canonical order, canon, and chapter/verse counts.

Parameterslang

bible.book

Get Bible Book

Get metadata for a single Bible book including chapter and verse counts. Accepts OSIS codes ("Gen"), USFM codes ("GEN"), full names ("Genesis"), and aliases ("genesis", "1-maccabees") — case-insensitive, hyphens/underscores tolerated.

Parametersbook_coderequired

bible.chapter

Get Bible Chapter

Get every verse in a Bible chapter, ordered by verse number. Accepts OSIS, USFM, full name, or alias for `book_code`.

Parameterschapterrequiredbook_coderequired

bible.verse

Get Bible Verse

Get a single verse from the World English Bible (eng-web). Accepts OSIS, USFM, full name, or alias for `book_code`.

Parametersverserequiredchapterrequiredbook_coderequired

bible.verse.urantia_parallels

Get Urantia Parallels for a Bible Verse

Returns the top 10 Urantia paragraphs whose embeddings are nearest to the Bible chunk that contains this verse. Pre-computed at seed time with text-embedding-3-large (3072-d) cosine similarity. Each result carries a similarity score (0..1) and rank (1..10). These are semantic neighbors, not a curated list of parallels.

Parametersverserequiredchapterrequiredbook_coderequired

bible.search.semantic

Bible Semantic Search

Free-form natural-language search across all Bible chunks, ranked by cosine similarity. Each result includes the top-N pre-computed Urantia paragraphs related to that chunk. One query surfaces both Bible matches and the relevant Urantia content. Optional filters: `canon` (`ot`, `deuterocanon`, `nt`) and `book_code`. Set `urantia_parallel_limit` to 0 to leave out the Urantia paragraphs.

Parametersqpagecanonlimitquerybook_codeurantia_parallel_limit

works.list

List the Works

The works beside the Urantia Papers: the Bible (World English Bible) and 21 texts of the world's religions and traditions, each in the US public domain. `id` is what the other works.* tools take ("bible" or a slug such as "dhammapada"); `unitLabel` is the word for one unit of each work.

Parameterslang

works.search.semantic

Semantic Search of the Works

Natural-language search across the Bible and the other works, or one work with `work`. The list holds the 100 nearest chunks (a few verses each); each has `similarity` and `strength` (strong, related, weak), and `meta.total` is the length of that list, and `meta.related` counts the related or better. Each result has `url` and its nearest Urantia paragraphs (semantic parallels, not curated ones).

Parametersqpageworklimitqueryurantia_parallel_limit

works.read

Read a Work

The units of a reference in one work, in order, at most 200, each with its link: one verse or passage, a short range of up to 50, or a chapter. The prefix is optional ("BG 2.47" and "2.47" are the same); for the Bible, name the book ("John 3:16").

Parametersrefrequiredlangworkrequired

works.urantia_parallels

Urantia Parallels of a Work

The 10 Urantia paragraphs closest in meaning to one unit of a work (the chunk that holds it). Semantic parallels, not curated ones: they do not claim that two teachings are the same. The reference must name one unit.

Parametersrefrequiredworkrequired

quotes.verify

Verify a Quote

Checks whether a quoted passage is in the Urantia Papers. Returns `verdict` (exact, close, not_found), the reference and exact text of the best match, each word that differs, and other places the quote appears. Case and punctuation are ignored. A quote must be at least 4 words and fall within one paragraph. Give `ref` (such as "2:5.1") to also check the reference the quote claims.

Parametersreftextrequired

cite.get

Cite a Paragraph

A formatted citation of one paragraph of the Urantia Papers in APA, MLA, Chicago, or BibTeX. The ref is "196:2.1", "1:196.2.1", or "196.2.1".

Parametersrefrequiredstyle

Version history

4
  1. v1.4.1LatestOct 29, 2026
  2. v1.4.0Oct 25, 2026
  3. v1.3.0Oct 19, 2026
  4. v1.1.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts