Urantia Papers

urantia-hub/urantia-dev-api

Gives Claude direct access to The Urantia Book's full text through 19 tools covering search, paragraph lookup with context windows, paper navigation, entity browsing, and audio narration URLs. The API underneath is production grade with pgvector semantic search, multiple paragraph ID formats, and proper caching on Cloudflare's edge. You get structured access to all 197 papers and 14,500+ paragraphs, plus cross-reference tools that link passages to Bible verses or other UB sections. Useful if you're building study tools, comparative theology research, or need citation generation in APA/MLA/Chicago formats. The resource templates let you mount papers and entities directly into Claude's context as markdown.

tools: 26
transport: HTTP
last updated: Oct 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.urantia.dev/mcp --name urantia-papers

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

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

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 26 tools

Verified live against the running server on Nov 6, 2026.

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

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

Parameters* required

langstring

Language of the text and titles. "es" gives the Spanish translation (an AI translation, CC0); each paragraph then has `language` and a `translation` label. Default "eng".one of eng · esdefault: eng

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

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

Parameters* required

langstring

papers.getGet 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...3 params

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

Parameters* required

include_entitiesboolean

Include entity mentions in each paragraphdefault: false

langstring

paper_id*string

Paper ID (0-196). Example: '1'

papers.sectionsGet all sections within a paper, ordered by section number. Useful for understanding paper structure before reading specific sections.2 params

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

Parameters* required

langstring

paper_id*string

Paper ID (0-196). Example: '1'

paragraphs.randomGet a random paragraph from the Urantia Papers. Great for daily quotes, exploration, or discovering new passages.4 params

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

Parameters* required

include_bible_parallelsboolean

Include the top-10 Bible verses semantically nearest to this paragraph (Urantia → Bible). Pre-computed via text-embedding-3-large cosine similarity.default: false

include_entitiesboolean

Include entity mentionsdefault: false

include_urantia_parallelsboolean

Include the top-10 most-similar OTHER Urantia paragraphs ('see also'). Pre-computed via text-embedding-3-large cosine similarity.default: false

langstring

paragraphs.getLook 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.5 params

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.

Parameters* required

include_bible_parallelsboolean

Include the top-10 Bible verses semantically nearest to this paragraph (Urantia → Bible).default: false

include_entitiesboolean

Include entity mentionsdefault: false

include_urantia_parallelsboolean

Include the top-10 most-similar OTHER Urantia paragraphs ('see also' across the corpus).default: false

langstring

ref*string

Paragraph reference in any format. Examples: "1:2.0.1", "2:0.1", "2.0.1"

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

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

Parameters* required

include_entitiesboolean

Include entity mentionsdefault: false

langstring

ref*string

Paragraph reference. Examples: "1:2.0.1", "2:0.1", "2.0.1"

windownumber

Number of paragraphs before and after (1-10, default 2)default: 2

search.fulltextKeyword 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...11 params

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

Parameters* required

include_bible_parallelsboolean

Include the top-10 Bible verses semantically nearest to each result (Urantia → Bible).default: false

include_entitiesboolean

Include entity mentionsdefault: false

include_urantia_parallelsboolean

Include the top-10 most-similar OTHER Urantia paragraphs for each result.default: false

langstring

Language to search. "es" searches the Spanish text (words match with or without accents; "documento 1" is a reference) and gives Spanish rows. Default "eng".one of eng · esdefault: eng

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

paper_idstring

Filter to a specific paper ID

part_idstring

Filter to a specific part ID (1-4)

qstring

Alias for `query` (REST compatibility).

querystring

Search query. Example: "nature of God"

typestring

Search mode: auto, phrase, and, orone of auto · phrase · and · ordefault: auto

search.semanticSearch 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, rel...10 params

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, rel...

Parameters* required

include_bible_parallelsboolean

Include the top-10 Bible verses semantically nearest to each result (Urantia → Bible).default: false

include_entitiesboolean

Include entity mentionsdefault: false

include_urantia_parallelsboolean

Include the top-10 most-similar OTHER Urantia paragraphs for each result.default: false

langstring

Language of the results. "es" gives the Spanish text and titles; the question can be in Spanish or English, and `strength` allows for the lower similarity of a Spanish question. Default "eng".one of eng · esdefault: eng

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

paper_idstring

Filter to a specific paper ID

part_idstring

Filter to a specific part ID (1-4)

qstring

Alias for `query` (REST compatibility).

querystring

Natural language query. Example: "What is the meaning of life?"

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

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

Parameters* required

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

qstring

Alias for `query` (REST compatibility).

