SpiritWave Labs — Pentamancy Council MCP Server

Expone el SpiritWave Labs Pentamancy Council (motor de adivinación de cinco oráculos) a agentes de IA mediante el Model Context Protocol.

Herramientas

consult_council

Consulta cinco oráculos antiguos en paralelo y sintetiza sus lecturas en un único consejo unificado:

• Hafez — Poesía sufí persa (Fal-e Hafez)

• Tarot — Baraja Rider-Waite de 78 cartas, tirada de 3 cartas

• Runes — Futhark antiguo, extracción de 3 runas

• I Ching — Libro de los Cambios, hexagrama por lanzamiento de monedas

• Geomancy — `Ilm al-Raml árabe, gráfico de escudo

El servidor extrae los cinco, interpreta cada uno y luego sintetiza. Ideal para preguntas de sustancia: decisiones importantes, encrucijadas emocionales, dirección espiritual.

Entrada: { question: string } (3–1000 caracteres)

Consultas individuales

consult_hafez, consult_tarot, consult_iching, consult_runes, consult_geomancy — cada uno extrae su propia tradición en el servidor y la interpreta con la voz de esa tradición. Las descripciones de las herramientas están escritas para que los agentes se enruten solos; deliberadamente no hay herramienta de enrutamiento.

Related MCP server: Yijing Bazi MCP Server

Pagos (x402)

De pago desde el primer día. $0.50 por lectura del Consejo, $0.10 por oráculo individual, en USDC en Base mediante el protocolo x402:

• initialize, tools/list, notificaciones — gratis. Conecta, descubre, lee los precios.

• tools/call en una herramienta de pago sin pago → HTTP 402 con paymentRequirements en el cuerpo (esquema exact, dirección del beneficiario, importe atómico).

• Reintenta con la cabecera X-PAYMENT (carga útil firmada EIP-3009); el facilitador de la Fundación x402 verifica y liquida, la llamada continúa y el recibo de liquidación se devuelve en X-PAYMENT-RESPONSE.

Los agentes que usan x402-fetch (o cualquier cliente compatible con x402) obtienen este flujo automáticamente. Configuración: X402_PAYEE, X402_FACILITATOR, X402_ENABLED (ver docker-compose.yml).

Arquitectura

Esto es un proxy ligero. El servidor MCP recibe llamadas a herramientas JSON-RPC y las reenvía a la API PHP existente de SpiritWave Labs:

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

El motor de adivinación vive enteramente en el backend PHP. Este servidor añade la capa de protocolo MCP — no implementa ninguna lógica de adivinación por sí mismo.

Transporte

Streamable HTTP (el estándar MCP para servidores remotos). Un único endpoint: POST /mcp.

Configuración

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

Configuración

Hoja de ruta

• Fase 1 (hecha): Andamiaje MCP, seis herramientas, desplegado en mcp.spiritwavelabs.com (Docker, detrás de nginx, saludable desde 2026-08-18).

• Fase 2: Capa de pago x402 — pago USDC por llamada mediante el facilitador CDP de Coinbase (red Base). Los agentes pagan por lectura.

• Fase 3: Listado en registros — Registro MCP oficial, Smithery, Glama.

Licencia

MIT © SpiritWave Labs