get_transits
Verwende das Vertragsfeld natalChart, um die zugrunde liegenden Bodygraph-Daten zu übermitteln, und fordere anschließend den aktuellen oder datierten Transitkontext an. Die wörtliche Kennung bleibt aus Gründen der API-Kompatibilität erhalten.
Ergebnis für Entwickler: Erstelle zeitabhängige Agentenerlebnisse, ohne Planetenpositionen im Client zu berechnen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
date | Zeichenfolge (lokale Uhrzeit) | Ja | Expliziter Transitzeitpunkt als lokale Uhrzeit in der angegebenen Zeitzone, ohne Z und ohne UTC-Versatz. MCP benötigt ihn, damit ein erneuter Versuch mit demselben Schlüssel denselben Zeitpunkt betrifft. Er darf in der Zukunft liegen. |
timezone | Zeichenfolge | Nein | IANA-Zeitzone des Transitzeitpunkts. |
natalChart | Objekt | Nein | Optionale Bodygraph-Geburtsdaten mit birthDateTime und timezone. birthDateTime ist eine lokale Uhrzeit ohne Z und ohne UTC-Versatz. Der Feldname ist Teil des Backendvertrags. |
idempotencyKey | Zeichenfolge | Ja | Stabiler Schlüssel für diese vorgesehene Transitberechnung. Verwende ihn bei einem erneuten Versuch nur mit identischen Argumenten. |
Geburtszeiten sind lokale Uhrzeiten. Gib Datum und Uhrzeit so an, wie sie auf der Uhr am Geburtsort standen, ohne Z und ohne UTC-Versatz, und gib die Zeitzone separat als IANA-Kennung an. „birthDateTime“: „1990-05-15T14:30:00“ mit „timezone“: „America/New_York“ bedeutet halb drei nachmittags in New York.
Veraltet: Werte mit abschließendem Z oder numerischem Versatz sind veraltet. MCP leitet sie weiter und die API akzeptiert sie vorerst noch, interpretiert sie dabei jedoch als UTC. Die API-Antwort weist auf die Veraltung hin. Sie werden künftig nicht mehr akzeptiert; das Datum wird rechtzeitig bekannt gegeben. Vollständige Regel lesen.
Anfrage
Bereinigtes 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"
}
}
}Format einer erfolgreichen Antwort
- Transit-Planetenpositionen
- Aktivierte Tore und Kanäle
- Verbindungen zu den übermittelten Bodygraph-Daten
Die Antwort enthält außerdem Tarif- und Kontingentmetadaten aus der API-Berechtigungsebene. Die konkreten Felder hängen vom Tool und dem angeforderten Detailgrad ab.
Fehler
- Startup-Tarif erforderlich
- Ungültige Bodygraph-Daten
- Ungültiges Transitdatum
- Kontingent überschritten
Kontingentverhalten
Nach erfolgreicher Eingabevalidierung, Autorisierung und Tarifprüfung verbraucht ein Ausführungsversuch, der den Berechnungsanbieter erreicht, genau eine gemeinsame API-Einheit – selbst wenn ein späterer Darstellungsschritt fehlschlägt. Fehlerhafte oder mehrdeutige Eingaben, abgelehnte Tarife, unbekannte Referenzen und andere Fehler vor dem Anbieteraufruf verbrauchen null Einheiten. Prüfe die aktuelle Nutzung unter my.humandesign.ai.