HumanDesign.aiMCPBuka aplikasi ↗
UNTUK AI ANDADokumentasi
Alat MCP Startup

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

NamaKetikWajibDeskripsi
datestring (waktu lokal pada jam)YaMomen 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.
timezonestringTidakZona waktu IANA untuk momen transit.
natalChartobjectTidakMasukan 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.
idempotencyKeystringYaKey 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.

generate_chart · get_reference_item

Kembali ke atas ↑Perlu bantuan? Hubungi dukungan ↗

Temukan jawaban berikutnya.