프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Urantia Papers

제작자: urantia-hub버전 1.4.1i★ 1i클라우드에서 실행
레지스트리 이름dev.urantia/urantia-papers

설치 방법

What it does

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

  • Connects 클라우드에서 실행
  • Account or key No key needed
  • Category 검색 및 AI 기억

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 4/4 통과 · 내가 묻는 내용은 제작자 서버(api.urantia.dev)를 거쳐요 · ✓ 명령 확인 2026년 11월 13일

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음 · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지 · Team/Enterprise는 소유자(Owner)가 추가

  1. Claude의 Connectors 페이지 열기

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. “Add” → “Custom” → “Web”를 누르고 이 2칸 채우기

    여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요

    Name · 이름Urantia Papers
    Remote MCP server URL · 주소https://api.urantia.dev/mcp

    Claude가 찾은 로그인 설정 화면에서 Continue를 누르고 · Authentication은 제작자 안내대로(Sign in now, Sign in when needed, No sign in) 고른 뒤 Add를 누르세요

  3. 채팅에서 켜기

    +ConnectorsUrantia Papers

  4. 해 보기

    Urantia Papers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 Urantia Papers을 쓰고 있다고 하거나 답에 Urantia Papers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT 연결은 요금제에 따라 달라요

전체 MCP: 웹 ChatGPT Business, Enterprise, Edu · Pro: 읽기/가져오기 권한으로 연결, 데이터를 바꾸는 도구는 안 될 수 있어요 · Plus: 공식 문서 미확인, 플러그인 화면에 사용자 지정 MCP 추가 항목이 보이면 시도해 볼 수 있어요 · 웹만

  1. 웹 ChatGPT에서 MCP 추가 페이지 열기

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 이름과 주소 입력

    이름을 넣고 Connection에 주소를 붙여 넣은 뒤 경고에 체크하고 Create as a plugin을 누르세요

    Name · 이름Urantia Papers
    Connection · 주소https://api.urantia.dev/mcp
  3. 채팅에서 Urantia Papers 고르기

    새 채팅을 열고 입력 전에 플러그인 목록에서 Urantia Papers을 고르세요

  4. 해 보기

    Urantia Papers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ ChatGPT가 Urantia Papers을 쓰고 있다고 하거나 답에 Urantia Papers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 OpenAI 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Claude Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 터미널 열기

    Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기

  2. 이 명령을 붙여 넣고 Enter

    claude mcp add --transport http --scope user urantia-papers https://api.urantia.dev/mcp
  3. Claude Code에서 /mcp 입력

    Urantia Papers이 목록에 있고 연결됨으로 보이면 돼요

  4. 해 보기

    Urantia Papers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude Code가 Urantia Papers을 쓰고 있다고 하거나 답에 Urantia Papers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 Cursor 열기

    Cursor에서 열기

    Cursor가 설치를 확인하면 Install을 누르세요

  2. Cursor에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    Urantia Papers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Cursor가 Urantia Papers을 쓰고 있다고 하거나 답에 Urantia Papers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 VS Code 열기

    VS Code에서 열기

    VS Code가 설치를 확인하면 Install을 누르세요

  2. VS Code에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    Urantia Papers을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Urantia Papers을 쓰고 있다고 하거나 답에 Urantia Papers 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://api.urantia.dev/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Urantia Papers을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

Claude Code

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

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "urantia-papers": {
      "url": "https://api.urantia.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "urantia-papers": {
      "type": "http",
      "url": "https://api.urantia.dev/mcp"
    }
  }
}

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
확인된 도메인
✓ urantia.dev
연결 방식
클라우드에서 실행
전송 방식
streamable-http
최신 버전i
1.4.1
레지스트리 공개i
2026년 10월 27일
코드 마지막 변경i
2026년 11월 15일
제작자
urantia-hub
웹사이트
urantia.dev
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

모든 앱과 장단점 →

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 12일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • toc.get

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

  • papers.list

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

  • papers.get

    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 ent

  • papers.sections

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

  • paragraphs.random

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

  • paragraphs.get

    Look up paragraphs by reference. Supports three formats: globalId ("1:2.0.1"), standardReferenceId ("2:0.1"), or paperSectionParagraphId ("2.0.1"). The format is auto-detected. To read several paragraphs, pass them all in `refs` in one call (up to 20); for a passage with its neig

  • paragraphs.context

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

  • search.fulltext

    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

  • search.semantic

    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, relate

  • entities.list

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

  • entities.get

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

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

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

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

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

  • bible.chapter

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

  • bible.verse

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

  • bible.verse.urantia_parallels

    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 nei

  • 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. One query surfaces both Bible matches and the relevant Urantia content. Optional filters: `canon` (`ot`, `

  • works.list

    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 eac

  • works.search

    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 r

  • works.search.semantic

    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 t

  • works.read

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

  • works.urantia_parallels

    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.

  • quotes.verify

    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 an

  • cite.get

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

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 16일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 도메인 urantia.dev 기준으로 확인되었어요(레지스트리가 도메인 소유를 확인해요)

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 어제

  • – 해당 없음

    라이선스 있음

    해당 없음: urantia.dev 소유자가 직접 운영하는 클라우드 서버라 저장소 코드를 실행하지 않아요

  • ✓ 통과

    엔드포인트 응답

    1709ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 26개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

검색 및 AI 기억 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 6183개 중 76%보다 스타가 많아요
  • 이 카테고리의 다른 서버 6183개 중 67%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 6183개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Urantia Papers, 안전한가요?

해당하는 기본 점검 4개 중 4개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(1.4.1)은 20일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

제작자: every-app널리 사용됨★ 2.8만그저께 업데이트

클라우드에서 실행✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

제작자: exa-labs널리 사용됨★ 5.2천2개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · exa.aiPopNx 팀이 직접 써 봄

Mockserver

Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.

제작자: mock-server성장 중★ 5천20일 전 업데이트

내 컴퓨터에서 실행✓ 서비스 회사 · mock-server.com

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

제작자: MicrosoftDocs널리 사용됨★ 2천12개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · microsoft.comPopNx 팀이 직접 써 봄

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

제작자: proxysoul성장 중★ 1.6천2개월 전 업데이트

클라우드에서 실행✓ empryo.com
  • OpenSEO — 클라우드에서 동작, 설치 불필요 · 키 불필요
  • Exa — 클라우드에서 동작, 설치 불필요 · 키 불필요 · Claude 디렉터리에 있음
  • Mockserver — 컴퓨터에 설치 필요 · 키 불필요
  • Microsoft Learn MCP — 클라우드에서 동작, 설치 불필요 · 키 불필요 · Claude 디렉터리에 있음
  • Docs — 클라우드에서 동작, 설치 불필요 · 키 불필요

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

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

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:

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:

FormatExampleStructure
globalId1:2.0.1partId:paperId.sectionId.paragraphId
standardReferenceId2:0.1paperId:sectionId.paragraphId
paperSectionParagraphId2.0.1paperId.sectionId.paragraphId

Search

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:

{

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

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

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

# 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:

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:

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.