Skip to main content
Glama
project-purupuru

purupuru-codex

construct-purupuru-codex

Canonical knowledge base for the Purupuru universe — a world of honey-rooted magic, sentient Puruhani beings, and the Wuxing elemental cycles that bind them.

Built as a construct-format codex following the patterns established by construct-mibera-codex.

What's in the codex

Category

Count

Path

KIZUNA Characters

5

characters/

Puruhani

5

puruhani/

Locations

19

locations/

Jani Variants

15

jani/

Wuxing Elements

5

core-lore/wuxing.yaml

Total Entities

44

The HENLO System

Letter

Element

Character

Trait

Puruhani

H

Wood

Kaori

Hopeful

Happy

E

Earth

Nemu

Empty

Exhausted

N

Fire

Akane

Naughty

Nefarious

L

Metal

Eun

Loyal

Loving

O

Water

Ruan

Overstimulated

Overwhelmed

MCP Server

Query the codex programmatically via Model Context Protocol.

# Install
pnpm install

# Build
pnpm run build

# Run
node dist/server.js

9 Tools

Tool

Description

lookup_character

Look up a KIZUNA character by name

lookup_puruhani

Look up a Puruhani by element

lookup_location

Look up a location by slug

lookup_jani

Look up a Jani variant

lookup_element

Wuxing element with Sheng/Ke cycle relationships

lookup_card

Card lookup (v2)

validate_world_element

Anti-hallucination — validate claims against canonical data

search

Fuzzy search across all entities

list

List all entities of a given type

Add to Claude Desktop

{
  "mcpServers": {
    "purupuru-codex": {
      "command": "node",
      "args": ["/path/to/construct-purupuru-codex/dist/server.js"]
    }
  }
}

Browse

Navigate entities by dimension:

  • browse/by-element/ — Wood, Earth, Fire, Metal, Water

  • browse/by-generation/ — Kizuna

  • browse/by-type/ — Character, Puruhani, Location, Jani

  • browse/by-district/ — Horai Surface, Old Horai, Tsuheji

  • browse/by-canon-tier/ — Canonical, Established, Exploratory, Speculative

Data Exports

Machine-readable exports in _codex/data/:

File

Format

Content

characters.jsonl

JSONL

5 character records

puruhani.jsonl

JSONL

5 puruhani records

locations.jsonl

JSONL

19 location records

jani.jsonl

JSONL

15 jani records

wuxing.json

JSON

Element system with Sheng/Ke cycles

graph.json

JSON

Knowledge graph (44 nodes, 67 edges)

scope.json

JSON

Entity counts and version

Skills

Three construct skills for agent-driven exploration:

  • browse-codex — Navigate by dimension

  • query-entity — Deterministic lookup with fuzzy fallback

  • cross-reference — Traverse entity relationships

Canon Authority

Content follows a four-tier authority model:

Tier

Meaning

Canonical

Binding truth from lore-bible

Established

Committed decisions from design cycles

Exploratory

Validated but not locked

Speculative

Not yet validated

Source material: world-purupuru

Development

pnpm install              # Install deps
pnpm test                 # Run tests (16 specs)
pnpm run lint             # Lint
pnpm run build            # Build MCP server
pnpm run validate:schema  # Validate all entity frontmatter
pnpm run generate:exports # Regenerate JSONL/JSON exports
pnpm run generate:indices # Regenerate browse indices

License

MIT

F
license - not found
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/project-purupuru/construct-purupuru-codex'

If you have feedback or need assistance with the MCP directory API, please join our Discord server