HumanDesign.aiMCPOtwórz aplikację ↗
DLA TWOJEJ SZTUCZNEJ INTELIGENCJIDokumentacja
Narzędzie MCP dostępne od planu Startup

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ęTypWymaganeOpis
datestring (lokalny czas zegarowy)TakJawny 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.
timezonestringNieStrefa czasowa IANA dla momentu tranzytu.
natalChartobjectNieOpcjonalne 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.
idempotencyKeystringTakStabilny 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.

generate_chart · get_reference_item

Wróć na górę ↑Potrzebujesz pomocy? Skontaktuj się z pomocą techniczną ↗

Znajdź kolejną odpowiedź.