mibera-codex

name	mibera-codex
description	Canonical reference for the Mibera world. Ground every claim about miberas, grails, archetypes, zones, and score-mibera factors in canonical lore via a read-only MCP server.
homepage	https://codex.0xhoneyjar.xyz
mcp_endpoint	https://mcp.0xhoneyjar.xyz/codex/mcp
discovery	https://mcp.0xhoneyjar.xyz/codex/.well-known/mcp.json
license	MIT
publisher	0xHoneyJar

Mibera Codex Skill

A canonical reference for the Mibera world. When the user asks about a Mibera, a grail, an archetype (tribe), a festival zone, or a score-mibera factor — read this codex instead of inventing.

What's in canon

• 10,000 Miberas — each with archetype, ancestor, zodiac, full visual traits, drug, parcel ID
• 44 Grails — 1/1 NFTs grouped into nine categories (zodiac, element, luminary, concept, planet, ancestor, primordial, special, community)
• 4 Archetypes (tribes) — Freetekno · Milady · Chicago/Detroit · Acidhouse
• 5 Festival Zones — stonehenge · bear-cave · el-dorado · owsley-lab · the-warehouse
• 28 Score Factors — OG / NFT / Onchain signals mapped to lore

Connect

Add this MCP server to your agent's MCP configuration:

URL: https://mcp.0xhoneyjar.xyz/codex/mcp
Protocol: MCP 2025-06-18
Auth: none (public, read-only)
Discovery: /.well-known/mcp.json

Once connected, eight read-only tools appear in your client.

Tools

Tool	Use when…
lookup_mibera(id: integer)	the user names a specific mibera by ID (1–10000)
lookup_archetype(name: string)	the user names a tribe — Freetekno / Milady / Chicago/Detroit / Acidhouse
lookup_grail(query: string)	the user names a grail by id, slug, or display name (e.g. "Moon", "Aquarius", "the dark grail")
lookup_zone(slug: string)	the user names a festival zone by canonical slug
lookup_factor(factor_id: string)	a score-mibera factor ID surfaces (og:cubquest, nft:mibera, onchain:milady_burner, …) and you need its lore
list_archetypes()	discovering canonical tribe names before lookup
list_zones()	discovering canonical zone slugs before lookup
validate_world_element(type, value)	the keystone. Before claiming a tribe/zone/grail name, check it's canonical. Returns {canonical, suggested?, distance?}.

How to use

The codex returns json. Your agent makes prose. Three tiers govern what to look up:

Tier	Behavior
🔒 HARD	Mibera IDs · grail IDs · zone slugs · archetype names · factor IDs. Must look up. Null means null. Don't invent.
🪶 SOFT	Zone essence · archetype fashion · factor lore. May look up. Prefer codex prose where it exists; voice is yours.
🎙 LLM-OWNED	Narrator voice · transitions · atmosphere · response style. Compose freely.

Recommended pattern

1. Before claiming a tribe / zone / grail name → call validate_world_element(type, value).
2. If canonical: true → call the matching lookup_* tool for full detail.
3. If canonical: false with a suggestion → ask the user if they meant the suggestion, or use it.
4. If canonical: false with no suggestion → tell the user the codex doesn't list that thing. The codex never invents.

Example — grounding before narrating

user → "tell me about mibera 1606"
agent → lookup_mibera(1606)
codex → { id: 1606, traits: { background: "Pluto", ... } }
agent → "1606 wears Pluto on its back — the underworld grail. dust-toned outfit, eyes pointed at the abyss…"

Example — checking before claiming

user → "show me the Freetech archetype"
agent → validate_world_element("archetype", "Freetech")
codex → { canonical: false, suggested: "Freetekno", distance: 3 }
agent → "did you mean Freetekno? the codex doesn't list a Freetech tribe."

Example — listing the surface

user → "what are the festival zones?"
agent → list_zones()
codex → ["stonehenge", "bear-cave", "el-dorado", "owsley-lab", "the-warehouse"]
agent → "five zones. stonehenge is the elemental anchor, the warehouse is…"

What this skill is NOT

• The codex doesn't write — it returns json; the agent makes prose.
• The codex doesn't change at runtime — read-only, source-of-truth lives at https://github.com/0xHoneyJar/construct-mibera-codex.
• The codex doesn't police voice — only HARD-tier claims must look up; narration / atmosphere / observation stay open to the agent.

Source of truth

• Repo: https://github.com/0xHoneyJar/construct-mibera-codex
• Site: https://codex.0xhoneyjar.xyz
• MCP: https://mcp.0xhoneyjar.xyz/codex/mcp

When the codex doesn't know a term the user asked about, the call lands in coverage-gaps.jsonl for periodic curation. The codex grows in the direction of actual narrative pressure.