HumanDesign.ai MCP Quickstart

What MCP Supports in v1

The canonical HumanDesign.ai MCP server is available at https://mcp.humandesign.ai/. It uses stateless Streamable HTTP with protocol version 2025-11-25 and supports:

initialize
notifications/initialized
ping
tools/list
tools/call

Note: Send MCP requests with POST /. GET / returns 405. The dedicated host also accepts POST /mcp as a compatibility alias.

Authentication

Send your API key in headers. Query-string auth is not supported on MCP.

Authorization: Bearer your_api_key_here
X-Api-Key: your_api_key_here

Initialize

POST /
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

initialize is free and does not consume usage.

List Available Tools

POST /
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

The response is filtered by your API tier. Creator keys see four tools, Startup keys see five, and Business keys see all six.

Call a Tool

POST /
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core"
    }
  }
}

An authorized execution attempt consumes 1 API unit only when it reaches the calculation provider. Discovery calls and invalid arguments consume zero units.

Tool Results

Successful tool calls return a short text summary, a serialized JSON text block, and a structured JSON payload in structuredContent. The structured payload uses this envelope:

{
  "version": "v1",
  "tool": "generate_chart",
  "data": { ... },
  "meta": { ... }
}