Skip to main content
Glama
wheelofheaven

Wheel of Heaven MCP Server

Official
by wheelofheaven
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp.wheelofheaven.world

Read-only MCP server for the Wheel of Heaven corpus. It wraps the static JSON API at api.wheelofheaven.world so AI agents can search and retrieve the corpus with full epistemic metadata (claim types, editorial passes, citations).

Design rationale and tool-surface spec: .claude/plans/strategy-mcp-server.md in the org .claude repo.

Endpoints

  • /mcp — Streamable HTTP (canonical)

  • /sse — legacy SSE transport

  • / — server info (JSON)

Related MCP server: sacred-texts-mcp

Install

Remote (recommended — nothing to run locally):

claude mcp add --transport http wheel-of-heaven https://mcp.wheelofheaven.world/mcp

Local stdio via npm (@wheelofheaven/mcp):

npx -y @wheelofheaven/mcp

Registry listing: world.wheelofheaven.mcp/corpus in the official MCP registry.

Tools

Fact layer — source-grounded data, no interpretation applied:

Tool

Purpose

search_corpus

Fuzzy full-text search over wiki, timeline, library books, articles, and news (~290 documents; token-AND with OR fallback)

get_entry

One wiki/timeline/articles/news entry as markdown with claim_type, editorial_pass, typed related-content edges, and canonical citation URLs; 9-language support via lang

get_passage

A chapter of a digitized primary source text as numbered paragraphs with stable reference IDs (e.g. GEN-1:26); ref filters to one verse

get_source

Bibliography lookup by stable ID or search — every record carries the source-program classification (family, stance, relation), critical sources included

compare_traditions

Rows from the comparative datasets: flood-myths, divine-council-index, theomachy-crossrefs, world-ages, prophets-and-religions

query_graph

Typed 1-hop ego network of any corpus node (see_also, in_body, cites_source, same_tradition, same_age, comparison_of)

Interpretation layer — explicitly the project's own reading, labeled as such:

Tool

Purpose

get_interpretation

The Wheel of Heaven framework's reading of a topic (curated context documents, or the closest wiki entry), always carrying an interpretation-layer notice

get_method

The editorial methodology: claim-type taxonomy, six-source rule, editorial passes — how to weigh everything else

Meta:

Tool

Purpose

get_glossary_term

Core terminology with renderings in all 9 site languages (exact-id match first)

Resources: the six /v1/context/* narrative documents (woh://context/{overview,hypothesis,terminology,timeline,sources,method}) plus woh://llms.txt.

Development

npm install
npm run dev        # wrangler dev on :8787
npm run typecheck
npm run deploy     # wrangler deploy (needs Cloudflare auth)

The server is stateless over the upstream API: every tool call fetches api.wheelofheaven.world/v1/…, with the ~600 KB search corpus cached in-memory per isolate for one hour (matching the API's edge-cache TTL).

Architecture

  • Cloudflare Workers + agents SDK (McpAgent Durable Object)

  • src/server.ts — transport-agnostic tool registration (reused by the future npm stdio build)

  • src/api.ts — /v1/ client + search-corpus cache

  • src/html.ts — deterministic body_html → markdown conversion

Related repositories

License

CC0-1.0 — like the corpus itself.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Ek-Chuah MCP

    Entheos69
    F
    license
    Not graded
    quality
    B
    maintenance
    Read-only MCP server that serves the Archivo Epistemico (epistemic graph), enabling AI to read and query the epistemic path autonomously via tools like search, get_via, resolve, and get_necesidad.
    -

  • bible-mcp

    nirajagarwal
    F
    license
    Not graded
    quality
    A
    maintenance
    An MCP server for Christian scholarship and research, providing read-only access to a SQLite corpus of 66-book BSB and 83-book WEB Bibles, original-language Greek/Hebrew word studies with Strong's and morphology, cross-references, patristic citations (Irenaeus, Justin Martyr, Apostolic Fathers), verse alignments, semantic and hybrid search over ~55,800 embeddings, and multi-work passage retrieval, interlinear lookup, and research-brief synthesis prompts.
    3
    -