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
Ferramentas da plataforma por OAuth →
19 ferramentas de conta, renderização de gráficos, biblioteca, operações, status de relatórios e Builder expostas no momento.
Ferramentas de cálculo por chave de API →
6 ferramentas de cálculo e referência regidas pelo plano de API e pela cota de cálculo separados.
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-streamMétodos aceitos
initializeMétodo de conexão ou descoberta; não consome cota nem créditos de IA.
notifications/initializedMétodo de conexão ou descoberta; não consome cota nem créditos de IA.
pingMétodo de conexão ou descoberta; não consome cota nem créditos de IA.
tools/listMétodo de conexão ou descoberta; não consome cota nem créditos de IA.
tools/callExecuta 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 erro | Quando é retornado |
|---|---|
nonexistent_local_time | Uma mudança de horário de verão pulou esse horário local; ele nunca ocorreu nesse fuso. |
ambiguous_local_time | O horário local está dentro de uma repetição causada pelo horário de verão e ocorreu duas vezes nesse fuso. |
future_birth_datetime | O horário de nascimento está no futuro. |
invalid_birth_datetime_format | O 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
Primeiros passos →
Conecte-se por OAuth e faça uma primeira solicitação com segurança.
Assinaturas e permissões →
Entenda concessões de recursos, áreas de trabalho, propriedade e confirmações.
Claude, ChatGPT e Codex →
Baixe os arquivos de configuração e o pacote de plugins em dois formatos.
Autenticação →
Escolha OAuth ou acesso à API somente para cálculos por chave de API.