Quickstart
Your first tool call in four steps.
Use any Streamable HTTP MCP client, or send the JSON-RPC sequence directly while developing your integration.
1. Get an API key
Start with the Free plan for 100 monthly calls and four core tools. The same key works across MCP, REST, and Agent HTTP.
2. Initialize
JSON-RPC
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-05",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Send requests to https://api.humandesign.ai/mcp with Authorization: Bearer … or X-Api-Key: ….
3. Discover your tools
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}The response is tier-aware: Free and Creator see four core tools, Startup adds get_transits and full chart detail, and Business adds search_celebrities. Discovery does not consume quota.
4. Call a tool
JSON-RPC
{
"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"
}
}
}A successful tools/call consumes one API unit. Connection and discovery checks—initialize, ping, and tools/list—do not.