get_transits
Передайте исходные данные бодиграфа в поле контракта `natalChart`, затем запросите контекст текущего или указанного транзита. Буквальный идентификатор сохраняется для совместимости с API.
Польза для разработчика: Создавайте для агентов сценарии с учётом времени, не рассчитывая положения планет в клиенте.
Параметры
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
date | строка (местное время на часах) | Да | Явный момент транзита в виде местного времени на часах в указанном часовом поясе, без Z и смещения UTC. MCP требует его, чтобы повторный запрос с ключом относился к тому же моменту. Дата может быть будущей. |
timezone | строка | Нет | Часовой пояс IANA для момента транзита. |
natalChart | объект | Нет | Необязательные исходные данные бодиграфа с birthDateTime и timezone. birthDateTime — местное время на часах без Z и смещения UTC. Название поля закреплено в контракте серверной части. |
idempotencyKey | строка | Да | Стабильный ключ для этого предполагаемого расчёта транзита. При повторном запросе используйте его только с идентичными аргументами. |
Время рождения указывается как местное время на часах. Укажите дату и время рождения точно такими, какими они были на часах в месте рождения человека, без Z и смещения UTC; часовой пояс задайте отдельно в формате идентификатора IANA. Значение "birthDateTime": "1990-05-15T14:30:00" с "timezone": "America/New_York" означает половину третьего дня по времени Нью-Йорка.
Устарело: Значения, оканчивающиеся на Z или числовое смещение, считаются устаревшими. MCP передаёт их, а API пока принимает, интерпретируя как UTC; в ответе API указывается, что формат устарел. Позднее такие значения перестанут приниматься; дату объявят заранее. Прочитать полное правило.
Запрос
Очищенный JSON-RPC
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_transits",
"arguments": {
"date": "2026-08-06T12:00:00",
"timezone": "UTC",
"natalChart": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York"
},
"idempotencyKey": "transits-2026-08-06-v1"
}
}
}Формат успешного ответа
- Положения планет в транзите
- Активированные ворота и каналы
- Связи с переданными исходными данными бодиграфа
Ответ также содержит метаданные тарифа и квоты, предоставленные уровнем прав API. Точные поля зависят от инструмента и запрошенного уровня детализации.
Ошибки
- Требуется тариф Startup
- Недопустимые исходные данные бодиграфа
- Недопустимая дата транзита
- Квота исчерпана
Расходование квоты
После успешного прохождения проверок входных данных, доступа и тарифа попытка, которая доходит до провайдера расчётов, расходует ровно одну общую единицу API — даже если на последующем этапе отображения возникнет сбой. Некорректные или неоднозначные данные, отказ по тарифу, неизвестные справочные элементы и другие ошибки до обращения к провайдеру ничего не расходуют. Проверяйте текущее использование на странице my.humandesign.ai.