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
| Nombre | Tránsitos diarios | Obligatorio | Descripción |
|---|---|---|---|
date | cadena (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. |
timezone | cadena | No | Zona horaria IANA del instante de tránsito. |
natalChart | objeto | No | Datos 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. |
idempotencyKey | cadena | Sí | 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.