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
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
date | sträng (lokal klocktid) | Ja | Uttryckligt 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. |
timezone | sträng | Nej | IANA-tidszon för transitögonblicket. |
natalChart | objekt | Nej | Valfria 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. |
idempotencyKey | sträng | Ja | Stabil 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.