Startup MCP 工具
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" 表示纽约当地下午两点半。
已弃用: 以 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 等级
- 人类图数据无效
- 行运日期无效
- 超出配额
配额行为
输入验证、授权和等级检查通过后,任何到达计算服务提供方的执行尝试都会消耗恰好 1 个共享 API 单位,即使后续呈现步骤失败也是如此。格式错误或含糊的输入、被拒绝的等级、未知参考项以及其他发生在服务提供方调用之前的问题均消耗 0 个单位。请在以下位置查看当前用量: my.humandesign.ai.