get_transits
Użyj pola kontraktu `natalChart`, aby przesłać dane bodygraph, a następnie poproś o bieżący lub wybrany kontekst tranzytów. Dosłowny identyfikator zachowano dla zgodności z API.
Korzyść dla dewelopera: Twórz zależne od czasu funkcje agentowe bez obliczania położeń planet w kliencie.
Parametry
| Imię | Typ | Wymagane | Opis |
|---|---|---|---|
date | string (lokalny czas zegarowy) | Tak | Jawny moment tranzytu jako lokalny czas zegarowy w podanej strefie, bez Z i bez przesunięcia UTC. MCP wymaga go, aby ponowienie z tym samym kluczem dotyczyło tej samej chwili. Może przypadać w przyszłości. |
timezone | string | Nie | Strefa czasowa IANA dla momentu tranzytu. |
natalChart | object | Nie | Opcjonalne dane o urodzeniu dla bodygraph, zawierające birthDateTime i timezone. birthDateTime to lokalny czas zegarowy bez Z i przesunięcia UTC. Nazwa pola jest częścią kontraktu backendu. |
idempotencyKey | string | Tak | Stabilny klucz dla tego konkretnego obliczenia tranzytu. Używaj go ponownie podczas ponawiania wywołania wyłącznie przy identycznych argumentach. |
Godziny urodzenia podawaj jako lokalny czas zegarowy. Podaj datę i godzinę dokładnie tak, jak wskazywał zegar w miejscu urodzenia, bez Z i bez przesunięcia UTC. Strefę czasową podaj osobno jako identyfikator IANA. Wartość "birthDateTime": "1990-05-15T14:30:00" wraz z "timezone": "America/New_York" oznacza godzinę 14:30 w Nowym Jorku.
Wycofywane: Wartości kończące się na Z lub zawierające przesunięcie liczbowe są wycofywane. MCP przekazuje je dalej, a API na razie nadal je akceptuje, odczytując jako UTC, i informuje o wycofywaniu w odpowiedzi. W przyszłości nie będą akceptowane; termin zostanie podany z wyprzedzeniem. Przeczytaj pełną zasadę.
Żądanie
Oczyszczony 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"
}
}
}Struktura odpowiedzi w przypadku powodzenia
- Położenia planet w tranzycie
- Aktywowane bramy i kanały
- Połączenia z przesłanymi danymi bodygraph
Odpowiedź zawiera również metadane poziomu i limitu dostarczone przez warstwę uprawnień API. Dokładne pola zależą od narzędzia i żądanego poziomu szczegółowości.
Błędy
- Wymagany poziom Startup
- Nieprawidłowe dane bodygraph
- Nieprawidłowa data tranzytu
- Przekroczony limit
Zasady limitu
Po pomyślnym przejściu weryfikacji danych, uprawnień i poziomu planu próba wykonania, która dotrze do dostawcy obliczeń, zużywa dokładnie jedną wspólną jednostkę API — nawet jeśli późniejszy etap prezentacji się nie powiedzie. Błędne lub niejednoznaczne dane, odmowa dostępu do poziomu, nieznane odwołania i inne problemy przed przekazaniem do dostawcy zużywają zero jednostek. Bieżące użycie sprawdzisz pod adresem my.humandesign.ai.