HumanDesign.aiMCPApp öffnen ↗
FÜR DEINE KIDokumentation
MCP-Tool für Startup

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

NameTypErforderlichBeschreibung
dateZeichenfolge (lokale Uhrzeit)JaExpliziter 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.
timezoneZeichenfolgeNeinIANA-Zeitzone des Transitzeitpunkts.
natalChartObjektNeinOptionale Bodygraph-Geburtsdaten mit birthDateTime und timezone. birthDateTime ist eine lokale Uhrzeit ohne Z und ohne UTC-Versatz. Der Feldname ist Teil des Backendvertrags.
idempotencyKeyZeichenfolgeJaStabiler 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.

generate_chart · get_reference_item

Zurück nach oben ↑Brauchst du Hilfe? Support kontaktieren ↗

Finde deine nächste Antwort.