HumanDesign.aiMCPAbrir app ↗
PARA SUA IADocumentação
Documentação

Conecte um agente ao HumanDesign.ai.

O endpoint remoto canônico Streamable HTTP é https://mcp.humandesign.ai/. O OAuth conecta ferramentas privadas da conta; as chaves de API mantêm a interface de cálculo e referência da API.

Regra de assinatura: Usuários Free e Individual do HumanDesign.ai podem criar, salvar, visualizar e renderizar o próprio gráfico principal; o Individual também permite consultar o uso da conta. Personal ou Pro é necessário para ler gráficos autorizados de outras pessoas ou usar recursos mais amplos da conta. As ferramentas do Website Builder só aparecem quando o HumanDesign.ai habilita o Builder para sua conta e quando tools/list as anuncia.

Escolha uma forma de acesso

Interface do protocolo

O servidor aceita JSON-RPC por HTTP POST na raiz do domínio. GET e com nossa DELETE são intencionalmente rejeitados para o transporte MCP; GET /health expõe apenas metadados seguros de integridade do serviço.

Endpoint canônico

POST https://mcp.humandesign.ai/
Content-Type: application/json
Accept: application/json, text/event-stream

Métodos aceitos

initialize

Método de conexão ou descoberta; não consome cota nem créditos de IA.

notifications/initialized

Método de conexão ou descoberta; não consome cota nem créditos de IA.

ping

Método de conexão ou descoberta; não consome cota nem créditos de IA.

tools/list

Método de conexão ou descoberta; não consome cota nem créditos de IA.

tools/call

Executa uma ferramenta autorizada de acordo com as políticas de cobrança e confirmação.

Horários de nascimento são horas locais de relógio

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 horário separadamente como identificador IANA.

"birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.

Um valor com Z ou deslocamento, por si só, não informa um horário de relógio local. É necessário decidir em qual fuso interpretá-lo, e essa decisão altera o gráfico.

Z e deslocamentos UTC estão obsoletos. 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.

A API recusa horários locais que não correspondem a um único instante antes de consumir qualquer unidade de cálculo:

Código do erroQuando é retornado
nonexistent_local_timeUma mudança de horário de verão pulou esse horário local; ele nunca ocorreu nesse fuso.
ambiguous_local_timeO horário local está dentro de uma repetição causada pelo horário de verão e ocorreu duas vezes nesse fuso.
future_birth_datetimeO horário de nascimento está no futuro.
invalid_birth_datetime_formatO valor não representa um horário local. Após a transição, isso também inclui Z e deslocamentos numéricos.

As datas de trânsito usam o mesmo formato de horário local, mas podem estar no futuro.

Comece aqui

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

Encontre sua próxima resposta.