Codex + Occult API

MCP-сервер открывает 299 астрологических эндпоинтов как инструменты, которые может вызывать Codex CLI. Вместо того чтобы описывать API и надеяться, что модель напишет правильный запрос, агент сам ищет в каталоге, читает настоящую схему запроса и делает вызов. Поэтому числа в его ответе взяты из эфемерид, а не из обучающих данных.

Поиск и чтение схем ничего не стоят. Кредит списывается только за успешный call_endpoint, а неудачные вызовы бесплатны.

Создайте ключ в личном кабинете. Он выглядит как yt_live_… и привязан к вашему балансу кредитов, поэтому обращайтесь с ним как с паролем: никогда не вставляйте в клиентский код и не коммитьте.

Создать API-ключ

Откройте ~/.codex/config.toml (в Windows — %USERPROFILE%\.codex\config.toml; если файла нет, создайте его) и добавьте:

[mcp_servers.occult-api]
command = "npx"
args = ["-y", "occult-api-mcp"]
env = { OCCULT_API_KEY = "yt_live_your_key_here" }

Замените yt_live_your_key_here своим настоящим ключом. Больше ничего устанавливать не нужно: npx скачает сервер при первом запуске.

Спросите Codex CLI:

Перечисли инструменты, которые у тебя есть от сервера occult-api.

В ответе должно быть пять инструментов:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Если список пуст, сервер не запустился. Обычно файл конфигурации лежит в правильном месте, но имеет неправильную структуру, — так что сначала проверьте имя ключа выше.

Через MCP-сервер occult-api выведи все эндпоинты, где упоминается 'dasha', затем вызови эндпоинт вимшоттари для карты и выведи первые пять махадаш таблицей.

Агент должен вызвать API, а не отвечать по памяти. Если ответ пришёл мгновенно и в нём нет вызова инструмента, агент ответил из обучающих данных — напишите «используй инструменты occult-api», и он так и сделает.

• Codex настраивает MCP в TOML, а не в JSON. Имя таблицы содержит имя сервера: `[mcp_servers.occult-api]`.
• Обратите внимание на подчёркивание в `mcp_servers`: во всех JSON-инструментах используется camelCase `mcpServers`, а TOML ошибку в написании за вас не исправит.
• Codex читает конфигурацию при запуске. После правки перезапустите CLI.

Эндпоинты — это обычный HTTP. Для работы с ними ничего с этой страницы не требуется:

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H 'X-API-Key: yt_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "date_time": "2026-09-17T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana"]
  }'

Обратите внимание на массив keys: четыре расчёта в одном запросе стоят один кредит. Четыре отдельных вызова стоят четыре.