SpiritWave Labs — Pentamancy Council MCP Server

Предоставляет доступ к движку гадания Pentamancy Council (пять оракулов) компании SpiritWave Labs для ИИ-агентов через Model Context Protocol.

Инструменты

consult_council

Обращается к пяти древним оракулам параллельно и синтезирует их прочтения в единый совет:

• Hafez — персидская суфийская поэзия (Fal-e Hafez)

• Tarot — колода Rider-Waite из 78 карт, расклад из 3 карт

• Runes — Elder Futhark, вытягивание 3 рун

• I Ching — Книга Перемен, гексаграмма по подбрасыванию монет

• Geomancy — арабское `Ilm al-Raml, щитовая диаграмма

Сервер выполняет все пять прочтений, интерпретирует каждое, а затем синтезирует. Лучше всего подходит для вопросов, имеющих значение — крупных решений, эмоциональных перекрёстков, духовного направления.

Входные данные: { question: string } (3–1000 символов)

Индивидуальные консультации

consult_hafez, consult_tarot, consult_iching, consult_runes, consult_geomancy — каждая выполняет собственное прочтение на стороне сервера и интерпретирует его в голосе своей традиции. Описания инструментов составлены так, чтобы агенты сами выбирали нужный; намеренно нет инструмента-маршрутизатора.

Related MCP server: Yijing Bazi MCP Server

Оплата (x402)

Платно с первого дня. $0.50 за чтение Совета, $0.10 за отдельный оракул, в USDC на Base через протокол x402:

• initialize, tools/list, уведомления — бесплатно. Подключайтесь, обнаруживайте, читайте цены.

• tools/call на платном инструменте без оплаты → HTTP 402 с paymentRequirements в теле (схема exact, адрес получателя, атомарная сумма).

• Повторная попытка с заголовком X-PAYMENT (подписанная полезная нагрузка EIP-3009); фасилитатор x402 Foundation проверяет и проводит расчёт, вызов продолжается, а квитанция о расчёте возвращается в X-PAYMENT-RESPONSE.

Агенты, использующие x402-fetch (или любой клиент с поддержкой x402), получают этот поток автоматически. Конфигурация: X402_PAYEE, X402_FACILITATOR, X402_ENABLED (см. docker-compose.yml).

Архитектура

Это тонкий прокси. MCP-сервер принимает вызовы инструментов JSON-RPC и пересылает их в существующий PHP API SpiritWave Labs:

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

Движок гадания полностью находится в PHP-бэкенде. Этот сервер добавляет уровень протокола MCP — он сам не реализует никакой логики гадания.

Транспорт

Streamable HTTP (стандарт MCP для удалённых серверов). Единая конечная точка: POST /mcp.

Настройка

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

Конфигурация

Дорожная карта

• Этап 1 (готово): каркас MCP, шесть инструментов, развёрнуто на mcp.spiritwavelabs.com (Docker, за nginx, работает с 2026-08-18).

• Этап 2: платёжный слой x402 — оплата USDC за каждый вызов через фасилитатор Coinbase CDP (сеть Base). Агенты платят за каждое прочтение.

• Этап 3: включение в реестры — официальный MCP Registry, Smithery, Glama.

Лицензия

MIT © SpiritWave Labs