urantia.dev

Urantia Papers API

An API and MCP server for the Urantia Papers. Structured access to all 197 papers and more than 14,500 paragraphs, with full-text and semantic search, named…

Media & content#books

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

An API and MCP server for the Urantia Papers. Structured access to all 197 papers and more than 14,500 paragraphs, with full-text and semantic search, named entities, cross-references to public domain texts of the world's religions, and audio. No key needed. Docs: https://docs.urantia.dev

Endpoints 49

Table of Contents

  • GETGet the full table of contents/tocReturns the complete table of contents with parts and their papers. This is typically the first endpoint an AI agent should call to understand the book…

Papers

  • GETList all 197 papers/papersReturns metadata for all of the Urantia Papers, ordered by paper number. Use ?include=topEntities to attach a per-paper aggregate of the most-referenced named…
  • GETGet a paper with all its paragraphs/papers/:idReturns a single paper's metadata along with all its paragraphs in order. Paper IDs range from 0 (Foreword) to 196. Use ?include=entities to include typed…
  • GETGet sections within a paper/papers/:id/sectionsReturns all sections for a given paper, ordered by section number.

Paragraphs

  • GETGet a random paragraph/paragraphs/randomReturns a single random paragraph from the Urantia Papers. Useful for daily quotes or exploration. Response includes a navigation envelope with the previous…
  • GETGet a paragraph by reference/paragraphs/:refLook up a paragraph using any of three ID formats: globalId: "1:2.0.1" (partId:paperId.sectionId.paragraphId) standardReferenceId: "2:0.1"…
  • GETGet a paragraph with surrounding context/paragraphs/:ref/contextReturns the target paragraph along with N paragraphs before and after it (ordered by sort_id). Useful for AI agents doing RAG that need surrounding context…

Search

  • GETFull-text search across all paragraphs (GET)/search?q=stringSearch the Urantia Papers by keyword. Four search modes: auto (default): a reference such as 68:6.3, 103:2, Paper 68, or a bare number such as 68 (0 to 196)…
  • POSTFull-text search across all paragraphs/searchSearch the Urantia Papers by keyword. Four search modes: auto (default): a reference such as 68:6.3, 103:2, Paper 68, or a bare number such as 68 (0 to 196)…
  • GETSemantic similarity search across all paragraphs (GET)/search/semantic?q=stringSearch the Urantia Papers using semantic similarity (vector embeddings). Returns conceptually related results even without exact keyword matches. A reference…
  • POSTSemantic similarity search across all paragraphs/search/semanticSearch the Urantia Papers using semantic similarity (vector embeddings). Returns conceptually related results even without exact keyword matches. A reference…

Entities

  • GETList entities/entitiesBrowse the entity catalog (beings, places, orders, races, religions, concepts). Supports filtering by type and searching by name.
  • GETGet an entity by ID/entities/:idReturns a single entity by its slug ID.
  • GETGet paragraphs mentioning an entity/entities/:id/paragraphsReturns all paragraphs that mention a given entity, ordered by position in the text.

Languages

  • GETList available languages/languagesReturns available languages with translation progress (entity and paragraph counts).

Editions

  • GETList the editions of the English text/editionsReturns the editions of the English text that ?edition= accepts: the first printing (1955) and each Standard Reference Text (SRT). The API stores the newest…
  • GETList the changes to the text since 1955/editions/variantsReturns each change to the English text since the first printing, in the order of the Foundation's list of adopted corrections: the words before and after,…

Audio

  • GETGet audio URL for a paragraph/audio/:refReturns the audio file URL for a given paragraph. Accepts any paragraph reference format (globalId, standardReferenceId, or paperSectionParagraphId).

Bible

  • GETList all 81 Bible books/bible/booksReturns metadata for every book in the World English Bible (eng-web), including chapter and verse counts. Books are returned in canonical ecumenical order: 39…
  • GETGet a Bible book's metadata/bible/:bookCodeReturns metadata for a single book including chapter and verse counts. Accepts OSIS codes (e.g., Gen), USFM codes (GEN), full names (Genesis), and common…
  • GETGet all verses in a Bible chapter/bible/:bookCode/:chapterReturns every verse in the requested chapter, ordered by verse number. Accepts OSIS, USFM, full name, or alias for bookCode.
  • GETGet a single Bible verse/bible/:bookCode/:chapter/:verseReturns one verse from the World English Bible (eng-web). Accepts OSIS, USFM, full name, or alias for bookCode.
  • GETTop-10 Urantia paragraphs for a Bible verse/bible/:bookCode/:chapter/:verse/urantia-parallelsReturns the top 10 Urantia paragraphs whose embeddings are nearest to the Bible chunk containing this verse — the reverse of ?include=bibleParallels on the UB…
  • POSTSemantic search across the Bible (with UB paragraphs)/bible/search/semanticFree-form natural-language search across all 17,641 Bible chunks. Each result includes the top-N pre-computed Urantia paragraphs related to that chunk via the…

