get_transits
Folosiți câmpul contractual `natalChart` pentru a trimite datele bodygraph de bază, apoi solicitați contextul tranzitelor curente sau pentru o dată specifică. Identificatorul literal este păstrat pentru compatibilitatea cu API-ul.
Rezultatul pentru dezvoltator: Creați experiențe pentru agenți care țin cont de timp, fără a calcula pozițiile planetare în client.
Parametri
| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
date | string (oră locală de pe ceas) | Da | Momentul explicit al tranzitului, indicat ca oră locală de pe ceas în fusul orar furnizat, fără Z și fără decalaj UTC. MCP îl solicită astfel încât o reîncercare cu aceeași cheie să vizeze același moment. Data poate fi în viitor. |
timezone | string | Nu | Fus orar IANA pentru momentul tranzitului. |
natalChart | object | Nu | Date de naștere bodygraph opționale, cu birthDateTime și timezone. birthDateTime este o oră locală de pe ceas, fără Z și fără decalaj UTC. Numele câmpului face parte din contractul backend. |
idempotencyKey | string | Da | Cheie stabilă pentru acest calcul de tranzit intenționat. Reutilizați-o numai cu argumente identice atunci când reîncercați. |
Orele nașterii sunt ore locale indicate de ceas. Trimiteți data și ora nașterii exact așa cum arăta ceasul în locul în care s-a născut persoana, fără Z și fără decalaj UTC, iar fusul orar transmiteți-l separat ca identificator IANA. "birthDateTime": "1990-05-15T14:30:00" împreună cu "timezone": "America/New_York" înseamnă ora două și jumătate după-amiaza la New York.
Depreciat: Valorile care se termină în Z sau conțin un decalaj numeric sunt depreciate. MCP le transmite, iar API-ul încă le acceptă pentru moment, interpretându-le ca UTC și anunțând deprecierea în răspunsul API. Nu vor mai fi acceptate; data va fi anunțată în avans. Citiți regula completă.
Solicitare
JSON-RPC igienizat
{
"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"
}
}
}Structura răspunsului de succes
- Poziții planetare de tranzit
- Porți și canale activate
- Conexiuni la datele bodygraph furnizate
Răspunsul include și metadate despre nivel și cotă, furnizate de componenta care gestionează drepturile API. Câmpurile exacte ale domeniului variază în funcție de instrument și de nivelul de detaliu solicitat.
Erori
- Este necesar nivelul Startup
- Date bodygraph nevalide
- Dată de tranzit nevalidă
- Cotă epuizată
Comportamentul cotei
După trecerea verificărilor de validare a intrărilor, autorizare și nivel, o încercare de execuție care ajunge la furnizorul de calcul consumă exact o unitate API comună, chiar dacă un pas ulterior de prezentare eșuează. Intrările malformate sau ambigue, nivelurile neautorizate, referințele necunoscute și alte erori apărute înainte de furnizor consumă zero. Verificați utilizarea actuală la my.humandesign.ai.