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
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
date | tekenreeks (lokale kloktijd) | Ja | Expliciet 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. |
timezone | tekenreeks | Nee | IANA-tijdzone van het transitmoment. |
natalChart | object | Nee | Optionele 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. |
idempotencyKey | tekenreeks | Ja | Stabiele 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.