get_transits
Usa il campo del contratto `natalChart` per inviare i dati sottostanti del bodygraph, quindi richiedi il contesto dei transiti attuali o di una data specifica. L’identificatore letterale viene mantenuto per garantire la compatibilità con l’API.
Risultato per lo sviluppatore: Crea esperienze di agenti sensibili al tempo senza calcolare le posizioni planetarie nel client.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
date | stringa (ora locale) | Sì | Momento esplicito del transito, espresso come ora locale nel fuso orario indicato, senza Z né scostamento UTC. MCP lo richiede affinché un tentativo con chiave si riferisca allo stesso istante. Può essere nel futuro. |
timezone | stringa | No | Fuso orario IANA del momento del transito. |
natalChart | oggetto | No | Dati di nascita facoltativi del bodygraph con birthDateTime e timezone. birthDateTime è un’ora locale senza Z né scostamento UTC. Il nome del campo fa parte del contratto del backend. |
idempotencyKey | stringa | Sì | Chiave stabile per questo calcolo del transito. Riutilizzala solo con argomenti identici durante un nuovo tentativo. |
Gli orari di nascita sono espressi nell’ora locale. Invia data e ora di nascita come appaiono sull’orologio del luogo di nascita, senza Z né scostamento UTC, e specifica separatamente il fuso orario con un identificatore IANA. "birthDateTime": "1990-05-15T14:30:00" con "timezone": "America/New_York" indica le due e mezza del pomeriggio a New York.
Deprecato: I valori che terminano con Z o con un offset numerico sono deprecati. MCP li inoltra e per ora l’API li accetta ancora, interpretandoli come UTC; la risposta API segnala la deprecazione. In futuro non saranno più accettati e la data verrà comunicata in anticipo. Leggi la regola completa.
Richiesta
JSON-RPC sanificato
{
"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"
}
}
}Struttura della risposta di successo
- Posizioni planetarie dei transiti
- Porte e canali attivati
- Connessioni ai dati bodygraph forniti
La risposta include anche i metadati relativi al piano e alla quota forniti dal livello di autorizzazione dell’API. I campi esatti del dominio variano in base allo strumento e al livello di dettaglio richiesto.
Errori
- È richiesto il piano Startup
- Dati bodygraph non validi
- Data del transito non valida
- Quota superata
Comportamento della quota
Dopo il superamento della convalida dell’input, dell’autorizzazione e dei controlli del piano, ogni tentativo di esecuzione che raggiunge il servizio di calcolo consuma esattamente un’unità API condivisa, anche se una fase successiva di presentazione non riesce. Input malformati o ambigui, piani non autorizzati, riferimenti sconosciuti e altri errori precedenti al servizio consumano zero unità. Verifica l’utilizzo attuale su my.humandesign.ai.