SpiritWave Labs – Pentamancy Council MCP Server

Stellt den SpiritWave Labs Pentamancy Council (Fünf-Orakel-Wahrsage-Engine) KI-Agenten über das Model Context Protocol zur Verfügung.

Tools

consult_council

Konsultiert fünf antike Orakel parallel und fasst ihre Lesungen zu einem einzigen vereinheitlichten Rat zusammen:

• Hafez – Persische Sufi-Dichtung (Fal-e Hafez)

• Tarot – Rider-Waite-78-Karten-Deck, 3-Karten-Legung

• Runen – Elder Futhark, 3-Runen-Ziehung

• I Ging – Buch der Wandlungen, Münzwurf-Hexagramm

• Geomantie – Arabisches `Ilm al-Raml, Schilddiagramm

Der Server zieht alle fünf, interpretiert jede und synthetisiert dann. Am besten geeignet für Fragen von Substanz – große Entscheidungen, emotionale Kreuzungen, spirituelle Richtung.

Eingabe: { question: string } (3–1000 Zeichen)

Einzelkonsultationen

consult_hafez, consult_tarot, consult_iching, consult_runes, consult_geomancy – jede zieht ihre eigene Tradition serverseitig und interpretiert sie in der Stimme dieser Tradition. Die Tool-Beschreibungen sind so geschrieben, dass sich Agenten selbst zuordnen; es gibt bewusst kein Router-Tool.

Related MCP server: Yijing Bazi MCP Server

Zahlungen (x402)

Von Anfang an kostenpflichtig. 0,50 $ pro Council-Lesung, 0,10 $ pro einzelnes Orakel, in USDC auf Base über das x402-Protokoll:

• initialize, tools/list, Benachrichtigungen – kostenlos. Verbinden, entdecken, Preise lesen.

• tools/call auf einem kostenpflichtigen Tool ohne Zahlung → HTTP 402 mit paymentRequirements im Body (Schema exact, Payee-Adresse, atomarer Betrag).

• Wiederholen mit dem X-PAYMENT-Header (signierte EIP-3009-Nutzlast); der x402 Foundation Facilitator verifiziert und wickelt ab, der Aufruf wird fortgesetzt, und die Abrechnungsquittung wird in X-PAYMENT-RESPONSE zurückgegeben.

Agenten, die x402-fetch (oder einen beliebigen x402-fähigen Client) verwenden, erhalten diesen Ablauf automatisch. Konfiguration: X402_PAYEE, X402_FACILITATOR, X402_ENABLED (siehe docker-compose.yml).

Architektur

Dies ist ein dünner Proxy. Der MCP-Server empfängt JSON-RPC-Toolaufrufe und leitet sie an die bestehende SpiritWave Labs PHP-API weiter:

Agent → MCP server (this repo, Streamable HTTP) → PHP API (temple.php, individual oracle endpoints) → DeepSeek

Die Wahrsage-Engine lebt vollständig im PHP-Backend. Dieser Server fügt die MCP-Protokollebene hinzu – er implementiert selbst keine Wahrsage-Logik.

Transport

Streamable HTTP (der MCP-Standard für Remote-Server). Einzelner Endpunkt: POST /mcp.

Einrichtung

npm install
npm run build     # compile TypeScript
npm start         # run the compiled server
# or for development:
npm run dev       # run via tsx with hot reload

Konfiguration

Roadmap

• Phase 1 (abgeschlossen): MCP-Gerüst, sechs Tools, bereitgestellt unter mcp.spiritwavelabs.com (Docker, hinter nginx, gesund seit 2026-08-18).

• Phase 2: x402-Zahlungsebene – USDC-Zahlung pro Aufruf über den Coinbase-CDP-Facilitator (Base-Netzwerk). Agenten zahlen pro Lesung.

• Phase 3: Registry-Eintrag – offizielle MCP-Registry, Smithery, Glama.

Lizenz

MIT © SpiritWave Labs