Client guide

Human Design MCP for Cursor.

Add Human Design MCP as a remote Streamable HTTP server in your Cursor configuration.

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.

Cursor example

{"mcpServers":{"human-design":{"url":"https://mcp.humandesign.ai/","headers":{"Authorization":"Bearer ${env:HDAI_API_KEY}"}}}}

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 →