API

Technical documentation for developers integrating with the HumanDesign.ai API.

Agent HTTP API ReferenceBase Path The normalized Agent HTTP API lives under: https://api.humandesign.ai/agent/v1/tools Every route is POST only and requires header authentication. Authentication X-Api-Key: your_api_key_here Authorization: Bearer your_api_key_here…
API Access Tiers and BillingTier Mapping HumanDesign.ai enforces plan access by tier, not just by whether an API key is valid. Tier PMPro Level Quota Summary Creator 18 1,000…
Get Composite Relationship Chart: Compare Two PeopleEndpoint GET /hd-data-composite Description Generates a composite Human Design chart using two people's birth data, ideal for relationship or partnership analysis. Required Parameters api_key date…
Get Human Design Chart: Endpoint GuideEndpoint GET /hd-data Description Retrieves a basic Human Design chart based on a person’s birth data. Required Parameters api_key – Your API key date –…
HDAI API: Complete ReferenceHuman Design AI API — Complete Reference The HDAI API is a RESTful service built on ASP.NET Core that calculates Human Design bodygraph charts using…
How to Get a Human Design API KeyHow API Keys Are Created Your API key is created automatically after you purchase an eligible API membership on my.humandesign.ai. The purchase flow is powered…
Human Design API OverviewOverview The HumanDesign.ai API ships in three surfaces that share the same membership billing system: Legacy REST for direct endpoint integrations. Agent HTTP at https://api.humandesign.ai/agent/v1/tools/*…
HumanDesign.ai MCP QuickstartWhat 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:…
MCP Tools ReferenceAvailable MCP Tools Tool Minimum Tier Purpose resolve_timezone Creator Search locations and return matching IANA timezones. generate_chart Creator Generate a natal chart. detailLevel=full requires Startup.…
Search City Locations: Timezone & Geo MatchingEndpoint GET /locations Description Searches for cities based on a query and returns IANA timezones and geographic data. Useful when users don’t know their exact…