get_transits
Gunakan kolom kontrak `natalChart` untuk mengirim data bodygraph dasar, lalu minta konteks transit saat ini atau untuk tanggal tertentu. Pengenal literal dipertahankan demi kompatibilitas API.
Hasil bagi pengembang: Bangun pengalaman agen yang peka waktu tanpa menghitung posisi planet di sisi klien.
Parameter
| Nama | Ketik | Wajib | Deskripsi |
|---|---|---|---|
date | string (waktu lokal pada jam) | Ya | Momen transit eksplisit sebagai waktu lokal pada jam dalam zona yang diberikan, tanpa Z atau UTC offset. MCP mewajibkannya agar percobaan ulang dengan key merujuk momen yang sama. Tanggal boleh berada di masa depan. |
timezone | string | Tidak | Zona waktu IANA untuk momen transit. |
natalChart | object | Tidak | Masukan bodygraph opsional dengan birthDateTime dan timezone. birthDateTime adalah waktu lokal pada jam tanpa Z atau UTC offset. Nama kolom ini merupakan bagian dari kontrak backend. |
idempotencyKey | string | Ya | Key stabil untuk kalkulasi transit ini. Gunakan kembali hanya dengan argumen identik saat mencoba ulang. |
Waktu lahir adalah waktu lokal pada jam. Kirim tanggal dan waktu seperti yang terbaca pada jam di tempat orang tersebut lahir, tanpa Z atau UTC offset, dan berikan zona secara terpisah sebagai pengenal IANA. "birthDateTime": "1990-05-15T14:30:00" dengan "timezone": "America/New_York" berarti pukul setengah tiga sore di New York.
Tidak disarankan: Nilai yang diakhiri dengan Z atau offset numerik sudah tidak disarankan. MCP meneruskannya dan API masih menerimanya untuk saat ini dengan membacanya sebagai UTC; penghentian dukungan diumumkan dalam respons API. Nilai tersebut akan berhenti diterima dan tanggalnya akan diumumkan sebelumnya. Baca aturan lengkapnya.
Permintaan
JSON-RPC yang disanitasi
{
"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"
}
}
}Bentuk respons berhasil
- Posisi planet saat transit
- Gerbang dan kanal yang diaktifkan
- Koneksi ke masukan bodygraph yang diberikan
Respons juga mencakup metadata tingkat paket dan kuota dari lapisan hak API. Kolom domain yang tepat berbeda menurut alat dan tingkat detail yang diminta.
Kesalahan
- Memerlukan tingkat Startup
- Masukan bodygraph tidak valid
- Tanggal transit tidak valid
- Kuota habis
Perilaku kuota
Setelah validasi masukan, otorisasi, dan pemeriksaan tingkat paket berhasil, upaya eksekusi yang mencapai penyedia kalkulasi menggunakan tepat satu unit API bersama—meskipun tahap penyajian berikutnya gagal. Masukan rusak atau ambigu, tingkat paket yang ditolak, referensi tidak dikenal, dan kegagalan lain sebelum penyedia kalkulasi menggunakan nol unit. Periksa penggunaan terkini di my.humandesign.ai.