HumanDesign.aiMCPApri l'app ↗
PER LA TUA IADocumentazione
Strumento MCP di avvio

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

NomeTipoObbligatorioDescrizione
datestringa (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.
timezonestringaNoFuso orario IANA del momento del transito.
natalChartoggettoNoDati 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.
idempotencyKeystringaSì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.

generate_chart · get_reference_item

Torna all'inizio ↑Ti serve aiuto? Contatta l'assistenza ↗

Trova la prossima risposta.