Human Design MCP
The trusted Human Design engine for AI agents

Build with the data
that powers HumanDesign.ai.

Connect Claude, ChatGPT, Codex, or your own agent to the same validated, versioned calculation service that powers HumanDesign.ai, with secure OAuth, deterministic graphics, and transparent usage metadata.

Install the connector Connect an agent
One calculation authorityValidated locations & timezonesVersioned structured resultsVisible quota effects
A dependable first connection

Your agent discovers what it can do.

Add one endpoint and sign in with HumanDesign.ai. MCP handles OAuth, membership-aware discovery, input validation, schemas, and structured results.

01
Connect

Point the client at the hosted Streamable HTTP endpoint.

02
Discover

tools/list returns only the tools available to the active plan.

03
Work

The agent uses only the tools allowed by membership, role, ownership, and entitlement.

human-design.mcpStreamable HTTP
# Remote server
url = "https://mcp.humandesign.ai/"
auth = "oauth"

# Discover the permitted catalog
method = "tools/list"

# Render an authorized chart
name = "chart_render"
AGENT
MCP
HDAI
Reliability you can verify

One authority.
Consistent results.

The MCP delegates calculation and ownership decisions to HumanDesign.ai. It does not teach a language model to approximate chart mathematics or invent account access.

Agent-led discovery

Let the model inspect the available tools and their schemas instead of hard-coding endpoint knowledge into every prompt.

Versioned contracts

Tool calls return validated, predictable JSON with calculation version, quota metadata, request identity, and explicit errors.

Membership-aware access

Free and Individual are limited to the user's own primary chart; Individual also includes usage visibility. Personal and Pro unlock wider permitted account features.

Delegated OAuth

The client handles browser login and refresh tokens. Passwords and tokens never belong in the prompt.

Deterministic graphics

Chart and composite images are rendered from authoritative chart data and are only reported as complete after the asset is verified.

The HumanDesign.ai engine

The API remains authoritative for validated birth inputs, calculations, entitlements, quota, and errors across every integration surface.

Two credential surfaces, one authority

Your account plus
calculation tools.

OAuth exposes permitted account, primary-chart, graphics, library, operation, report-status, and Builder tools. API keys preserve the six calculation/reference tools below. Neither route bypasses the HumanDesign.ai data and entitlement authority.

Explore platform toolsReview permissions
01

resolve_timezone

API Free

Turn a place name into a calculation-ready IANA timezone.

Read calculation docs 02

generate_chart

API Free

Generate structured Human Design bodygraph data from birth details.

Read calculation docs 03

generate_composite_chart

API Free

Compare two bodygraphs through a structured composite.

Read calculation docs 04

get_reference_item

API Free

Retrieve a gate, channel, center, or profile reference item.

Read calculation docs 05

get_transits

API Startup

Overlay transit conditions on an existing bodygraph input.

Read calculation docs 06

search_celebrities

API Business

Search the HumanDesign.ai celebrity chart catalog by name.

Read calculation docs
Developer API plans

Start free.
Scale the same key.

API plans are separate from HumanDesign.ai Free, Individual, Personal, and Pro memberships. Authorized provider-reaching calculations consume API units; connection, validation, ping, and discovery do not.

API Free
$0forever

Test the calculation connection and four core tools.

100 calls/month

4 core tools

Start API Free
API Creator
$25/month

Build with core bodygraph and reference tools.

10,000 calls/month

4 core tools

Choose API Creator
API Startup
$50/month

Add full-detail bodygraphs and transit intelligence.

100,000 calls/month

5 tools, including get_transits

Choose API Startup
API Business
$200/month

Ship higher-volume products with celebrity search.

1,000,000 calls/month

All six tools

Choose API Business
One engine, different interfaces

MCP for agents.
REST for applications.

Use this site for AI-agent integration. Use HumanDesignAPI.com when your application needs the complete REST and Agent HTTP catalog. Both are backed by the same HumanDesign.ai calculation authority.

Compare MCP and REST
MCPAgent chooses a toolPOST https://mcp.humandesign.ai/
RESTApplication chooses a routeGET /v3/hd-data

OAuth for private account tools · API keys for calculations · one authoritative engine