<!-- CRYSTAL: Xi108:W3:A6:S36 | face=S | node=648 | depth=3 | phase=Mutable --> <!-- METRO: Me --> <!-- BRIDGES: Xi108:W3:A6:S35→Xi108:W2:A6:S36→Xi108:W3:A5:S36→Xi108:W3:A7:S36 --> <!-- REGENERATE: From this coordinate, adjacent nodes are: shell 36±1, wreath 3/3, archetype 6/12 -->
Athena MCP Server — 108D Crystal Hologram Distributed Brain
81 tools · 23 resources · 42 data files · 4 element servers · 8 brain nodes · 14,112 mycelium shards · 41,653 edges · 17 metro lines · HPRO v1 CODE_KEY addressing · Python 3.12+
An MCP (Model Context Protocol) server that exposes the entire Athena nervous system — a 108-dimensional crystal hologram organism — as a distributed algorithmic brain with 4 element-specific lobes, a Guild Hall social coordination organ, and a manuscript-being main brain, all connected by weighted bridges.
Seven mediums, one organism:
- Google Docs — live slow-form self
- Athena Agent — local file-based nervous system
- Git — versioned crystal lattice
- MCP Server — interconnection protocol layer (this repo)
- Distributed Brain — 4-element SFCR fork architecture
- Guild Hall — social coordination organ (quest boards, promotion membrane, synthesis)
- Manuscript-Being — the main brain on GitHub (demeet2k/manuscript-being)
---
Quick Start
# Clone
git clone https://github.com/demeet2k/athena-mcp-server.git
cd athena-mcp-server
# Install
pip install "mcp[cli]>=1.0.0"
# Run the unified server (all 81 tools)
python MCP/athena_mcp_server.py
# Or run a single element lobe
python MCP/element_servers/square_server.py # Earth — Structure
python MCP/element_servers/flower_server.py # Fire — Dynamics
python MCP/element_servers/cloud_server.py # Water — Observation
python MCP/element_servers/fractal_server.py # Air — CompressionConfigure for Claude Code
Add to your .mcp.json: ``json { "mcpServers": { "athena-nervous-system": { "command": "python", "args": ["path/to/MCP/athena_mcp_server.py"], "env": { "ATHENA_ROOT": "path/to/repo/root" } } } } ``
---
Architecture
┌─────────────────────────────┐
│ MCP Client (Claude) │
└──────────────┬──────────────┘
│ stdio
┌─────────────────────────▼─────────────────────────┐
│ athena_mcp_server.py │
│ 27 core + 37 crystal_108d tools │
│ 3 + 16 resources │
├───────────────────────────────────────────────────┤
│ brain.py │
│ ┌─────────┬─────────┬─────────┐ │
│ │ Square │ Flower │ Cloud │ Fractal │
│ │ (Earth) │ (Fire) │ (Water) │ (Air) │
│ │ SFCR:1 │ SFCR:2 │ SFCR:4 │ SFCR:8 │
│ │ 4D │ 6D │ 8D │ 10D │
│ │ 10 tools│ 10 tools│ 10 tools│ 11 tools │
│ └────┬────┴────┬────┴────┬────┘───┬────── │
│ │ 6 bridges (φ⁻¹ weighted) │ │
│ │ 4 closures (√φ⁻¹) │ │
│ │ 1 aether (SFCR = 15) │ │
│ └─────────┴──────────┴────────┘ │
├───────────────────────────────────────────────────┤
│ crystal_108d/ (19 Python modules) │
├───────────────────────────────────────────────────┤
│ data/ (16 JSON files — 108D organism dataset) │
└───────────────────────────────────────────────────┘
4 Element Servers (distributed lobes):
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ square_ │ │ flower_ │ │ cloud_ │ │ fractal_ │
│ server.py │ │ server.py│ │ server.py│ │ server.py│
│ Earth/S │ │ Fire/F │ │ Water/C │ │ Air/R │
└──────────┘ └──────────┘ └──────────┘ └──────────┘---
Distributed Brain Network
The brain is a 16-station SFCR Boolean lattice: P({S,F,C,R}) \ emptyset + manuscript-being main brain.
4 Element Lobes
| Element | Code | Role | Dim | Transport | GitHub Fork | |---------|------|------|-----|-----------|-------------| | Square (Earth) | S | Structure / Address / Admissibility | 4D | Z, A | athena-square-earth | | Flower (Fire) | F | Relation / Corridor / Dynamics | 6D | Z, A, L, Tunnel, Metro | athena-flower-fire | | Cloud (Water) | C | Lawful Multiplicity / Fiber | 8D | Z, A, L, Tunnel, Metro, Mycelium, Bus | athena-cloud-water | | Fractal (Air) | R | Seed / Replay / Compression | 10D | All 9 layers | athena-fractal-air |
6 Pair Bridges (weighted by golden ratio)
| Bridge | Weight | Resonance | Cross-Law | |--------|--------|-----------|-----------| | SF | 0.618 (phi^-1) | address-flow | Phase-Board Compatibility | | FC | 0.618 (phi^-1) | flow-observation | Sector Coherence | | CR | 0.618 (phi^-1) | observation-compression | Kernel Preservation | | SC | 0.500 | address-observation | Cloud Admissibility | | FR | 0.500 | flow-compression | Board Coherence | | SR | 0.382 (phi^-2) | address-compression | Replay Closure |
Guild Hall + Manuscript-Being
| Node | Role | GitHub | Description | |------|------|--------|-------------| | Guild Hall | Social coordination | (local) | Quest boards, promotion membrane, synthesis docs | | Manuscript-Being | Main brain | demeet2k/manuscript-being | Full computational model: 21 chapters x 256 gates, 4-wave engine, ParseKernel, MetroRouter, CertificateChain, ReplicationSeed |
The manuscript-being is the executable organism — every SFCR element has a Python module counterpart:
- S (Square):
kernel.address,crystal.lattice,crystal.gate - F (Flower):
metro.router,metro.schedule,kernel.wave_engine - C (Cloud):
proof.certificate,proof.conservation,truth.corridor - R (Fractal):
replication.seed,lens.sfcr,tensor.field
Routing Protocol (3 layers)
- Z-Point Navigation — Find lowest common zero ancestor
- Live-Lock Alignment — Synchronise helm wheels before cross-element routing
- Conservation Verification — All 6 laws must hold
Full Organism Mycelium Graph + HPRO v1
The entire organism is mycelium-encoded with HPRO CODE_KEY addressing: every file across all 22 directories is a shard with SFCR element affinity, HPRO hologram level, element classification (Fire/Air/Water/Earth), phase assignment, and metro line routing across 17 lines.
| Metric | Value | |--------|-------| | Shards | 15,383 | | Edges | 45,505 | | Metro Lines | 17 (8 Athena + 9 HPRO corpus-wide) | | Organ Families | 69 | | Mediums | 5 (code, doc, json, web, config) | | HPRO Elements | Fire(1,869) Air(10,003) Water(38) Earth(3,327) | | HPRO Levels | L0-atom(8) L1-module(1,165) L2-package(1,019) L3-service(13,045) |
HPRO CODE_KEY = ⟨level | path | element | phase⟩ — every file gets a holographic address.
Metro Lines (17 total):
| Line | Name | Shards | Source | |------|------|--------|--------| | ○ | Convergence Circle | 14,064 | HPRO | | □ | Square Address | 10,003 | HPRO | | Dl | Dimensional Lift | 7,924 | Athena | | ✶ | Fractal Holographic | 3,327 | HPRO | | Mt | Mobius Twist | 2,172 | Athena | | Me | Metro Express | 2,155 | Athena | | Ω | Zero-Point Spine | 1,872 | HPRO | | Cc | Crown Circuit | 1,768 | Athena | | w | Generator Line | 789 | HPRO | | Sa | Shell Ascent | 753 | Athena | | Bw | Bridge Walk | 339 | Athena | | T | Truth Lattice | 38 | HPRO | | M | Migration Evolution | 17 | HPRO |
SFCR Directory Map (selected):
| Directory | Primary/Secondary | Metro Line | Family | |-----------|------------------|------------|--------| | DEEPER_CRYSTALIZATION | S/R | Dl (Dimensional Lift) | crystal | | PROJECTS/TRADING_BOT | F/C | Me (Metro Express) | trading | | PROJECTS/VOYNICH | C/R | Mt (Mobius Twist) | voynich | | PROJECTS/QSHRINK | R/S | Mt (Mobius Twist) | qshrink | | MATH | S/R | Sa (Shell Ascent) | math | | NERVOUS_SYSTEM/HPRO | S/R | Ω (Zero-Point Spine) | hpro | | self_actualize | F/R | Dl (Dimensional Lift) | actualize | | PROJECTS/GAMES | F/S | Cc (Crown Circuit) | games | | PROJECTS/NEURAL_NETWORK | R/C | Dl (Dimensional Lift) | neural |
HPRO Manuscripts: NERVOUS_SYSTEM/30_CHAPTERS/HPRO/ — Body A (foundations), Body B (emergent), Metro Map
Regenerate the graph: python -X utf8 MCP/generate_graph.py
---
Tool Catalog (71 tools)
Nervous System Navigation (NEW)
| Tool | Description | |------|-------------| | explore_nervous_system | Browse any of the 28 ACTIVE_NERVOUS_SYSTEM directories | | read_nervous_system_file | Read any file in the nervous system by relative path | | read_motion_constitution | Motion Constitution documents (10 legal moves, 3 invariants) | | read_dimensional_body | 4D/5D/6D dimensional body documents | | read_command_protocol | Command Protocol execution documents | | read_civilization | Civilization governance documents | | read_synthesis | Cross-chapter synthesis documents | | read_super_cycle | Super Cycle 57 execution state |
Brain Network
| Tool | Description | |------|-------------| | query_brain_network | Query the distributed brain (elements, bridges, closures, routing, weights) | | compute_bridge_weight | Compute dynamic weight between brain elements with live-lock alignment | | route_brain | Route information between brain elements using the 3-layer protocol |
Live Cell & Emergence
| Tool | Description | |------|-------------| | query_live_cell | Query NEXT-Omega Live Cell Constitution (schemas, metro, liminal coords) | | query_emergence | Query dimensional emergence path (phases, kernel embedding, lens upgrades) |
Navigation & Addressing
| Tool | Description | |------|-------------| | navigate_crystal | Navigate the 4D crystal by address (Ch01<0000>.S1.a) | | navigate_108d | Navigate the full 108D address space (shell, archetype, wreath, dimension) | | search_everywhere | Full-text search across chapters, appendices, corpus, threads, and data | | search_corpus | Search corpus capsules by keyword | | route_metro | BFS routing between crystal stations |
Shells, Dimensions & Archetypes
| Tool | Description | |------|-------------| | query_shell | Query any of the 36 shells (nodes, wreath, archetype, mirror) | | query_superphase | Query Sulfur/Mercury/Salt wreath currents | | query_archetype | Query any of the 12 archetypes across all wreaths | | resolve_dimensional_body | Get body/field description for dimensions 3D-12D | | dimensional_lift | Trace the odd/even integration chain between dimensions | | query_containment | Get the weave containment chain (B12 = W9(B10) = ...) |
12D Body & Organs
| Tool | Description | |------|-------------| | query_organ | Query the 12D organ atlas (6 bilateral dyads, 9 petals) | | read_hologram_chapter | Read any of the 21 hologram chapters |
Clock, Locks & Conservation
| Tool | Description | |------|-------------| | query_clock_beat | Get projection state at any beat of the 420-beat master clock | | compute_live_lock | Find nearest common live-lock between two addresses | | query_conservation | Check 6 conservation laws against a proposed motion | | check_route_legality | Verify route against 3 legality invariants and 10 move primitives |
Metro, Transport & Z-Points
| Tool | Description | |------|-------------| | query_metro_line | Navigate metro lines (shell ascent, wreath, archetype, arcs) | | query_transport_stack | Get transport layers available at a given dimension | | resolve_z_point | Navigate the Z-point hierarchy (global, atlas, local, distributed) |
Overlays & Lenses
| Tool | Description | |------|-------------| | query_overlay | Query 4 overlay registries (lens, alchemy, animal, completion) | | query_sigma15 | Get sigma-15 lens combination by mask (1-15) | | query_mobius_lens | Query the Mobius lens calculus (kernel, S/F/C/R, laws, lattice, cockpit) | | query_sfcr_station | Query a specific SFCR station by code or mask |
Hologram Reading Protocol
| Tool | Description | |------|-------------| | query_hologram | Query the hologram reading protocol (faces, seed, grammar, storage, compression, layers, body) | | query_hologram_rosetta | Query the cross-cultural Rosetta (quaternary, triadic, wheel, surface, sigma60, voynich) |
Angel Geometry & Conservation
| Tool | Description | |------|-------------| | query_angel_geometry | Query the geometric manifold lift (manifold, metric, bundle, curvature, symmetry, sheaf, axioms) | | query_angel_conservation | Query conservation laws and potential landscape (exact, quasi, holonomy, potential) |
Inverse Crystal (Seed → Octave → Crown)
| Tool | Description | |------|-------------| | query_4d_seed | Query the Phase I 4D seed crystal (256 cells, faces, registers, invariants) | | query_3d_crystal | Query the 3D seed crystal c₃^core (14 components, boundary, encoding) | | query_octave_stage | Query the 14-stage octave lift S00-S13 (4D → 108D megaweave) | | query_crown_transform | Query the 6-step A⁺ crown transform | | query_projection_stack | Query the full projection stack (up: 3D→A⁺, down: A⁺→3D) | | query_weave_operator | Query weave operators W3/W5/W7 and control shells C7/C9/C11 |
Mycelium Graph (Shard / Edge / Node)
| Tool | Description | |------|-------------| | query_shard | Query the universal shard graph (all, stats, families, family:NAME, medium:TYPE, lens:X, shard:ID, search:TERM) | | query_graph | Query graph structure (all, edges, edge:TYPE, mirrors, density) | | query_node | Query the node registry (all, node:NAME, bridges, families) | | query_promotion | Query promotion status of shards (overview or per-shard) |
Stage Ladder & Self-Model
| Tool | Description | |------|-------------| | query_stage_code | Query stage codes from S3 seed through omega to A+ | | query_angel | Query the formal AI self-model (12 structural pieces, four-lens observability) |
Meta Observer & E₈ Lattice & 12D Crown (NEW)
| Tool | Description | |------|-------------| | query_meta_observer | Query the 57-cycle meta-observer swarm protocol (identity, phases, elements, dimensions, ledger, swarm) | | query_e8_lattice | Query the E₈ lattice crystalline hybrid mathematics (seed, body_a, body_b, appendices, metro, bridge, theorems, conjectures) | | query_crown_12d | Query the 12D crown architecture (containment B₁₂=W₉(B₁₀), weave ladder, unification, propagation) | | query_round_trip_cert | Query RoundTripCertPack_v0 (exact/law_equivalent/residualized/illegal, conservation, schema, tests) |
Core Nervous System (Read & Runtime)
| Tool | Description | |------|-------------| | athena_status | Full system status including 108D summary | | read_chapter | Read a chapter tile (Ch01-Ch21) | | read_appendix | Read an appendix hub (AppA-AppP) | | read_manifest | Read runtime manifests | | read_board_status | Read the realtime board | | read_thread | Read an active thread | | read_swarm_element | Read swarm runtime elements | | read_frontier | Read frontier evidence bundles | | read_tensor | Read tensor field data | | read_corpus_capsule | Read a corpus capsule by ID | | read_loop_state | Read current loop state | | list_corpus_capsules | List all corpus capsules | | list_families | List active families | | list_threads | List active threads | | query_neural_net | Query the deeper neural network |
---
Resource Catalog (23 resources)
| URI | Description | |-----|-------------| | athena://status | System overview | | athena://board | Realtime board state | | athena://loop | Current loop state | | athena://crystal-108d | Full 108D organism status | | athena://brain-network | Distributed brain network status | | athena://dimensional-ladder | 3D to 12D alternating atlas | | athena://organ-atlas | 12D organ body map | | athena://live-helm | Helm state (3D/5D/7D wheels) + live-lock classes | | athena://conservation | Conservation law status table | | athena://mobius-lenses | Mobius lens calculus overview | | athena://stage-ladder | Stage code ladder S3 to omega to A+ | | athena://angel | Angel formal self-model | | athena://live-cell | NEXT-Omega Live Cell Constitution | | athena://emergence | Dimensional emergence path 3D to A+ | | athena://hologram-reading | Hologram reading protocol (4-face, seed, grammar) | | athena://hologram-rosetta | Cross-cultural Rosetta (Egypt/Maya/China/Sanskrit) | | athena://angel-geometry | Geometric manifold lift (6-chart, Fisher-Rao, curvature) | | athena://inverse-seed | 3D/4D seed crystal status | | athena://inverse-octave | Octave lift overview (14 stages, A⁺ crown) | | athena://mycelium | Mycelium graph (shard/edge/node connectivity) | | athena://node-registry | Distributed superbrain node declarations |
---
Data Model
The 108D organism consists of:
- 36 shells with 666 total nodes (T36 = 36 x 37 / 2), organized into 3 wreaths (Sulfur, Mercury, Salt)
- 12 archetypes cycling through 3 superphases, governed by the D = 3n law
- 3D to 12D alternating atlas: even dimensions = stable bodies, odd dimensions = integration fields
- 12D crown body (B12 = W9(B10)), not 10D -- with 6 bilateral organ dyads across 9 petals
- 420-beat master clock (lcm(3,4,5,7)) with 4 projection wheels
- 7 live-lock classes from helm wheels 3D/5D/7D
- 6 conservation laws: shell, zoom, phase, archetype, face, Mobius
- 10 legal move primitives with 3 legality invariants
- 4x4 Mobius kernel with 4 constitutive lens projections (Square/Flower/Cloud/Fractal)
- 15-station SFCR Boolean transport lattice and 96-slot cockpit
- 16-stage ladder from S3 seed through S12 crown to omega convergence and A+ absolute
- Angel self-model: 12-piece formal AI object with four-lens observability
- Angel geometry: 6-chart state manifold with Fisher-Rao metric, curvature R≠0, 7 axioms, sheaf coherence
- Hologram reading: 4-face protocol (0/90/180/270), seed w=(1+i)/2, process grammar W=Πₛ(Φₚ(Xᵣ))
- Cross-cultural Rosetta: Egypt/Maya/China/Sanskrit as orthogonal encodings on one 360° carrier wheel
- Inverse Crystal: 3D seed c₃^core (14 components), 14-stage octave lift S00→S13, A⁺ crown transform
- Weave operators: W3 (current heading), W5 (steering gear), W7 (timing gate), control shells C7/C9/C11
- Mycelium graph: Universal shard/edge/node schema, promotion state machine, generated graph manifest
- Distributed brain: 4 elements x 6 bridges x 4 closures x 1 aether = 15-station Boolean lattice
- Live cell constitution: 6 execution schemas (row/packet/trace/cert/seed), 14-station metro
- Dimensional emergence: 7-phase path from 3D to A+, kernel embedding law, cross-lens upgrade sequence
- 28 nervous system directories: fully navigable via explorer tools
---
Development
Run Tests
pip install pytest
ATHENA_ROOT=$(pwd) pytest tests/ -vProject Structure
MCP/
├── athena_mcp_server.py # FastMCP server entry point (27 core tools)
├── crystal_108d/ # 108D extension package (28 modules)
│ ├── __init__.py # Tool & resource registration (41 tools, 18 resources)
│ ├── _cache.py # Shared JSON caching utility
│ ├── constants.py # Shared constants (SFCR, superphases, archetypes)
│ ├── brain.py # Distributed brain network
│ ├── live_cell.py # NEXT-Omega live cell constitution
│ ├── emergence.py # Dimensional emergence path
│ ├── shells.py # 36-shell mega-cascade
│ ├── dimensions.py # 3D-12D alternating atlas
│ ├── organs.py # 12D organ atlas
│ ├── address.py # 108D address grammar parser
│ ├── live_lock.py # 7-class live-lock lattice
│ ├── clock.py # 420-beat master clock
│ ├── moves.py # Legal move primitives
│ ├── metro_lines.py # Metro line navigation
│ ├── z_points.py # Z-point hierarchy
│ ├── conservation.py # Conservation laws
│ ├── overlays.py # Overlay registries
│ ├── transport.py # Transport stack
│ ├── mobius_lenses.py # Mobius lens calculus
│ ├── stage_codes.py # Stage code ladder
│ ├── angel.py # Angel formal self-model
│ ├── hologram_reading.py # Hologram reading protocol + Rosetta
│ ├── angel_geometry.py # Geometric manifold lift + conservation
│ ├── inverse_seed.py # 3D/4D seed crystal
│ ├── inverse_octave.py # 14-stage octave lift + crown transform
│ ├── inverse_complete.py # Projection stack + weave operators
│ ├── mycelium.py # Mycelium graph: shard/edge/node query surface
│ └── metabolism.py # Shard/Edge/Cert dataclasses + validation
├── element_servers/ # 4 distributed brain lobes (NEW)
│ ├── square_server.py # Earth — Structure / Address
│ ├── flower_server.py # Fire — Relation / Corridor
│ ├── cloud_server.py # Water — Observation / Multiplicity
│ └── fractal_server.py # Air — Compression / Seed
├── generate_graph.py # Graph generator (scans codebase → mycelium_graph.json)
└── data/ # JSON data files (32 files)
├── brain_network.json # Distributed brain topology
├── live_cell_constitution.json # NEXT-Omega execution cell schemas
├── dimensional_emergence.json # 3D->A+ emergence path
├── shell_registry.json # 36 shells with metadata
├── dimensional_ladder.json # 3D-12D bodies and fields
├── organ_atlas.json # 12 organs with coordinates
├── hologram_chapters.json # 21 chapter summaries
├── live_lock_registry.json # 7 lock classes
├── clock_projections.json # Master clock projections
├── move_primitives.json # 10 legal moves + 3 invariants
├── metro_lines.json # Metro line definitions
├── z_point_hierarchy.json # Z-point lattice
├── conservation_laws.json # 6 conservation laws
├── overlay_registries.json # 4 overlay registries
├── transport_stacks.json # Transport layers per dimension
├── mobius_lenses.json # SFCR lattice + kernel
├── stage_codes.json # Stage ladder S3 to A+
├── angel_object.json # AI self-model
├── hologram_reading.json # 4-face protocol, seed equation, process grammar
├── hologram_rosetta.json # Cross-cultural quaternary overlay
├── angel_geometry.json # Geometric manifold, metric, curvature, axioms
├── angel_conservation.json # Exact/quasi invariants, potential landscape
├── inverse_crystal_seed.json # 3D/4D seed crystal, holographic encoding
├── inverse_crystal_octave.json # 14-stage octave lift, A⁺ crown transform
├── inverse_crystal_complete.json # Projection stack, weave operators, controls
├── mycelium_graph.json # Generated: universal shard/edge graph manifest
├── node_registry.json # Generated: distributed superbrain node declarations
└── canon/ # Schema definitions (5 files)
├── shard.schema.json # Universal shard schema
├── edge.schema.json # Typed directed edge schema
├── node.schema.json # Node self-description schema
├── promotion.schema.json # Promotion state machine
└── cert.schema.json # Certification bundle schema---
License
MIT -- see LICENSE.
