get_transits
Use o campo do contrato `natalChart` para enviar os dados subjacentes do bodygraph e, em seguida, solicite o contexto dos trânsitos atuais ou de uma data específica. O identificador literal é mantido para compatibilidade com a API.
Resultado para o desenvolvedor: Crie experiências de agentes sensíveis ao tempo sem calcular posições planetárias no cliente.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
date | string (horário local) | Sim | Momento explícito do trânsito como horário local no fuso informado, sem Z nem deslocamento UTC. O MCP exige esse valor para que uma nova tentativa com chave se refira ao mesmo instante. Pode estar no futuro. |
timezone | string | Não | Fuso horário IANA do momento do trânsito. |
natalChart | objeto | Não | Entrada opcional de nascimento do bodygraph com birthDateTime e timezone. birthDateTime é um horário local sem Z nem deslocamento UTC. O nome do campo faz parte do contrato do backend. |
idempotencyKey | string | Sim | Chave estável para este cálculo de trânsito. Reutilize-a somente com argumentos idênticos ao tentar novamente. |
Os horários de nascimento são horários locais. Envie a data e a hora de nascimento como aparecem no relógio do local onde a pessoa nasceu, sem Z nem deslocamento UTC, e informe o fuso separadamente como identificador IANA. "birthDateTime": "1990-05-15T14:30:00" com "timezone": "America/New_York" significa duas e meia da tarde em Nova York.
Obsoleto: Valores terminados em Z ou com deslocamento numérico estão obsoletos. O MCP os encaminha e a API ainda os aceita por enquanto, interpretando-os como UTC, e informa a descontinuação na resposta da API. Eles deixarão de ser aceitos; a data será anunciada com antecedência. Leia a regra completa.
Solicitação
JSON-RPC sanitizado
{
"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 da resposta de sucesso
- Posições planetárias de trânsito
- Portas e canais ativados
- Conexões com os dados de bodygraph informados
A resposta também inclui metadados do nível e da cota fornecidos pela camada de permissões da API. Os campos exatos do domínio variam conforme a ferramenta e o nível de detalhe solicitado.
Erros
- Requer o nível Startup
- Dados de bodygraph inválidos
- Data de trânsito inválida
- Cota excedida
Funcionamento da cota
Após a validação da entrada, a autorização e as verificações de nível serem aprovadas, uma tentativa que chega ao provedor de cálculos consome exatamente uma unidade compartilhada da API, mesmo que uma etapa posterior de apresentação falhe. Entradas malformadas ou ambíguas, níveis não autorizados, referências desconhecidas e outras falhas anteriores ao provedor não consomem unidades. Consulte o uso atual em my.humandesign.ai.