get_transits
계약 필드 `natalChart`에 기반 바디그래프 데이터를 제출한 다음 현재 또는 지정 날짜의 트랜짓 맥락을 요청하세요. API 호환성을 위해 필드 식별자는 그대로 유지됩니다.
개발자에게 제공되는 이점: 클라이언트에서 행성 위치를 계산하지 않고도 시간 맥락을 반영하는 에이전트 경험을 구축하세요.
매개변수
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
date | 문자열(현지 시계 시간) | 예 | 지정한 시간대의 현지 시계 시간으로 트랜짓 시점을 명시하세요. Z나 UTC 오프셋은 붙이지 마세요. MCP에서는 키가 지정된 재시도가 동일한 시점을 가리키도록 날짜와 시각이 필요합니다. 미래 시점도 사용할 수 있습니다. |
timezone | 문자열 | 아니요 | 트랜짓 시점에 적용되는 IANA 시간대입니다. |
natalChart | 객체 | 아니요 | birthDateTime 및 timezone을 포함하는 선택적 바디그래프 출생 정보입니다. birthDateTime은 Z 또는 UTC 오프셋이 없는 현지 시계 시간입니다. 필드 이름은 백엔드 계약의 일부입니다. |
idempotencyKey | 문자열 | 예 | 이번 트랜짓 계산에 사용할 안정적인 키입니다. 재시도할 때는 인수가 동일한 경우에만 다시 사용하세요. |
출생 시각은 현지 시계 시간으로 입력합니다. 출생한 장소의 시계에 표시된 그대로의 날짜와 시간을 보내고 Z나 UTC 오프셋은 붙이지 말고 시간대는 IANA 식별자로 별도 지정하세요. "birthDateTime": "1990-05-15T14:30:00"과 "timezone": "America/New_York"는 뉴욕 현지 시각으로 오후 2시 30분을 뜻합니다.
사용 중단 예정: Z 또는 숫자 오프셋으로 끝나는 값은 더 이상 사용되지 않습니다. 현재 MCP는 이를 전달하고 API는 당분간 UTC로 해석해 계속 허용하며, API 응답에서 사용 중단 안내를 제공합니다. 해당 값은 추후 허용되지 않을 예정이며, 적용일은 미리 공지됩니다. 전체 규칙 읽기.
요청
정제된 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 이용 자격 계층에서 제공하는 요금제 및 할당량 메타데이터도 포함됩니다. 정확한 도메인 필드는 도구와 요청한 상세 수준에 따라 다릅니다.
오류
- Startup 요금제 필요
- 잘못된 바디그래프 입력
- 잘못된 트랜짓 날짜
- 할당량 초과
할당량 사용 방식
입력 검증, 권한 부여 및 요금제 확인을 통과한 뒤 계산 제공자에 도달하는 실행 시도는 정확히 공유 API 단위 1개를 사용합니다. 이후 표시 단계에서 실패하더라도 같습니다. 잘못되었거나 모호한 입력, 거부된 요금제, 알 수 없는 참조 정보 및 제공자에 도달하기 전 발생한 오류는 사용량이 0입니다. 현재 사용량은 다음에서 확인하세요. my.humandesign.ai.