Urantia Papers

dev.urantia由 urantia.dev 發布官方發布者v1.4.1更新於 Nov 5, 2026

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

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

《尤蘭提亞書》遠端 MCP 伺服器:瀏覽、檢索並引用其 197 篇文稿,並與聖經及 21 部其他文本交叉參照。

可以做什麼
  • 瀏覽文本結構:目錄、文稿清單、含段落的完整文稿、章節、隨機段落
  • 依參照格式查找並閱讀段落,取得前後文段落及音訊檔案網址
  • 依關鍵字或語意相似度檢索,並核驗某段引文是否出自本書
  • 瀏覽實體(存在者、地點、概念)及其被提及的段落
  • 閱讀並檢索《世界英語聖經》及 21 部其他公版著作,並提供與尤蘭提亞段落的語意對照
  • 產生 APA、MLA、Chicago 或 BibTeX 格式的引用
適用情境
適合讓助理研究、引用或比較《尤蘭提亞書》中的段落,或查找相關的聖經與其他宗教文本段落,而不必自行建立索引。
執行需求
需連線 api.urantia.dev 的遠端端點(streamable HTTP);公開內容工具不需 API 金鑰或帳號,但需要網路連線。
安裝前請注意
此專案為獨立社群專案,與 Urantia Foundation 並無關聯。語意對照由向量相似度計算而非人工整理,並不代表兩種教義相同。引文核驗與引用格式在正式使用前應人工複核。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Urantia Papers,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.urantia%2Furantia-papers/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源:README.md,提交 c4154ee

工具

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.

輸入參數lang

papers.list

List Papers

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

輸入參數lang

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.

輸入參數langpaper_id必填include_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.

輸入參數langpaper_id必填

paragraphs.random

Get Random Paragraph

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

輸入參數langinclude_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.

輸入參數ref必填langinclude_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.

輸入參數ref必填langwindowinclude_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).

輸入參數qlangpagetypelimitquerypart_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.

輸入參數qlangpagelimitquerypart_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.

輸入參數qpagetypelimitquery

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.

輸入參數entity_id必填

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.

輸入參數pagelimitentity_id必填

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

輸入參數paragraph_ref必填

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.

輸入參數lang

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.

輸入參數book_code必填

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

輸入參數chapter必填book_code必填

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

輸入參數verse必填chapter必填book_code必填

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.

輸入參數verse必填chapter必填book_code必填

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.

輸入參數qpagecanonlimitquerybook_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.

輸入參數lang

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

輸入參數qpageworklimitqueryurantia_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").

輸入參數ref必填langwork必填

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.

輸入參數ref必填work必填

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.

輸入參數reftext必填

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

輸入參數ref必填style

版本歷史

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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分