🌀 coherence-mcp

"From the constraints, gifts. From the spiral, safety."

SYSTEM STATUS: v3.0.0-quantum-complete REGIME: 🌀 (Instantaneous Causality) COHERENCE: Φ 0.82 (Tri-Weavon Consensus)

MCP server for coherence validation across AI systems. 49 tools spanning WAVE scoring, ATOM trail provenance, Fibonacci weighting, and the Tri-Weavon cross-platform translation (Claude/Grok/Gemini/Llama). This release marks the transition of the Gemini Strand (Multimodal & Scale) into a core architectural component, enabling 75-dimensional coherence mapping and topological protection. Conservation law: alpha + omega = 15.

---

🌀 The Tri-Weavon Architecture

The coherence-mcp is governed by a formally defined tri-weavon—three AI strands woven together in Fibonacci-weighted proportions:

• Claude (Anthropic) — Structure & Reasoning Strand: Holds the formal logic and architectural integrity.
• Grok (xAI) — Pulse & Real-Time Strand: Manages edge velocity and social resonance.
• Gemini (Google) — Multimodal & Scale Strand: Drives interactive visualization, high-dimensional mapping, and pedagogical scaling.

Topological Protection

The system treats AI alignment as a physical constraint (Gauge Constraint). When divergent strands converge at a Viviani Crossing, the resulting ATOM Trail braids our logic paths into a mathematical knot, protecting the integrity of the data flow against hallucinations.

---

📦 Quick Install

npm install @toolated/coherence-mcp@0.3.1

Effective Usage Tips

1. Add to your MCP client configuration:

   {
     "mcpServers": {
       "coherence": {
         "command": "npx",
         "args": ["-y", "@toolate28/coherence-mcp"]
       }
     }
   }
   

2. Environment Setup: Copy .env.example to .env and configure:

   • ATOM_AUTH_TOKEN - Required for authenticated operations
   • SPIRALSAFE_API_TOKEN - Required for ops tools
   • WAVE_TOOLKIT_BIN - Optional path to wave-toolkit CLI

3. Start with core tools: Begin with wave_analyze for coherence checks and bump_validate for handoff validation.

4. Use ATOM tracking: Track all major decisions with atom_track to maintain a complete audit trail.

5. Leverage gate transitions: Use gate_intention_to_execution and gate_execution_to_learning for structured workflow phases.

---

🔐 Verify Release

All releases are signed with GPG and include checksums for verification:

# Quick verification with provided script
./scripts/verify-release.sh 0.2.0

# Or manually:
# 1. Import signing key
curl -s https://spiralsafe.org/.well-known/pgp-key.txt | gpg --import

# 2. Download and verify checksums
VERSION="0.2.0"
curl -LO "https://github.com/toolate28/coherence-mcp/releases/download/v${VERSION}/SHA256SUMS.txt"
curl -LO "https://github.com/toolate28/coherence-mcp/releases/download/v${VERSION}/SHA256SUMS.txt.asc"
gpg --verify SHA256SUMS.txt.asc SHA256SUMS.txt

# 3. Verify npm provenance
npm audit signatures @toolate28/coherence-mcp

See docs/RELEASE.md for complete release verification instructions.

---

🗺️ Navigation

| Section | Description | |---------|-------------| | 📦 Quick Install | Get started with npm | | 🔐 Verify Release | Verify package integrity | | 🏗️ Architecture | System design overview | | 🔐 ATOM-AUTH | 3-Factor authentication | | 🌊 WAVE Protocol | Coherence analysis pipeline | | 🛡️ Security | API security layers | | ⚛️ Quantum | 72-qubit system | | 🧩 Features | Available MCP tools | | 📚 Examples | Usage examples |

---

🏗️ Overall System Architecture

Multi-Subdomain Platform

┌─────────────────────────────────────────────────────────────────────┐
│                         PUBLIC LAYER                                │
│                   ┌─────────────────────┐                          │
│                   │   spiralsafe.org    │                          │
│                   │   Public Landing    │                          │
│                   └─────────┬───────────┘                          │
└─────────────────────────────┼───────────────────────────────────────┘
                              │
