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-інструменти пишуть `mcpServers` у camelCase, а 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: чотири розрахунки в одному запиті — і один кредит. Чотири окремі виклики коштуватимуть чотири.