Client guide

Human Design MCP for VS Code.

Configure a remote HTTP MCP server in your workspace without committing the key.

API-key calculation setup

  1. Get a protected API key—the Free API plan includes the four core calculation/reference tools.
  2. Store it as HDAI_API_KEY or use the client's protected secret input.
  3. Add the remote endpoint; never commit the key.

VS Code example

{"servers":{"human-design":{"type":"http","url":"https://mcp.humandesign.ai/","headers":{"X-Api-Key":"${input:hdaiApiKey}"}}}}

OAuth visibility follows HumanDesign.ai Free/Individual/Personal/Pro membership and entitlements. API-key visibility follows the separate Free/Creator/Startup/Business API plan. Neither credential type bypasses ownership or quota checks.

Verify the connection

Run tools/list and confirm the catalog matches the account boundary; discovery is free. Ask for “my chart” and verify the client uses chart_get_primary, not a name search. If none exists, ask it to preview chart_generate and confirm only after checking the normalized birth details and one-unit quota estimate. Then request a PNG and confirm either the inline image or its short-lived download link appears. Personal or Pro is required for other people's authorized charts.

Download the plugin and setup files →