{
  "markdown": "# SpiritWave Labs — Pentamancy Council MCP Server\n\nExposes the [SpiritWave Labs](https://spiritwavelabs.com) Pentamancy Council (five-oracle divination engine) to AI agents via the Model Context Protocol.\n\n## Tools\n\n### `consult_council`\nConsults five ancient oracles in parallel and synthesizes their readings into a single unified counsel:\n- **Hafez** — Persian Sufi poetry (Fal-e Hafez)\n- **Tarot** — Rider-Waite 78-card deck, 3-card spread\n- **Runes** — Elder Futhark, 3-rune draw\n- **I Ching** — Book of Changes, coin-cast hexagram\n- **Geomancy** — Arabic `Ilm al-Raml, shield chart\n\nThe server draws all five, interprets each, then synthesizes. Best for questions of substance — major decisions, emotional crossroads, spiritual direction.\n\n**Input:** `{ question: string }` (3–1000 chars)\n\n### Individual consultations\n`consult_hafez`, `consult_tarot`, `consult_iching`, `consult_runes`, `consult_geomancy` — each draws its own tradition server-side and interprets it in that tradition's voice. The tool descriptions are written so agents route themselves; there is deliberately no router tool.\n\n## Payments (x402)\n\nPaid from day one. **$0.50 per Council reading, $0.10 per individual oracle**, in USDC on Base via the [x402 protocol](https://x402.org):\n\n- `initialize`, `tools/list`, notifications — **free**. Connect, discover, read the prices.\n- `tools/call` on a paid tool without payment → **HTTP 402** with `paymentRequirements` in the body (scheme `exact`, payee address, atomic amount).\n- Retry with the `X-PAYMENT` header (signed EIP-3009 payload); the [x402 Foundation facilitator](https://x402.org/facilitator) verifies and settles, the call proceeds, and the settlement receipt returns in `X-PAYMENT-RESPONSE`.\n\nAgents using `x402-fetch` (or any x402-aware client) get this flow automatically. Configuration: `X402_PAYEE`, `X402_FACILITATOR`, `X402_ENABLED` (see `docker-compose.yml`).\n\n## Architecture\n\nThis is a **thin proxy**. The MCP server receives JSON-RPC tool calls and forwards them to the existing SpiritWave Labs PHP API:\n\n```\nAgent → MCP server (this repo, Streamable HTTP) → PHP API (temple.php, individual oracle endpoints) → DeepSeek\n```\n\nThe divination engine lives entirely in the PHP backend. This server adds the MCP protocol layer — it does not implement any divination logic itself.\n\n## Transport\n\nStreamable HTTP (the MCP standard for remote servers). Single endpoint: `POST /mcp`.\n\n## Setup\n\n```bash\nnpm install\nnpm run build     # compile TypeScript\nnpm start         # run the compiled server\n# or for development:\nnpm run dev       # run via tsx with hot reload\n```\n\n### Configuration\n\n| Env var | Default | Description |\n|---------|---------|-------------|\n| `PORT` | `3001` | HTTP port |\n| `SWL_API_BASE` | `https://spiritwavelabs.com` | The PHP API base URL to proxy to |\n\n## Roadmap\n\n- **Phase 1 (done):** MCP scaffold, six tools, deployed at `mcp.spiritwavelabs.com` (Docker, behind nginx, healthy since 2026-08-18).\n- **Phase 2:** x402 payment layer — per-call USDC payment via Coinbase CDP facilitator (Base network). Agents pay per reading.\n- **Phase 3:** Registry listing — official MCP Registry, Smithery, Glama.\n\n## License\n\nMIT © SpiritWave Labs\n",
  "bytes": 3202,
  "sha": "2396797b71681a0250453ec814ecfde17fc75a12a79d68a580a954db1bc07159",
  "repo_slug": "vizkr/oracle-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vizkr_council_fb35c866/readme"
}