Urantia Papers

Official19 toolsLive

by urantia-hub · TypeScript

Free, open MCP server for The Urantia Papers. 197 papers, 14,500+ paragraphs, 4,400+ entities.

Free, open MCP server for The Urantia Papers. It provides access to 14,500+ paragraphs across 197 papers, and exposes structured content plus audio URLs for those paragraphs. The server offers full-text search and developer-friendly access to table of contents, papers, and paper sections.

🛠️ Key Features

Full-text search over Urantia Papers content
Structured access to parts, papers, paragraphs, and sections
Audio URLs for all 14,500+ paragraphs
API endpoints: /toc, /papers, /papers/:id, /papers/:id/sections

🚀 Use Cases

Programmatic retrieval of the table of contents (parts → papers)
Listing all 197 papers or fetching one paper by ID
Accessing sections for a specific paper
Building search experiences and retrieval pipelines

⚡ Developer Benefits

Semantic-search and search-oriented workflows
Topics covered: API, Cloudflare Workers, Hono, open-source
Works with Urantia-specific identifiers: papers, sections, paragraphs

⚠️ Limitations

The provided excerpt only lists the first part of /papers/:id/sections; full endpoint details are not included.

Topics

apicloudflare-workershonoopen-sourcesearchsemantic-searchurantiaurantia-book

Captured live from the server via tools/list.

toc.get

Get the full table of contents of the Urantia Book. Returns all 4 parts and 197 papers with their titles. This is the best starting point to understand the book structure.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

papers.list

List all 197 papers in the Urantia Book with their metadata (id, title, partId, labels). Use toc.get for a hierarchical view instead.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

papers.get

Get a single paper with all its paragraphs. Paper IDs range from 0 (Foreword) to 196. Optionally include entity mentions.

Parameters2

paper_id	string	required	Paper ID (0-196). Example: '1'
include_entities	boolean	optional	Include entity mentions in each paragraph

Raw schema

