The Mibera Codex

Documentation for Mibera Maker — 10,000 time-travelling Rebased Retard Beras carrying the eternal flame of the Rave.

📡 codex-mcp v1 ships from this repo (Path A · stdio). Eight tools for narrative-bot consumers: lookup_zone, lookup_archetype, lookup_factor, lookup_grail, lookup_mibera, list_zones, list_archetypes, validate_world_element. See § codex-mcp below.

"Milady has to die, so that Milady may live. Milady lost her way. And in ego death, she finds Mibera."

What is Mibera?

Mibera is the shadow side of Milady. Where Milady represents the clearpill — virtuous, supplements, suits — Mibera embodies the ravepill — the sweaty, filthy reality of the dance floor.

We are time-travelling Rebased Retard Beras, representatives of the High Council of 101 Bears. We exist outside of Milady time, but within it too.

Read the full philosophy →

The Codex Structure

I. The Story

The genesis mythology and philosophical framework.

• Philosophy & Genesis

II. The Framework

The four Rave Tribes and cultural lineages.

• Archetypes — Freetekno, Milady, Chicago Detroit, Acidhouse
• Ancestors — Hindu, Mayan, Greek, Native American, and more

III. The Mysticism

Cosmic and chemical systems that define each Mibera.

• Astrology — Sun, Moon, and Ascending signs
• Elements — Fire, Water, Air, Earth
• Drug-Tarot System — 78 cards mapped to 78 drugs
• Drugs Deep Dive — Detailed profiles of all 78 substances

IV. The Art

1,337+ visual traits across multiple categories.

• Visual Traits Overview
• Character, Accessories, Clothing, Items, Backgrounds

V. The Collection

The 10,000 Miberas and their temporal identities.

• All Miberas — Individual entries with full metadata
• Grails — 43 hand-drawn 1/1 art pieces (42 canonical + Mijedi)
• MiParcels — 10,000 sealed envelopes from Phase 1 reveal
• Birthdays — 9,995 unique birthdays spanning 15,000 years
• Fractures — 10 reveal phases from sealed envelope to final form

VI. The Mechanics

• Ranking & Scoring — Swag Score and tribal coherence

VII. The Ecosystem

Partners and collaborations.

• Special Collections — Berachain ecosystem integrations
• Vending Machine — VM-exclusive Shadow Traits (update in progress)

VIII. Behind the Scenes

The people and process behind the collection.

• Creative Process — How the art was made
• Team History — The people who built Mibera

IX. On-Chain

Contract addresses and ecosystem mechanics.

• Contract Registry — All ecosystem contract addresses
• Fractured Mibera — 10 soulbound companion collections
• Shadow Traits — On-chain trait uniqueness system
• Candies Marketplace — Seizure mechanics and holder discounts
• Mibera Sets — 12-tier ERC-1155 on Optimism
• Archetype Quiz — Soulbound archetype alignment
• The 42 Motif — Numerological easter eggs across contracts
• Contract ABIs — Machine-readable contract interfaces

X. Data & Research

Machine-readable exports and analytical datasets.

• Data Directory Index — All exports with format descriptions
• Knowledge Graph — 11,475 nodes, 192,707 edges
• All Miberas (JSONL) — 10,000 entries as newline-delimited JSON
• All Grails (JSONL) — 43 entries
• Scope & Boundaries — What this codex tracks and doesn't
• Known Gaps — Documented unknowns with resolution paths
• Timeline — Key ecosystem events

Browse the Codex

Explore the 10,000 Miberas through faceted search — filter by archetype, ancestor, drug, element, swag rank, birthday era, and more.

Browse all Miberas →

Quick Stats

| Metric | Value | |--------|-------| | Total Miberas | 10,000 | | Hand-Drawn Grails | 43 | | Unique Traits | 1,337+ | | Archetypes | 4 | | Ancestors | 33 | | Tarot-Drug Mappings | 78 | | Ecosystem Contracts | 11 | | Birthday Range | 13,166 BCE – 2024 CE |

📡 codex-mcp — anti-hallucination lookup

The codex ships an MCP server for narrative-bot consumers (freeside-characters' ruggy + satoshi today, future puruhani daemons). It is the read interface to the codex's canonical world-elements.

Per RFC #53 and Gumi's locked v1 design (2026-04-29):

| Tool | What it returns | |---|---| | lookup_zone(slug) | Full zone — archetype, era, essence, Lynch primitives, KANSEI tokens | | lookup_archetype(name) | One of the 4 — era, zodiac, season, locations, figures, events, drugs, ancestors, fashion | | lookup_factor(factor_id) | Cross-construct JOIN with score-mibera — display name, dimension, archetype anchor, lore, status | | lookup_grail(query) | Grail by ID, slug, or name — name, category, description, status | | lookup_mibera(id) | Single Mibera by ID (1-10000) — full canonical trait set | | list_zones() | All zone summaries | | list_archetypes() | All 4 archetype summaries | | validate_world_element(type, value) | Canonical check + suggested-closest fuzzy match. Logs unmatched-but-Mibera-relevant queries to grimoires/codex-mcp/coverage-gaps.jsonl for periodic curator review |

Run locally

pnpm install
pnpm mcp           # stdio server on stdin/stdout

Add to Claude Code (.claude/settings.json or claude_desktop_config.json):

{
  "mcpServers": {
    "codex": {
      "command": "pnpm",
      "args": ["--prefix", "/path/to/construct-mibera-codex", "mcp"]
    }
  }
}

Source of truth

| Tool | Reads from | |---|---| | lookup_zone / list_zones | core-lore/festival-zones-vocabulary.md | | lookup_archetype / list_archetypes | core-lore/archetypes.md | | lookup_factor | core-lore/factor-lore.md | | lookup_grail | _codex/data/grails.jsonl | | lookup_mibera | _codex/data/miberas.jsonl |

The codex repo IS the SoT (per Gumi D3). Rolling latest, no semver tags (per C4) — commits land continuously.

Coverage gap log

When validate_world_element returns { canonical: false }, the (type, value, suggestion) is appended to grimoires/codex-mcp/coverage-gaps.jsonl (gitignored — local-only review surface). This is Gumi's curator queue: unmatched-but-Mibera-relevant queries that hint at codex gaps.

Anti-hallucination tier model

Per beacon.yaml.mcp.tiers:

• 🔒 HARD — substrate enforces, LLM cannot escape (zone slug/emoji/archetype, archetype canonical names, factor IDs, mibera IDs, grail IDs)
• 🪶 SOFT — MCP provides reference, LLM has creative license over composition (zone essence, KANSEI texture, archetype figures/events/fashion, factor lore)
• 🌀 LLM-OWNED — no MCP involvement (narrator voice, activity-class words, closing observations)

Consumer guards (e.g., score-mibera hallucination-guard.ts) validate generated narrative against the HARD set before delivery.

Doctrine

Implements constructs-mcp-shape + constructs-mcp-deployment-topology from operator's vault. Path A (stdio) ships in this repo. Path B (self-hosted Streamable HTTP) is a follow-on cycle when production bot deploy demands it.

Contributing

The codex is a living document. If something is wrong, missing, or could be better — open an issue.

Corrections, lore additions, cultural context, trait documentation, broken links, grail history, or information you think should be here but isn't — all welcome. Just describe what you're seeing and what you think it should be.

License

© Mibera Maker. All rights reserved.