Human Design MCP
officialHumanDesign.ai MCP is the official account-connected Human Design server for Claude, ChatGPT, Codex, Cursor, and VS Code.
Documentation
The remote Human Design MCP server
Give your agent
Human Design tools.
One OAuth connection gives Claude, ChatGPT, Codex, and custom agents membership-aware access to your charts and HumanDesign.ai workspace—without running another server.
Install the connector Connect an agent
OAuth account connectionPNG chart graphicsFree own-chart access0 server setup
A clean first connection
Your agent discovers what it can do.
Add one endpoint and sign in with HumanDesign.ai. MCP handles OAuth, membership-aware discovery, 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
Designed for agent workflows
Protocol-native.
Production-ready.
The MCP is a supported surface of the HumanDesign.ai API, with the same calculations, entitlements, and operational infrastructure.
Agent-led discovery
Let the model inspect the available tools and their schemas instead of hard-coding endpoint knowledge into every prompt.
Structured results
Tool calls return predictable JSON that an agent can reason over or pass into the rest of your product.
Membership-aware access
Free is limited to the user's own primary chart. 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.
Hosted transport
Connect over Streamable HTTP. There is no local package, proxy, or separate MCP server for your team to maintain.
One HDAI authority
HumanDesign.ai remains authoritative for ownership, membership, workspace roles, quota, AI credits, and confirmations.
Two tool surfaces
Your account plus
calculation tools.
OAuth exposes permitted account, chart graphic, library, operation, report-status, and Builder tools. API keys preserve the six calculation/reference tools below.
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
Plans for experiments and production
Start free.
Scale the same key.
Successful tools/call operations consume shared API units. Connection, ping, and discovery checks do not.
Free
$0forever
Let an agent test the connection and four core tools.
100 calls/month
4 core tools
Start free
Creator
$25/month
Build with core bodygraph and reference tools.
10,000 calls/month
4 core tools
Choose Creator
Startup
$50/month
Add full-detail bodygraphs and transit intelligence.
100,000 calls/month
5 tools, including get_transits
Choose Startup
Business
$200/month
Ship higher-volume products with celebrity search.
1,000,000 calls/month
All six tools
Choose 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.
Compare MCP and REST
MCPAgent chooses a toolPOST /mcp
RESTApplication chooses a routeGET /v3/hd-data
One API key · shared quotas · the same HDAI calculation engine