Model Context Protocol

Occult API у вашому ШІ-асистенті

Підключіть Claude, Cursor чи будь-якого асистента з підтримкою MCP до справжніх даних ефемерид. Попросіть звичайною мовою панчанг, кундлі чи дашу — і отримаєте справжній розрахунок, а не правдоподібну вигадку.

ви:  Який панчанг у Джайпурі завтра на схід Сонця?

     → тітхі Чатуртхі (Крішна-пакша), йога Вріддхі, карана Балава

Перш ніж почати

Вам потрібен API-ключ. Створіть акаунт і згенеруйте ключ на сторінці «Ключі». Його показують лише один раз, тож скопіюйте ключ, перш ніж піти зі сторінки. Ще потрібен Node 18 або новіший, а решту npx завантажить під час першого запуску.

Налаштування

Для всіх клієнтів блок однаковий. Додайте його до файлу нижче. Якщо у файлі вже є розділ mcpServers, вставте occult-api у нього, а не створюйте другий.

{
  "mcpServers": {
    "occult-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

Claude Code (VS Code)~/.claude.jsonC:Users<you>.claude.json у Windows

Claude Desktopclaude_desktop_config.json%APPDATA%Claude у Windows, ~/Library/Application Support/Claude/ у macOS

Cursor~/.cursor/mcp.json

Потім повністю перезапустіть застосунок. MCP-сервери підключаються під час запуску, тому оновити вікно недостатньо.

Або з термінала

Якщо у вас встановлено Claude Code для командного рядка, ця команда зробить те саме за один крок. У розширенні VS Code вона не спрацює, бо там немає команди claude, — скористайтеся файлом конфігурації вище.

claude mcp add occult-api -e OCCULT_API_KEY=yt_live_your_key_here -- npx -y occult-api-mcp

Що вміє асистент

П’ять інструментів охоплюють усі 299 ендпоінтів і 330 розрахунків. Окремого інструмента для кожного ендпоінта навмисно немає: кожен інструмент займає місце в контексті моделі в кожному повідомленні, і 299 інструментів витіснили б розмову, ще до того як ви щось запитали. Тож асистент шукає.

check_accountБезкоштовно

Перевіряє, чи працює ключ, і показує баланс кредитів. Якщо щось не працює, попросіть асистента запустити це першим: так видно, чи проблема в ключі, чи в порожньому балансі.

search_endpointsБезкоштовно

Знаходить розрахунок за назвою чи функцією. Запит «manglik» спрацює, хоча ендпоінта з такою назвою немає: пошук іде по всіх розрахунках, а не лише по назвах ендпоінтів.

describe_endpointБезкоштовно

Точні поля запиту, допустимі значення кожного й тіло запиту, перевірене на робочому сервері.

call_endpoint1–25 кредитів

Запускає будь-який ендпоінт за його ціною: здебільшого один кредит, для PDF-звітів і ШІ-чату — 25 кредитів. За невдалі запити плата не стягується.

get_panchanga1 кредит

Окрема команда для найпоширенішого запиту, щоб асистентові не доводилося спершу його шукати.

Скільки це коштує

Рівно стільки, скільки прямий HTTP-виклик: один кредит за успішний розрахунок (PDF-звіти та ШІ-чат — 25 кредитів) і нічого за невдалий запит. Пошук і читання документації безкоштовні, тож асистент може дослідити весь API, нічого не витративши. Баланс повертається з кожним викликом, а коли залишиться менше 50 кредитів, ви отримаєте попередження.

Про ваш ключ

Ключ залишається на вашому комп’ютері. Його зчитують зі змінних середовища й надсилають до API в заголовку, але моделі ніколи не показують: асистент бачить результати, а не облікові дані.

Проте це все одно серверний секрет: будь-хто, у кого він є, може витрачати ваші кредити. Не тримайте його в спільних конфігураціях і репозиторіях, а якщо підозрюєте витік, замініть ключ на сторінці «Ключі».

Якщо щось пішло не так

«Your Occult API key is invalid, revoked, or expired»: Створіть новий ключ, оновіть блок env і перезапустіть застосунок. MCP-сервери зчитують змінні середовища лише раз — під час запуску.
«claude» не розпізнано як команду: Ви використовуєте розширення VS Code, яке не встановлює команду claude. Скористайтеся файлом конфігурації вище — він робить те саме.
Сервер узагалі не з’являється: Перевірте, чи JSON коректний, і повністю перезапустіть застосунок. Помилки запуску пишуться в MCP-журнал клієнта, а не в чат.
Асистент не може знайти розрахунок: Спробуйте санскритську назву — «kundli», а не «натальна карта». Усі розрахунки перелічено в довіднику.

Отримати API-ключ Переглянути в npm Код на GitHub