Startup MCPツール
get_transits
契約フィールドの`natalChart`で基礎となるボディグラフデータを送信し、現在または指定日のトランジット情報を要求します。この識別子はAPIとの互換性のためそのまま使用します。
開発者向けの利点: クライアント側で惑星位置を計算することなく、時刻に応じたエージェント体験を構築できます。
パラメーター
| 氏名 | タイプ | 必須 | 説明 |
|---|---|---|---|
date | string(現地の壁時計時刻) | はい | 指定されたタイムゾーンにおけるトランジットの時刻を、ZもUTCオフセットも付けずに指定します。キー付き再試行で同じ時点を参照できるよう、MCPでは必須です。未来の時刻も指定できます。 |
timezone | string | いいえ | トランジット時刻のIANAタイムゾーン。 |
natalChart | object | いいえ | birthDateTimeとtimezoneを含む任意のボディグラフ出生情報。birthDateTimeはZもUTCオフセットも付けない現地の壁時計時刻です。フィールド名はバックエンド契約の一部です。 |
idempotencyKey | string | はい | このトランジット計算を識別する固定キーです。再試行時は引数が同一の場合に限って再利用してください。 |
出生時刻は現地の壁時計時刻です。 出生した場所の時計に表示されていた日時を、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.