HumanDesign.aiMCPÖppna appen ↗
FÖR DIN AIDokumentation
MCP-verktyg för Startup

get_transits

Använd kontraktsfältet natalChart för att skicka in underliggande bodygraph-data och begär sedan aktuell eller daterad transitkontext. Den bokstavliga identifieraren bevaras för API-kompatibilitet.

Utvecklarens resultat: Skapa tidsmedvetna agentupplevelser utan att beräkna planetpositioner i klienten.

Parametrar

NamnTypObligatoriskBeskrivning
datesträng (lokal klocktid)JaUttryckligt transitögonblick som lokal klocktid i den angivna tidszonen, utan Z och utan UTC-offset. MCP kräver detta så att ett försök med samma nyckel avser samma ögonblick. Tiden kan ligga i framtiden.
timezonesträngNejIANA-tidszon för transitögonblicket.
natalChartobjektNejValfria födelsedata för bodygraph med birthDateTime och timezone. birthDateTime är lokal klocktid utan Z och utan UTC-offset. Fältnamnet ingår i backendkontraktet.
idempotencyKeysträngJaStabil nyckel för den här avsedda transitberäkningen. Återanvänd den endast med identiska argument vid omförsök.

Födelsetider anges som lokal klocktid. Ange födelsedatum och klockslag som det visades på klockan där personen föddes, utan Z och utan UTC-offset. Ange tidszonen separat som en IANA-identifierare. "birthDateTime": "1990-05-15T14:30:00" med "timezone": "America/New_York" betyder halv tre på eftermiddagen i New York.

Föråldrad: Värden som slutar med Z eller en numerisk offset fasas ut. MCP vidarebefordrar dem och API:et accepterar dem tills vidare, tolkar dem som UTC och meddelar om utfasningen i API-svaret. De kommer inte längre att accepteras; datumet meddelas i förväg. Läs den fullständiga regeln.

Begäran

Sanerad 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 för lyckat svar

  • Planetpositioner för transiter
  • Aktiverade portar och kanaler
  • Kopplingar till angivna bodygraph-data

Svaret innehåller också metadata om nivå och kvot från API-behörighetslagret. Exakta fält varierar beroende på verktyg och begärd detaljnivå.

Fel

  • Startup-nivå krävs
  • Ogiltiga bodygraph-data
  • Ogiltigt transitdatum
  • Kvoten är överskriden

Kvotförbrukning

När validering av indata, auktorisering och nivåkontroller har godkänts förbrukar ett körningsförsök som når beräkningsleverantören exakt en gemensam API-enhet, även om ett senare presentationssteg misslyckas. Felaktiga eller tvetydiga indata, nekade nivåer, okända referenser och andra fel före leverantörsanrop förbrukar noll. Kontrollera aktuell användning på my.humandesign.ai.

generate_chart · get_reference_item

Till toppen ↑Behöver du hjälp? Kontakta support ↗

Hitta ditt nästa svar.