HumanDesign.aiMCPAbrir app ↗
PARA SUA IADocumentação
Ferramenta MCP para Startup

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

NomeTipoObrigatórioDescrição
datestring (horário local)SimMomento 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.
timezonestringNãoFuso horário IANA do momento do trânsito.
natalChartobjetoNãoEntrada 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.
idempotencyKeystringSimChave 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.

generate_chart · get_reference_item

Voltar ao topo ↑Precisa de ajuda? Fale com o suporte ↗

Encontre sua próxima resposta.