HumanDesign.aiMCP打开应用 ↗
为您的 AI 打造文档
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.

generate_chart · get_reference_item

返回顶部 ↑需要帮助?联系支持团队 ↗

找到你的下一个答案。