REST API
Direct access to charts, Returns, forecasts, reference libraries, streams, and batch operations.
GET /v3/hd-data
Production API from HumanDesign.ai
One API. Every layer of
Human Design.
Launch Human Design apps, forecasts, relationship tools, calendars, and AI experiences with the same validated, versioned calculation service that powers HumanDesign.ai.
Free 100 calls/month · No credit card · REST + Agent HTTP + MCP
This is the Human Design API operated by HumanDesign.ai — not affiliated with humandesignapi.nl or other third-party chart APIs.
Choose how you build
Designed for products, automations, and agents.
One trusted calculation authority, exposed through three deliberate interfaces. Inputs are validated before calculation, contracts are versioned, and quota effects are explicit.
Agent HTTP
Six stable, versioned JSON tools with safe inputs and quota metadata for AI application runtimes.
POST /agent/v1/tools/generate-chart
Also supports get_chart. Chart request example
MCP
Connect Claude, Codex, Cursor, and other MCP clients over one Streamable HTTP transport.
POST https://mcp.humandesign.ai/
Setup: humandesignmcp.com
Ownership & differentiation
Why this API.
Proven production authority
The same validated calculation service and structured data power HumanDesign.ai itself.
Predictable agent usage
MCP and Agent HTTP discovery is free, their inputs are validated before charging, and one provider-reaching execution uses one unit.
Keys & billing in one place
Manage access at my.humandesign.ai.
Agent setup documented
MCP onboarding lives at humandesignmcp.com.
Not the same as humandesignapi.nl. That is a different company and a different product. If you need the HumanDesign.ai production engine — charts, composites, forecasts, Returns, SSE, and batch calculations — you are in the right place.
Beyond the bodygraph
The endpoints your product needs after launch.
Move from a chart prototype to a living experience without stitching together multiple data providers.
Forecasts & Returns
Planetary forecasts plus Solar, Lunar, Saturn, and Chiron Return calculations.
Relationships
Composite, enhanced chemistry, and group-level dynamics for two or more people.
Reference data
Structured gates, channels, centers, and profiles ready for search and education.
Live data formats
Server-Sent Events and calendar exports for experiences that keep moving.
A clean first request
From birth data to a complete bodygraph in one call.
Dates use ISO 8601. Locations use standard IANA timezones. Docs include parameters, examples, errors, and related operations.
Full bodygraph chartcURL
curl "https://api.humandesign.ai/v3/hd-data?Date=1990-05-15T14:30:00&Timezone=America/New_York" \
-H "Idempotency-Key: hdai-example-19900515" \
-H "X-Api-Key: YOUR_API_KEY"Simple monthly plans
Start free. Scale when your idea works.
Free includes 100 calls each month and the complete Creator feature set. No credit card required to begin.
Free
$0forever
Explore the API and ship your first prototype.
100 calls / month
- Core bodygraph charts
- Composite charts
- Location search
- Reference library
- Agent HTTP and MCP core tools
Creator
$25per month
For creators testing a Human Design product with real users.
10,000 calls / month
- Everything in Free
- Higher monthly allowance
- Commercial use
- API dashboard and usage tracking
Startup
$50per month
For production apps that need full charts and forecasts.
100,000 calls / month
- Everything in Creator
- Full v3 charts
- Transits and forecasts
- Solar, Lunar, Saturn and Chiron Returns
- Progressed charts
Business
$200per month
For high-volume platforms, automations and data products.
1,000,000 calls / month
- Everything in Startup
- Celebrity search
- Batch charts
- Calendars and exports
Create or manage your key at my.humandesign.ai.
Reliable calculations, validated structured data, and agent tools from HumanDesign.ai.
One trusted calculation authority. REST, Agent HTTP, and MCP.