HumanDesign.ai MCP Quickstart

What MCP Supports in v1

The HumanDesign.ai MCP server is available at https://api.humandesign.ai/mcp. It uses Streamable HTTP and supports:

initialize
notifications/initialized
ping
tools/list
tools/call

Note: GET /mcp returns 405 in v1. Use POST.

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 /mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-05",
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

initialize is free and does not consume usage.

List Available Tools

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

The response is filtered by your API tier. Creator keys only see Creator tools. Startup and Business see more.

Call a Tool

POST /mcp
{
  "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"
    }
  }
}

Each successful tools/call request consumes 1 API unit from the same monthly quota used by REST.

Tool Results

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

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