HumanDesign.aiMCPアプリを開く ↗
AI向けドキュメント
Startup MCPツール

get_transits

契約フィールドの`natalChart`で基礎となるボディグラフデータを送信し、現在または指定日のトランジット情報を要求します。この識別子はAPIとの互換性のためそのまま使用します。

開発者向けの利点: クライアント側で惑星位置を計算することなく、時刻に応じたエージェント体験を構築できます。

パラメーター

氏名タイプ必須説明
datestring(現地の壁時計時刻)はい指定されたタイムゾーンにおけるトランジットの時刻を、ZもUTCオフセットも付けずに指定します。キー付き再試行で同じ時点を参照できるよう、MCPでは必須です。未来の時刻も指定できます。
timezonestringいいえトランジット時刻のIANAタイムゾーン。
natalChartobjectいいえbirthDateTimeとtimezoneを含む任意のボディグラフ出生情報。birthDateTimeはZもUTCオフセットも付けない現地の壁時計時刻です。フィールド名はバックエンド契約の一部です。
idempotencyKeystringはいこのトランジット計算を識別する固定キーです。再試行時は引数が同一の場合に限って再利用してください。

出生時刻は現地の壁時計時刻です。 出生した場所の時計に表示されていた日時を、ZやUTCオフセットを付けずに送信し、タイムゾーンはIANA識別子で別途指定してください。"birthDateTime": "1990-05-15T14:30:00" と "timezone": "America/New_York" は、ニューヨーク現地時間の午後2時30分を意味します。

非推奨: Zまたは数値オフセットで終わる値は非推奨です。MCPは値を転送し、APIは現在UTCとして受け付け、レスポンスで非推奨化を通知します。今後は受け付けなくなり、日程は事前に発表します。 ルール全文を読む.

リクエスト

サニタイズ済み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"
    }
  }
}

成功レスポンスの形式

  • トランジット時の惑星位置
  • 活性化しているゲートとチャネル
  • 指定されたボディグラフ入力との接続

レスポンスにはAPI利用権限レイヤーが提供するtierとクォータのメタデータも含まれます。ドメイン固有のフィールドはツールと要求する詳細レベルによって異なります。

エラー

  • Startup tierが必要です
  • ボディグラフ入力が無効です
  • トランジット日が無効です
  • クォータを超過しました

クォータの動作

入力検証、認可、tierチェックを通過した後、計算プロバイダーに到達する実行試行では、後続の表示処理が失敗した場合でも共有APIユニットを正確に1つ消費します。形式不正または曖昧な入力、拒否されたtier、不明な参照など、プロバイダーに到達する前の失敗は消費量ゼロです。現在の使用量は my.humandesign.ai.

generate_chart · get_reference_item

ページ上部へ ↑お困りですか?サポートにお問い合わせください ↗

次の答えを見つける。