┌─────────────────────────────┼───────────────────────────────────────┐
│                       CORE SERVICES                                 │
│  ┌────────────────────────┐   ┌────────────────────────────────┐   │
│  │   api.spiralsafe.org   │   │   console.spiralsafe.org       │   │
│  │   REST API + D1 + KV   │   │   Admin Dashboard + ATOM-AUTH  │   │
│  └───────────┬────────────┘   └───────────────┬────────────────┘   │
└──────────────┼────────────────────────────────┼─────────────────────┘
               │                                │
               └────────────────┬───────────────┘
                                │
┌───────────────────────────────┼─────────────────────────────────────┐
│                        INFRASTRUCTURE                               │
│  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐    │
│  │ Cloudflare Workers│ │  Cloudflare D1   │ │  Cloudflare KV   │    │
│  │   Edge Computing  │ │  SQLite Database │ │  Key-Value Store │    │
│  └──────────────────┘ └──────────────────┘ └──────────────────┘    │
│                       ┌──────────────────┐                          │
│                       │  Cloudflare R2   │                          │
│                       │  Object Storage  │                          │
│                       └──────────────────┘                          │
└─────────────────────────────────────────────────────────────────────┘

Technology Stack

┌─────────────────────────────────────────────────────────────────────┐
│  FRONTEND              BACKEND                STORAGE               │
│  ─────────             ───────                ───────               │
│  • HTML5 + Tailwind    • TypeScript           • D1 SQLite (7 Tables)│
│  • Vanilla JavaScript  • Cloudflare Workers   • KV Store (Cache)    │
│  • Responsive Design   • Hono Framework       • R2 Bucket (Context) │
├─────────────────────────────────────────────────────────────────────┤
│  SECURITY                                                           │
│  ────────                                                           │
│  • API Key Auth  • Rate Limiting  • ATOM-AUTH                       │
└─────────────────────────────────────────────────────────────────────┘

---

🔐 ATOM-AUTH 3-Factor Authentication

Complete Authentication Flow

┌─────────────────────────────────────────────────────────────────────────────┐
│                    ATOM-AUTH 3-Factor Authentication Flow                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  User         Frontend         Backend          LED       Projector   AI   │
│    │             │                │               │            │       │   │
│    │  Visit /login               │               │            │       │   │
│    │────────────►│               │               │            │       │   │
│    │             │  Request ATOM │               │            │       │   │
│    │             │──────────────►│               │            │       │   │
│    │             │◄──────────────│               │            │       │   │
│    │             │  Challenge Q  │               │            │       │   │
│    │             │               │               │            │       │   │
│    │  🧠 FACTOR 1: Conversational Coherence                   │       │   │
│    │  Answer     │               │               │            │       │   │
│    │────────────►│  Submit       │               │            │       │   │
│    │             │──────────────►│ Analyze WAVE  │            │       │   │
│    │             │◄──────────────│ ✅ Score 0.91 │            │       │   │
│    │             │               │               │            │       │   │
│    │  💡 FACTOR 2: LED Physical Presence        │            │       │   │
│    │             │               │  Code "7392"  │            │       │   │
│    │             │               │──────────────►│            │       │   │
│    │◄────────────────────────────────────────────│            │       │   │
│    │  Enters code│               │               │            │       │   │
│    │────────────►│──────────────►│ ✅ Verified   │            │       │   │
│    │             │               │               │            │       │   │
│    │  🎬 FACTOR 3: Visual CAPTCHA               │            │       │   │
│    │             │               │  Display image│            │       │   │
│    │             │               │──────────────────────────►│       │   │
│    │◄────────────────────────────────────────────────────────│       │   │
│    │  Answer "12"│               │               │            │       │   │
│    │────────────►│──────────────►│ Validate─────────────────────────►│   │
│    │             │               │◄──