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