Scriptures

  • GETParagraphs close to many texts/scriptures/insights/shared-currentsUrantia paragraphs ranked by their mean percentile across the texts, highest first. Paper 131 is left out, because it is a collection of sayings from these…
  • GETParagraphs far from every text/scriptures/insights/farUrantia paragraphs ranked by distance: 1 minus their highest percentile in any text. Subjects that the scriptures do not discuss, such as geology, rank high,…
  • GETParagraphs and passages that are each other's best match/scriptures/insights/pairsA Urantia paragraph and a passage where each is the other's closest match in that text, under both text-embedding-3-large and text-embedding-3-small. These…
  • GETParagraphs that lean toward one text/scriptures/insights/leansUrantia paragraphs whose closest text stands out above their mean across texts, ranked by that gap. A lean counts only when the text has the paragraph in its…
  • GETList the world religions texts/scripturesReturns every scripture corpus with its religion, translator, year, source, license, and numbering notes. Each text is in the US public domain. urantiaSection…
  • GETGet one text and its chapters/scriptures/:corpusReturns the corpus facts, its divisions (chapters, or books for the Analects), each with its first and last reference, and its reading pages: a division, or…
  • GETGet scripture passages by reference/scriptures/:corpus/:refReturns the passages for a reference. Use 2.47 (chapter and verse), 2.47-49 (a range of up to 50), or 2 (a whole chapter). Each text has its own number of…
  • GETTop 10 Urantia paragraphs for a scripture passage/scriptures/:corpus/:ref/urantia-parallelsReturns the 10 Urantia paragraphs closest in meaning to the chunk that holds this passage. A chunk is a group of passages of about one Urantia paragraph in…
  • POSTSemantic search across the world religions texts/scriptures/search/semanticNatural-language search across every scripture chunk, or one corpus with corpus. Each result carries its top Urantia paragraphs (urantiaParallelLimit, 0 to…

Works

  • GETList the works beside the Papers/worksThe 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 endpoints…
  • GETKeyword search across the works (GET)/works/search?q=stringKeyword 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…
  • POSTKeyword search across the works/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…
  • GETSemantic search across the works (GET)/works/search/semantic?q=stringNatural-language search across the Bible and the other works, or one work with work. The list holds the 100 nearest chunks (a chunk is a few verses, about one…
  • POSTSemantic search across the works/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 chunk is a few verses, about one…
  • GETRead a work by reference/works/:work/:refThe units of a reference, in order, at most 200: one verse or passage, a short range of up to 50, or a whole chapter. Each has its link. The prefix of the…
  • GETTop 10 Urantia paragraphs for one unit of a work/works/:work/:ref/urantia-parallelsThe 10 Urantia paragraphs closest in meaning to the chunk that holds this unit. The reference must name one unit. The Urantia parallels are semantic, not…
  • GETNearest passages of the other works for one unit of a work/works/:work/:ref/work-parallelsThe 10 chunks of the other works and of the Bible that are closest in meaning to the chunk that holds this unit. The reference must name one unit of a text…

Citation

  • GETFormat a citation for a passage/cite?ref=2:5.1Generate a formatted citation for any passage of the Urantia Papers. Supports APA, MLA, Chicago, and BibTeX styles. Reference formats accepted:…

Quotes

  • POSTCheck a quote against the text/quotes/verifyChecks whether a quoted passage is in the Urantia Papers. It returns the reference, the exact text, and each word that differs. Case and punctuation are…

OG Images

  • GETGenerate a dynamic Open Graph image for a passage/og/:refReturns a 1200×630 PNG Open Graph image for a passage of the Urantia Papers. Designed for social media previews. Optional ?theme= parameter: default (blue),…

Embeddings

  • GETBulk export embedding vectors/embeddings/export?paperId=2Export embedding vectors for all paragraphs in a paper. The paperId query parameter is required. Returns JSONL (default) or JSON. Each line/item contains {…
  • GETGet the embedding vector for a paragraph/embeddings/:refReturns the embedding vector for a single paragraph. Use ?model=large (default) for the 3072-dimensional text-embedding-3-large vector — the canonical…

Tools

  • GETFunction-calling schemas for OpenAI/tools/openaiReturns the full Urantia Papers API tool catalog as ready-to-use OpenAI function-calling schemas. Drop into any OpenAI Chat Completions or Assistants call:…
  • GETFunction-calling schemas for Anthropic/tools/anthropicReturns the full Urantia Papers API tool catalog as ready-to-use Anthropic Messages tools definitions. Drop into any Anthropic Messages call: const { tools }…

Feedback

  • POSTSubmit product or API feedback. No authentication required./feedbackReport a bug, a gap in the docs, or an idea. People and AI agents can both use it. Send a category and a message. The other fields are optional and help us…

API details

Base URL
https://api.urantia.dev
http://localhost:3000
Authentication
None declared in the description
Operations
49 operations on 45 pathsGET 41POST 8
Main resources
Scriptures 9Works 8Bible 6Search 4Entities 3Papers 3Paragraphs 3Editions 2Embeddings 2Tools 2
Response formats
application/problem+json application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Urantia Papers API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Urantia Papers API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Get the full table of contents” (GET /toc), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Urantia Papers API?

An API and MCP server for the Urantia Papers. Structured access to all 197 papers and more than 14,500 paragraphs, with full-text and semantic search, named… It is listed under Media & content and has 49 endpoints.

Who publishes the Urantia Papers API?

It is listed from urantia.dev's public API description (an OpenAPI document), not published by urantia.dev on Swastik Codes. Anyone who controls urantia.dev can claim the profile by adding a DNS TXT record.

What is the base URL of the Urantia Papers API?

Its description lists 2 base URLs: https://api.urantia.dev, http://localhost:3000. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Urantia Papers API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Urantia Papers API have?

49 operations on 45 paths (41 GET, 8 POST). The largest groups are Scriptures, Works, Bible, Search.

Is forking the Urantia Papers API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.