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: четыре расчёта в одном запросе списывают один кредит. Четыре отдельных вызова стоят четыре.