{
  "type": "object",
  "properties": {
    "paper_id": {
      "type": "string",
      "description": "Paper ID (0-196). Example: '1'"
    },
    "include_entities": {
      "default": false,
      "description": "Include entity mentions in each paragraph",
      "type": "boolean"
    }
  },
  "required": [
    "paper_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

papers.sections

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

Parameters1

paper_id

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "paper_id": {
      "type": "string",
      "description": "Paper ID (0-196). Example: '1'"
    }
  },
  "required": [
    "paper_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

paragraphs.random

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

Parameters3

include_entities	boolean	optional	Include entity mentions
include_bible_parallels	boolean	optional	Include the top-10 Bible verses semantically nearest to this paragraph (UB → Bible direction). Pre-computed via text-embedding-3-large cosine similarity.
include_urantia_parallels	boolean	optional	Include the top-10 most-similar OTHER Urantia paragraphs ('see also'). Pre-computed via text-embedding-3-large cosine similarity.

Raw schema

{
  "type": "object",
  "properties": {
    "include_entities": {
      "default": false,
      "description": "Include entity mentions",
      "type": "boolean"
    },
    "include_bible_parallels": {
      "default": false,
      "description": "Include the top-10 Bible verses semantically nearest to this paragraph (UB → Bible direction). Pre-computed via text-embedding-3-large cosine similarity.",
      "type": "boolean"
    },
    "include_urantia_parallels": {
      "default": false,
      "description": "Include the top-10 most-similar OTHER Urantia paragraphs ('see also'). Pre-computed via text-embedding-3-large cosine similarity.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

paragraphs.get

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.

Parameters4

ref	string	required	Paragraph reference in any format. Examples: "1:2.0.1", "2:0.1", "2.0.1"
include_entities	boolean	optional	Include entity mentions
include_bible_parallels	boolean	optional	Include the top-10 Bible verses semantically nearest to this paragraph (UB → Bible direction).
include_urantia_parallels	boolean	optional	Include the top-10 most-similar OTHER Urantia paragraphs ('see also' across the corpus).

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "Paragraph reference in any format. Examples: \"1:2.0.1\", \"2:0.1\", \"2.0.1\""
    },
    "include_entities": {
      "default": false,
      "description": "Include entity mentions",
      "type": "boolean"
    },
    "include_bible_parallels": {
      "default": false,
      "description": "Include the top-10 Bible verses semantically nearest to this paragraph (UB → Bible direction).",
      "type": "boolean"
    },
    "include_urantia_parallels": {
      "default": false,
      "description": "Include the top-10 most-similar OTHER Urantia paragraphs ('see also' across the corpus).",
      "type": "boolean"
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

paragraphs.context

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

Parameters3

ref	string	required	Paragraph reference. Examples: "1:2.0.1", "2:0.1", "2.0.1"
window	number	optional	Number of paragraphs before and after (1-10, default 2)
include_entities	boolean	optional	Include entity mentions

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "Paragraph reference. Examples: \"1:2.0.1\", \"2:0.1\", \"2.0.1\""
    },
    "window": {
      "default": 2,
      "description": "Number of paragraphs before and after (1-10, default 2)",
      "type": "number",
      "minimum": 1,
      "maximum": 10
    },
    "include_entities": {
      "default": false,
      "description": "Include entity mentions",
      "type": "boolean"
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search.fulltext

Full-text search across all Urantia Book paragraphs. Supports three modes: "and" (all words must appear, default), "or" (any word), "phrase" (exact phrase). Results ranked by relevance.

Parameters10

query	string	optional	Search query. Example: "nature of God"
q	string	optional	Alias for `query` (REST compatibility).
type	string	optional	Search mode: phrase, and, or
paper_id	string	optional	Filter to a specific paper ID
part_id	string	optional	Filter to a specific part ID (1-4)
page	integer	optional	Page number (0-indexed)
limit	integer	optional	Results per page (1-100)
include_entities	boolean	optional	Include entity mentions
include_bible_parallels	boolean	optional	Include the top-10 Bible verses semantically nearest to each result (UB → Bible).
include_urantia_parallels	boolean	optional	Include the top-10 most-similar OTHER Urantia paragraphs for each result.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query. Example: \"nature of God\"",
      "type": "string"
    },
    "q": {
      "description": "Alias for `query` (REST compatibility).",
      "type": "string"
    },
    "type": {
      "default": "and",
      "description": "Search mode: phrase, and, or",
      "type": "string",
      "enum": [
        "phrase",
        "and",
        "or"
      ]
    },
    "paper_id": {
      "description": "Filter to a specific paper ID",
      "type": "string"
    },
    "part_id": {
      "description": "Filter to a specific part ID (1-4)",
      "type": "string"
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "include_entities": {
      "default": false,
      "description": "Include entity mentions",
      "type": "boolean"
    },
    "include_bible_parallels": {
      "default": false,
      "description": "Include the top-10 Bible verses semantically nearest to each result (UB → Bible).",
      "type": "boolean"
    },
    "include_urantia_parallels": {
      "default": false,
      "description": "Include the top-10 most-similar OTHER Urantia paragraphs for each result.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search.semantic

Search the Urantia Book using semantic similarity (vector embeddings). Returns conceptually related results even without exact keyword matches. Requires OPENAI_API_KEY.

Parameters9

query	string	optional	Natural language query. Example: "What is the meaning of life?"
q	string	optional	Alias for `query` (REST compatibility).
paper_id	string	optional	Filter to a specific paper ID
part_id	string	optional	Filter to a specific part ID (1-4)
page	integer	optional	Page number (0-indexed)
limit	integer	optional	Results per page (1-100)
include_entities	boolean	optional	Include entity mentions
include_bible_parallels	boolean	optional	Include the top-10 Bible verses semantically nearest to each result (UB → Bible).
include_urantia_parallels	boolean	optional	Include the top-10 most-similar OTHER Urantia paragraphs for each result.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Natural language query. Example: \"What is the meaning of life?\"",
      "type": "string"
    },
    "q": {
      "description": "Alias for `query` (REST compatibility).",
      "type": "string"
    },
    "paper_id": {
      "description": "Filter to a specific paper ID",
      "type": "string"
    },
    "part_id": {
      "description": "Filter to a specific part ID (1-4)",
      "type": "string"
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "include_entities": {
      "default": false,
      "description": "Include entity mentions",
      "type": "boolean"
    },
    "include_bible_parallels": {
      "default": false,
      "description": "Include the top-10 Bible verses semantically nearest to each result (UB → Bible).",
      "type": "boolean"
    },
    "include_urantia_parallels": {
      "default": false,
      "description": "Include the top-10 most-similar OTHER Urantia paragraphs for each result.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

entities.list

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

Parameters5

type	string	optional	Filter by entity type
query	string	optional	Search entities by name or alias
q	string	optional	Alias for `query` (REST compatibility).
page	integer	optional	Page number (0-indexed)
limit	integer	optional	Results per page (1-100)

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Filter by entity type",
      "type": "string",
      "enum": [
        "being",
        "place",
        "order",
        "race",
        "religion",
        "concept"
      ]
    },
    "query": {
      "description": "Search entities by name or alias",
      "type": "string"
    },
    "q": {
      "description": "Alias for `query` (REST compatibility).",
      "type": "string"
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

entities.get

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

Parameters1

entity_id

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "description": "Entity slug ID. Example: \"god-the-father\""
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters3

entity_id	string	required	Entity slug ID. Example: "god-the-father"
page	integer	optional	Page number (0-indexed)
limit	integer	optional	Results per page (1-100)

Raw schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "description": "Entity slug ID. Example: \"god-the-father\""
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

audio.get

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

Parameters1

paragraph_ref

string

required

Paragraph reference. Example: "2:0.1"

Raw schema

{
  "type": "object",
  "properties": {
    "paragraph_ref": {
      "type": "string",
      "description": "Paragraph reference. Example: \"2:0.1\""
    }
  },
  "required": [
    "paragraph_ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

book_code

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "book_code": {
      "type": "string",
      "description": "Book identifier. Examples: \"Gen\", \"GEN\", \"Genesis\", \"1Macc\", \"DanGr\""
    }
  },
  "required": [
    "book_code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

bible.chapter

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

Parameters2

book_code	string	required	Book identifier. Example: "Gen" or "Genesis"
chapter	integer	required	Chapter number (1-indexed)

Raw schema

{
  "type": "object",
  "properties": {
    "book_code": {
      "type": "string",
      "description": "Book identifier. Example: \"Gen\" or \"Genesis\""
    },
    "chapter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chapter number (1-indexed)"
    }
  },
  "required": [
    "book_code",
    "chapter"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

bible.verse

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

Parameters3

book_code	string	required	Book identifier. Example: "John" or "Joh"
chapter	integer	required	Chapter number
verse	integer	required	Verse number

Raw schema

{
  "type": "object",
  "properties": {
    "book_code": {
      "type": "string",
      "description": "Book identifier. Example: \"John\" or \"Joh\""
    },
    "chapter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chapter number"
    },
    "verse": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Verse number"
    }
  },
  "required": [
    "book_code",
    "chapter",
    "verse"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

bible.verse.urantia_parallels

Returns the top 10 Urantia paragraphs whose embeddings are nearest to the Bible chunk that contains this verse — the reverse of `include_bible_parallels` on the UB side. 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* parallels, not curated. Treat results as starting points for further reading, not as authoritative parallels.

Parameters3

book_code	string	required	Book identifier. Example: "Matt"
chapter	integer	required	Chapter number
verse	integer	required	Verse number

Raw schema

{
  "type": "object",
  "properties": {
    "book_code": {
      "type": "string",
      "description": "Book identifier. Example: \"Matt\""
    },
    "chapter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chapter number"
    },
    "verse": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Verse number"
    }
  },
  "required": [
    "book_code",
    "chapter",
    "verse"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

bible.search.semantic

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 via `bible_parallels` (direction=bible_to_ub). One query surfaces both Bible matches and the relevant UB content. Optional filters: `canon` (`ot`, `deuterocanon`, `nt`) and `book_code`. Set `urantia_parallel_limit` to 0 to suppress the UB attachment. Requires OPENAI_API_KEY.

Parameters7

query	string	optional	Natural language query. Example: "blessed are the poor"
q	string	optional	Alias for `query` (REST compatibility).
canon	string	optional	Filter by canon: ot, deuterocanon, nt
book_code	string	optional	Restrict to a single book. Example: "Matt" or "Matthew"
page	integer	optional	Page number (0-indexed)
limit	integer	optional	Bible results per page (1-100)
urantia_parallel_limit	integer	optional	How many UB paragraphs to attach per Bible result (0-10, default 3). 0 disables.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Natural language query. Example: \"blessed are the poor\"",
      "type": "string"
    },
    "q": {
      "description": "Alias for `query` (REST compatibility).",
      "type": "string"
    },
    "canon": {
      "description": "Filter by canon: ot, deuterocanon, nt",
      "type": "string",
      "enum": [
        "ot",
        "deuterocanon",
        "nt"
      ]
    },
    "book_code": {
      "description": "Restrict to a single book. Example: \"Matt\" or \"Matthew\"",
      "type": "string"
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Bible results per page (1-100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "urantia_parallel_limit": {
      "default": 3,
      "description": "How many UB paragraphs to attach per Bible result (0-10, default 3). 0 disables.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md9 KBView on GitHub

Urantia Papers API

smithery badge

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

Method	Path	Description
GET	`/toc`	Table of contents (parts → papers)
GET	`/papers`	List all 197 papers
GET	`/papers/:id`	Single paper with all paragraphs
GET	`/papers/:id/sections`	Sections within a paper
GET	`/paragraphs/random`	Random paragraph
GET	`/paragraphs/:ref`	Paragraph by any ID format
GET	`/paragraphs/:ref/context`	Paragraph with surrounding context
POST	`/search`	Full-text search with pagination
GET	`/audio/:paragraphId`	Audio info for a paragraph
POST	`/search/semantic`	Semantic (vector) search
GET	`/entities`	List entities (beings, places, concepts, etc.)
GET	`/entities/:id`	Entity details
GET	`/entities/:id/paragraphs`	Paragraphs mentioning an entity
GET	`/cite`	Generate citation (APA, MLA, Chicago, BibTeX)
GET	`/og/:ref`	Dynamic Open Graph image
POST	`/embeddings`	Vector embeddings for paragraphs
POST	`/feedback`	Submit product or API feedback (no auth)
GET	`/me`	User profile (auth required)
POST	`/me/bookmarks`	Create bookmark (auth required)
GET	`/me/bookmarks`	List bookmarks (auth required)
GET	`/me/notes`	List notes (auth required)
POST	`/me/notes`	Create note (auth required)
GET	`/me/reading-progress`	Reading progress (auth required)
GET	`/me/preferences`	User preferences (auth required)
POST	`/auth/authorize`	Get authorization code (auth required)
POST	`/auth/token`	Exchange code for token
GET	`/auth/apps/:id`	Get OAuth app info

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

SDKs

Official TypeScript SDKs are available on npm:

bash

npm install @urantia/api    # Typed client for all endpoints
npm 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:

Format	Example	Structure
globalId	`1:2.0.1`	`partId:paperId.sectionId.paragraphId`
standardReferenceId	`2:0.1`	`paperId:sectionId.paragraphId`
paperSectionParagraphId	`2.0.1`	`paperId.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:

Route	CDN (s-maxage)	Browser (max-age)
`/toc`, `/papers/`, `/paragraphs/:ref`, `/audio/`	24 hours	1 hour
`/search`	1 hour	5 minutes
`/paragraphs/random`	no-store	no-store
`/feedback`	no-store	no-store
`/`, `/docs`, `/openapi.json`	1 hour	5 minutes

For AI Agents

Recommended flow:

GET /toc — understand the book structure
POST /search — find relevant passages
GET /paragraphs/:ref/context?window=3 — get surrounding context
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:

19 tools — search, paragraph lookup, paper navigation, entity browsing, audio, Bible (WEB) lookup + semantic search, 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

One-click install via Smithery.

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:

Register an app via POST /auth/apps (admin) or self-service at accounts.urantiahub.com/apps
User signs in at accounts.urantiahub.com
Exchange authorization code for access token via POST /auth/token
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

Runtime: Bun (dev) / Cloudflare Workers (production)
Framework: Hono + @hono/zod-openapi
Database: Supabase (PostgreSQL + pgvector)
ORM: Drizzle
Observability: BetterStack (logging, uptime)

Development

bash

# Install dependencies
bun install

# Set up environment
cp .env.example .env
# Edit .env with your Supabase DATABASE_URL

# Push schema to database
bun 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-json
bun 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 login
npx 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_KEY
npx wrangler secret put FEEDBACK_FROM               # a sender on a domain verified in Resend
npx wrangler secret put FEEDBACK_TO                 # comma-separated recipients
npx wrangler secret put SLACK_FEEDBACK_WEBHOOK_URL  # Slack Incoming Webhook
npx 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.

Install

Tools (19)

toc.getpapers.listpapers.getpapers.sectionsparagraphs.randomparagraphs.getparagraphs.contextsearch.fulltext

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.urantia.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "urantia-papers": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.urantia.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

toc.get

papers.list

papers.get

papers.sections

paragraphs.random

paragraphs.get

paragraphs.context

search.fulltext

search.semantic

entities.list

entities.get

entities.paragraphs

audio.get

bible.books

bible.book

bible.chapter

bible.verse

bible.verse.urantia_parallels

bible.search.semantic

Urantia Papers API

API Endpoints

Links

SDKs

Paragraph ID Formats

Search

Audio

Caching

For AI Agents

MCP Server

Authentication

Observability

Tech Stack

Development

Deployment

Data

License

Disclaimer

Install

Remote endpoint

Related servers