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.
langdev.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.
《尤兰提亚书》远程 MCP 服务器:浏览、检索并引用其 197 篇文稿,并与圣经及 21 部其他文本交叉参照。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/dev.urantia%2Furantia-papers/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"urantia-papers": {
"type": "http",
"url": "https://api.urantia.dev/mcp"
}
}
}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.
Interactive docs available at /docs (Swagger UI). OpenAPI spec at /openapi.json.
https://api.urantia.dev/mcp (setup guide)Official TypeScript SDKs are available on npm:
See docs.urantia.dev/sdks/overview for documentation.
The API accepts three reference formats — auto-detected from the string:
Search modes: and (all words, default), or (any word), phrase (exact match). Optional filters: paperId, partId.
Paragraphs include an audio field — a nested object keyed by model and voice, or null if no audio exists:
Available models and voices vary per paragraph. The dedicated /audio/:paragraphId endpoint returns just the audio data for a given paragraph.
Responses include Cache-Control headers. Cloudflare's CDN caches at the edge via s-maxage:
Recommended flow:
GET /toc — understand the book structurePOST /search — find relevant passagesGET /paragraphs/:ref/context?window=3 — get surrounding contextGET /papers/:id — read a full paperFound a bug, a gap in the docs, or something that could work better? Tell us. No authentication required.
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.
The API includes a built-in MCP server at https://api.urantia.dev/mcp — connect Claude Desktop, Cursor, or any MCP client to access:
urantia://paper/{id} (markdown) and urantia://entity/{id}study_assistant, comparative_theologyTo 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).
Public endpoints require no auth. User endpoints (/me/*) require a JWT. OAuth flow:
POST /auth/apps (admin) or self-service at accounts.urantiahub.com/appsPOST /auth/tokenAuthorization: Bearer <token>Access tokens are ES256 JWTs that last 15 minutes, with a refresh token. PKCE is supported for browser-based apps.
@logtail/edge — structured JSON logs with request metadataGET /health — verifies DB connectivityThe server runs at http://localhost:3000 by default.
Deployed to Cloudflare Workers. First-time setup:
Deploy:
Content sourced from urantia-papers-json — 197 papers, 1,626 sections, 14,500+ paragraphs with audio narration via cdn.urantia.dev.
This project is licensed under the MIT License.
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
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.
langList Papers
List all 197 papers of the Urantia Papers with their metadata (id, title, partId, labels), as a flat list.
langGet 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_entitiesGet Paper Sections
Get all sections within a paper, ordered by section number. Useful for understanding paper structure before reading specific sections.
langpaper_id必填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_parallelsGet 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_parallelsGet 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_entitiesFull-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_parallelsSemantic 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_parallelsList 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.
qpagetypelimitqueryGet Entity
Get detailed information about a specific entity by its slug ID. Returns name, type, aliases, description, related entities, and citation count.
entity_id必填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必填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必填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.
langGet 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必填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必填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必填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 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_limitList 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.
langSearch the Works
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`. Each result has `match`, `url`, and its nearest Urantia paragraphs (semantic parallels, not curated ones).
qpageworklimitqueryurantia_parallel_limitSemantic 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_limitRead 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必填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必填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 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已满足适用检查项的 100%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
npm install @urantia/api # Typed client for all endpointsnpm install @urantia/auth # OAuth client for accounts.urantiahub.comcurl -X POST https://api.urantia.dev/search \ -H "Content-Type: application/json" \ -d '{"q": "Universal Father", "limit": 10, "type": "and"}'{ "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 } } }}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"}'# 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 devnpx 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 hashbun run deploy