HumanDesign.aiMCPÅbn app ↗
TIL DIN AIDokumentation
MCP-værktøj til Startup

get_transits

Brug kontraktfeltet `natalChart` til at indsende de underliggende bodygraphdata, og anmod derefter om transitkontekst for nu eller en bestemt dato. Den bogstavelige identifikator bevares af hensyn til API-kompatibilitet.

Resultat for udviklere: Byg tidsfølsomme agentoplevelser uden at beregne planetpositioner i klienten.

Parametre

NavnTypePåkrævetBeskrivelse
datestreng (lokalt klokkeslæt)JaEksplicit transitøjeblik som lokalt klokkeslæt i den angivne tidszone, uden Z eller UTC-forskydning. MCP kræver det, så et nyt forsøg med nøgle vedrører samme øjeblik. Tidspunktet må ligge i fremtiden.
timezonestrengNejIANA-tidszone for transitøjeblikket.
natalChartobjektNejValgfri bodygraphfødselsinput med birthDateTime og timezone. birthDateTime er et lokalt klokkeslæt uden Z eller UTC-forskydning. Feltnavnet er en del af backendkontrakten.
idempotencyKeystrengJaStabil nøgle til denne tilsigtede transitberegning. Genbrug den kun med identiske argumenter ved nye forsøg.

Fødselsklokkeslæt er lokale klokkeslæt. Send fødselsdato og -klokkeslæt, præcis som uret viste det på personens fødested, uden Z eller UTC-forskydning, og angiv tidszonen separat som en IANA-identifikator. "birthDateTime": "1990-05-15T14:30:00" med "timezone": "America/New_York" betyder halv tre om eftermiddagen i New York.

Forældet: Værdier, der slutter med Z eller en numerisk forskydning, er forældede. MCP videresender dem, og API’et accepterer dem stadig foreløbigt som UTC og beregner ud fra det. Udfasningen oplyses i API-svaret. De accepteres ikke længere; datoen annonceres på forhånd. Læs hele reglen.

Anmodning

Sanitiseret 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 for et vellykket svar

  • Planetpositioner for transitter
  • Aktiverede gates og kanaler
  • Forbindelser til de angivne bodygraphdata

Svaret indeholder også metadata om niveau og kvote fra API’ets adgangslag. De præcise domænefelter varierer efter værktøj og det ønskede detaljeringsniveau.

Fejl

  • Startup-niveau kræves
  • Ugyldige bodygraphdata
  • Ugyldig transitdato
  • Kvote overskredet

Kvoteadfærd

Når inputvalidering, godkendelse og niveaukontrol er bestået, bruger et forsøg, der når beregningsudbyderen, præcis én delt API-enhed—selv hvis et efterfølgende præsentationstrin mislykkes. Forkert eller tvetydigt input, afviste niveauer, ukendte referencer og andre fejl før udbyderen bruger nul. Se aktuelt forbrug på my.humandesign.ai.

generate_chart · get_reference_item

Tilbage til toppen ↑Brug for hjælp? Kontakt support ↗

Find dit næste svar.