HumanDesign.aiMCPApp openen ↗
VOOR JE AIDocumentatie
MCP-tool voor Startup

get_transits

Gebruik het contractveld `natalChart` om de onderliggende bodygraphgegevens te verzenden en vraag daarna om de context van huidige of gedateerde transits. De letterlijke ID blijft behouden voor API-compatibiliteit.

Resultaat voor ontwikkelaars: Bouw tijdgevoelige agentervaringen zonder planeetposities in de client te berekenen.

Parameters

NaamTypeVereistBeschrijving
datetekenreeks (lokale kloktijd)JaExpliciet transitmoment als lokale kloktijd in de opgegeven tijdzone, zonder Z of UTC-offset. MCP vereist dit zodat een nieuwe poging met sleutel naar hetzelfde moment verwijst. De tijd mag in de toekomst liggen.
timezonetekenreeksNeeIANA-tijdzone van het transitmoment.
natalChartobjectNeeOptionele geboorte-invoer voor de bodygraph met birthDateTime en timezone. birthDateTime is een lokale kloktijd zonder Z of UTC-offset. De veldnaam maakt deel uit van het backendcontract.
idempotencyKeytekenreeksJaStabiele sleutel voor deze beoogde transitberekening. Hergebruik deze alleen met identieke argumenten wanneer je het opnieuw probeert.

Geboortetijden zijn lokale kloktijden. Verstuur de geboortedatum en -tijd zoals die op de klok stonden op de geboorteplaats, zonder Z of UTC-offset, en geef de tijdzone apart op als IANA-ID. "birthDateTime": "1990-05-15T14:30:00" met "timezone": "America/New_York" betekent half drie ’s middags in New York.

Verouderd: Waarden die eindigen op Z of een numerieke offset bevatten, zijn verouderd. MCP stuurt ze door en de API accepteert ze voorlopig nog; de API leest ze als UTC en kondigt de veroudering aan in de API-respons. Ze worden niet langer geaccepteerd; de datum wordt vooraf aangekondigd. Lees de volledige regel.

Verzoek

Gesaniteerde 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"
    }
  }
}

Vorm van een geslaagd antwoord

  • Planeetposities tijdens transit
  • Geactiveerde poorten en kanalen
  • Verbindingen met de opgegeven bodygraphinvoer

Het antwoord bevat ook metagegevens over niveau en quota vanuit de API-autorisatielaag. De exacte domeinvelden verschillen per tool en het gevraagde detailniveau.

Fouten

  • Startup-niveau vereist
  • Ongeldige bodygraphinvoer
  • Ongeldige transitdatum
  • Quotum overschreden

Quotagedrag

Nadat de invoer-, autorisatie- en niveaucontroles zijn geslaagd, verbruikt een uitvoeringspoging die de rekenprovider bereikt precies één gedeelde API-eenheid, ook als een latere presentatiestap mislukt. Ongeldige of onduidelijke invoer, geweigerde niveaus, onbekende referenties en andere fouten vóór de provider verbruiken nul. Bekijk het huidige gebruik op my.humandesign.ai.

generate_chart · get_reference_item

Terug naar boven ↑Hulp nodig? Neem contact op met support ↗

Vind je volgende antwoord.