# corpus

A read-only MCP server for the Wheel of Heaven corpus: myth search, primary texts, comparative datasets and a typed graph of links.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: wheelofheaven
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wheelofheaven/mcp.wheelofheaven.world
- Updated: 2026-08-22
- HTML: https://affpapa.org/en/nevibecode/mcp/corpus

## What it does

corpus sits in front of the static JSON API at `api.wheelofheaven.world/v1/` and hands your agent tools for searching and pulling corpus material, each result carrying epistemic metadata: claim types, editorial passes, citation URLs. Facts and interpretation are kept apart. The fact layer holds `search_corpus`, `get_entry`, `get_passage`, `get_source`, `compare_traditions` and `query_graph`. The interpretation layer is `get_interpretation` and `get_method`, and every answer from it is marked as the project's own reading.

Two ways to run it. The remote one starts nothing on your machine: the server lives on Cloudflare Workers, speaks Streamable HTTP at `/mcp`, and still exposes the older SSE transport at `/sse`. The local stdio build comes from `npx -y @wheelofheaven/mcp`. Nothing is stored server-side — each tool call hits the upstream API, and the roughly 600 KB search corpus is cached in memory per isolate for an hour, matching the API's edge-cache TTL.

Licensed CC0-1.0, same as the corpus. Read-only is the whole point: there are no write tools, so nothing goes back into the corpus through this server. Need offline access with no calls to an external API? The remote transport won't give you that — pick the stdio build instead.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.wheelofheaven.world/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http corpus https://mcp.wheelofheaven.world/mcp
```

2. **Platform CLI**
```bash
claude mcp add corpus -- npx -y @wheelofheaven/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add corpus --url https://mcp.wheelofheaven.world/mcp
```

2. **Platform CLI**
```bash
codex mcp add corpus -- npx -y @wheelofheaven/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "corpus": {
            "url": "https://mcp.wheelofheaven.world/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "corpus": {
            "command": "npx",
            "args": [
                "-y",
                "@wheelofheaven/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "corpus": {
            "type": "http",
            "url": "https://mcp.wheelofheaven.world/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "corpus": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@wheelofheaven/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http corpus https://mcp.wheelofheaven.world/mcp
```

2. **Platform CLI**
```bash
gemini mcp add corpus npx -y @wheelofheaven/mcp
```

## When to use it
- find mentions of a myth across the corpus from a free-text query
- pull a chapter of a primary source with stable paragraph IDs
- line up motifs across traditions from the comparative datasets
- inspect a node's typed edges: citations, body links, same age
- tell a sourced claim apart from the project's interpretation

## Example prompts
- Search the corpus for flood myths and show me the claim types on those entries
- Give me the primary-source chapter for `GEN-1:26` with numbered paragraphs
- Compare traditions from the flood-myths dataset and show the rows

## Similar
- [primekg](https://affpapa.org/en/nevibecode/skills/primekg.md) — skill · 1900 installs
- [OpenArx](https://affpapa.org/en/nevibecode/mcp/openarx.md) — MCP server · ★ 8
- [ncats-arax](https://affpapa.org/en/nevibecode/skills/ncats-arax.md) — skill · 869 installs
- [fojin — Buddhist Canon Tools](https://affpapa.org/en/nevibecode/mcp/fojin-buddhist-canon-tools.md) — MCP server · ★ 354
- [Alfanous - Quranic Search Engine](https://affpapa.org/en/nevibecode/mcp/alfanous-quranic-search-engine.md) — MCP server · ★ 286
- [clinicaltrialsgov-mcp-server](https://affpapa.org/en/nevibecode/mcp/clinicaltrialsgov-mcp-server.md) — MCP server · ★ 99

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md