Cursor + Occult API

Через MCP-сервер Composer отримує 299 астрологічних ендпоінтів у вигляді інструментів. Замість того щоб описувати API й сподіватися, що модель напише правильний запит, агент шукає в каталозі, читає справжню схему запиту й робить виклик. Тож цифри в його відповіді беруться з ефемерид, а не з навчальних даних.

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

Створіть його в кабінеті. Він має вигляд yt_live_… і дає доступ до вашого балансу кредитів, тож поводьтеся з ним як із паролем: ніколи не вставляйте в клієнтський код і не комітьте.

Створити API-ключ

Відкрийте ~/.cursor/mcp.json (у Windows — %USERPROFILE%\.cursor\mcp.json; якщо файлу немає, створіть його) і додайте:

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

Якщо не хочете редагувати файл вручну, те саме можна зробити тут: Settings → Cursor Settings → MCP → Add new global MCP server.

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

Запитайте Composer:

Перелічи інструменти, які ти маєш від сервера occult-api.

У відповідь має бути п’ять інструментів:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Якщо список порожній, сервер не запустився. Найчастіше файл конфігурації лежить у правильному місці, але має неправильну структуру, тож насамперед перевірте назву ключа вище.

Через MCP-сервер occult-api отримай сьогоднішній панчанг для Джайпура й покажи тітхі, накшатру та вікно раху кала. Об’єднай ключі в один виклик.

Агент має викликати API, а не відповідати з пам’яті. Якщо відповідь з’явилася миттєво й без виклику інструмента, агент відповів із навчальних даних — напишіть «використай інструменти occult-api», і він так і зробить.

• Локальний для проєкту `.cursor/mcp.json` має пріоритет над глобальним — так можна дати окремому репозиторію власний ключ, не змінюючи налаштувань комп’ютера.
• Cursor перезавантажує MCP-сервери під час збереження. Якщо список інструментів не з’явився, вимкніть і знову ввімкніть сервер у Settings, а не перезапускайте редактор.
• Постійні інструкції тримайте в `.cursor/rules/`, а не повторюйте в кожному промпті. Одне правило «об’єднуй `keys` в один виклик, а не викликай окремо для кожного розрахунку» окупиться одразу.

Ендпоінти — це звичайний 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: чотири розрахунки в одному запиті коштують один кредит. Чотири окремі виклики коштують чотири.