querystring

Search entities by name or alias

typestring

Filter by entity typeone of being · place · order · race · religion · concept

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

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

Parameters* required

entity_id*string

Entity slug ID. Example: "god-the-father"

entities.paragraphsGet 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.3 params

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.

Parameters* required

entity_id*string

Entity slug ID. Example: "god-the-father"

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

audio.getGet 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").1 params

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").

Parameters* required

paragraph_ref*string

Paragraph reference. Example: "2:0.1"

bible.booksList 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.1 params

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.

Parameters* required

langstring

Language of the catalog words: titles, traditions, summaries, labels, chapter titles, and Bible book names. "es" gives them in Spanish (an AI translation, CC0) with a `catalogTranslation` label. Th...one of eng · esdefault: eng

bible.bookGet 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.1 params

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.

Parameters* required

book_code*string

Book identifier. Examples: "Gen", "GEN", "Genesis", "1Macc", "DanGr"

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

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

Parameters* required

book_code*string

Book identifier. Example: "Gen" or "Genesis"

chapter*integer

Chapter number (1-indexed)

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

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

Parameters* required

book_code*string

Book identifier. Example: "John" or "Joh"

chapter*integer

Chapter number

verse*integer

Verse number

bible.verse.urantia_parallelsReturns 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...3 params

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

Parameters* required

book_code*string

Book identifier. Example: "Matt"

chapter*integer

Chapter number

verse*integer

Verse number

bible.search.semanticFree-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`...7 params

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`...

Parameters* required

book_codestring

Restrict to a single book. Example: "Matt" or "Matthew"

canonstring

Filter by canon: ot, deuterocanon, ntone of ot · deuterocanon · nt

limitinteger

Bible results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

qstring

Alias for `query` (REST compatibility).

querystring

Natural language query. Example: "blessed are the poor"

urantia_parallel_limitinteger

How many Urantia paragraphs to attach per Bible result (0-10, default 3). 0 disables.default: 3

works.listThe 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...1 params

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

Parameters* required

langstring

works.searchKeyword search across the Bible and the other works, or one work with `work`. A reference such as "John 3:16", "Jn 3:16-18", "Dhp 183", or "BG 2.47" gives those units first. Otherwise the exact phrase first, then every word, then (when few) a typo fix in `meta.didYouMean`. Eac...6 params

Keyword search across the Bible and the other works, or one work with `work`. A reference such as "John 3:16", "Jn 3:16-18", "Dhp 183", or "BG 2.47" gives those units first. Otherwise the exact phrase first, then every word, then (when few) a typo fix in `meta.didYouMean`. Eac...

Parameters* required

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

qstring

Alias for `query` (REST compatibility).

querystring

Search query. Example: "love your enemies"

urantia_parallel_limitinteger

How many Urantia paragraphs to attach to each result (0-10, default 3).default: 3

workstring

One work only: "bible" or a work id from works.list, such as "dhammapada".

works.search.semanticNatural-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` count...6 params

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` count...

Parameters* required

limitinteger

Results per page (1-100)default: 20

pageinteger

Page number (0-indexed)default: 0

qstring

Alias for `query` (REST compatibility).

querystring

Search query. Example: "love your enemies"

urantia_parallel_limitinteger

How many Urantia paragraphs to attach to each result (0-10, default 3).default: 3

workstring

One work only: "bible" or a work id from works.list, such as "dhammapada".

works.readThe 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").3 params

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").

Parameters* required

langstring

ref*string

A unit, a short range, or a chapter: "John 3:16", "2.47", "Dhp 183", "John 3".

work*string

"bible", or a work id from works.list, such as "bhagavad-gita".

works.urantia_parallelsThe 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.2 params

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.

Parameters* required

ref*string

A unit, a short range, or a chapter: "John 3:16", "2.47", "Dhp 183", "John 3".

work*string

"bible", or a work id from works.list, such as "bhagavad-gita".

quotes.verifyChecks 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...2 params

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

Parameters* required

refstring

The reference the quote claims, such as "2:5.1".

text*string

The quoted passage to check. At least 4 words.

cite.getA 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".2 params

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".

Parameters* required

ref*string

The paragraph, such as "196:2.1".

stylestring

apa, mla, chicago, or bibtexone of apa · mla · chicago · bibtexdefault: apa

Readme

Urantia Papers API

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

View the full README on GitHub

Details

Repository: github.com/urantia-hub/urantia-dev-api
Website: urantia.dev
Transport: HTTP
Registry: MCP registry, active
Resources: 697
Prompts: 2
Tools verified: Nov 6, 2026