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» означає 14:30 у Нью-Йорку.
Застарілий формат: Формат значень, що закінчуються на 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.