Client guide

Human Design MCP for Codex.

Register the remote server in Codex and keep the API key in your environment.

Before you connect

  1. Get an API key—the Free plan includes 100 calls and four core tools.
  2. Store it as HDAI_API_KEY or use the client's secret input.
  3. Add the remote endpoint—there is no local MCP package to install.

Configuration

Codex example

[mcp_servers.human_design]
url = "https://api.humandesign.ai/mcp"
bearer_token_env_var = "HDAI_API_KEY"

Client configuration formats can evolve. The stable integration contract is a remote Streamable HTTP URL at https://api.humandesign.ai/mcp with Bearer or X-Api-Key authentication.

Verify the connection

Initialize the server, run tools/list, and confirm the catalog matches your tier. These checks do not consume API quota. Then ask Codex to call resolve_timezone or generate a core bodygraph.

Read the JSON-RPC quickstart →