Human Design MCP
Documentation

Connect an agent to Human Design.

Human Design MCP is a remote Streamable HTTP server at https://api.humandesign.ai/mcp. It gives compatible AI clients a small, structured catalog of bodygraph and reference tools backed by the HumanDesign.ai API.

Scope: this documentation covers the six live MCP tools. For REST endpoints, forecasts, returns, webhooks, batch processing, and Agent HTTP, use HumanDesignAPI.com.

Protocol surface

The server accepts JSON-RPC requests over HTTP POST. Authenticate every request with either a Bearer token or an X-Api-Key header.

Endpoint

POST https://api.humandesign.ai/mcp
Authorization: Bearer $HDAI_API_KEY
Content-Type: application/json

Supported methods

initialize

Connection or discovery method; it does not consume an API unit.

notifications/initialized

Connection or discovery method; it does not consume an API unit.

ping

Connection or discovery method; it does not consume an API unit.

tools/list

Connection or discovery method; it does not consume an API unit.

tools/call

Executes a tool and consumes one shared API unit after entitlement checks pass.

Where to begin

Getting started →

Initialize a session, discover your tools, and make your first call.

Authentication →

Keep the same API key safe across MCP, REST, and Agent HTTP.

Six live tools →

Review schemas, tier access, quota behavior, and examples.

Client guides →

Connect Claude, Codex, Cursor, or VS Code.

Live catalog

6 tools are documented and validated against the production API catalog.