HumanDesign.aiMCPAbrir la aplicación ↗
PARA TU IADocumentación
Herramienta MCP para Startup

get_transits

Usa el campo contractual natalChart para enviar los datos subyacentes del bodygraph y después solicita el contexto de tránsito actual o para una fecha concreta. El identificador literal se conserva por compatibilidad con la API.

Resultado para desarrolladores: Crea experiencias de agente que tengan en cuenta el tiempo sin calcular posiciones planetarias en el cliente.

Parámetros

NombreTránsitos diariosObligatorioDescripción
datecadena (hora local)SíInstante de tránsito explícito como hora local en la zona horaria indicada, sin Z ni desfase UTC. MCP lo requiere para que un reintento con la misma clave se refiera al mismo instante. Puede estar en el futuro.
timezonecadenaNoZona horaria IANA del instante de tránsito.
natalChartobjetoNoDatos opcionales de nacimiento para el bodygraph con birthDateTime y timezone. birthDateTime es una hora local sin Z ni desfase UTC. El nombre del campo forma parte del contrato del backend.
idempotencyKeycadenaSíClave estable para este cálculo de tránsito previsto. Reutilízala solo con argumentos idénticos al reintentar.

Las horas de nacimiento son horas locales de reloj. Envía la fecha y hora de nacimiento tal como aparecían en el reloj del lugar de nacimiento, sin Z ni desfase UTC, e indica la zona horaria por separado mediante un identificador IANA. "birthDateTime": "1990-05-15T14:30:00" con "timezone": "America/New_York" significa las dos y media de la tarde en Nueva York.

Obsoleto: Los valores que terminan en Z o en un desfase numérico están obsoletos. MCP los reenvía y la API todavía los acepta por ahora, interpretándolos como UTC; la respuesta de la API indica que están obsoletos. Dejarán de aceptarse y la fecha se anunciará con antelación. Lee la regla completa.

Solicitud

JSON-RPC depurado

{
  "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"
    }
  }
}

Formato de respuesta correcta

  • Posiciones planetarias de tránsito
  • Puertas y canales activados
  • Conexiones con los datos del bodygraph proporcionados

La respuesta también incluye metadatos de nivel y cupo proporcionados por la capa de permisos de la API. Los campos exactos varían según la herramienta y el nivel de detalle solicitado.

Errores

  • Se requiere el nivel Startup
  • Datos de bodygraph no válidos
  • Fecha de tránsito no válida
  • Cupo excedido

Comportamiento del cupo

Tras superar la validación de datos, la autorización y las comprobaciones de nivel, un intento de ejecución que llega al proveedor de cálculo consume exactamente una unidad de API compartida, incluso si falla un paso posterior de presentación. Los datos mal formados o ambiguos, los niveles denegados, las referencias desconocidas y otros errores previos al proveedor consumen cero. Consulta el uso actual en my.humandesign.ai.

generate_chart · get_reference_item

Volver arriba ↑¿Necesitas ayuda? Contacta con soporte ↗

Encuentra tu próxima respuesta.