Human Design MCP

official

HumanDesign.ai MCP is the official account-connected Human Design server for Claude, ChatGPT, Codex, Cursor, and VS Code.

View on humandesignmcp.com

What can you do with Human Design MCP?

  • Resolve birth locations — Ask for to convert a place name into an IANA timezone for chart calculations.
  • Generate bodygraph data — Use with birth details to get structured Human Design bodygraph output.
  • Compare two charts — Request to analyze the relationship between two bodygraphs.
  • Look up reference items — Retrieve details on gates, channels, centers, or profiles.
  • Overlay transit conditions — Apply to see how current transits affect an existing chart.
  • Search celebrity charts — Find famous people's charts by name using from the catalog.

Documentation

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.

# Remote server
url = "https://mcp.humandesign.ai/"
auth = "oauth"

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

# Render an authorized chart
name = "chart_render"

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.

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.

[01

resolve_timezone

API Free

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

Read calculation docs](https://humandesignmcp.com/docs/tools/resolve-timezone) [02

generate_chart

API Free

Generate structured Human Design bodygraph data from birth details.

Read calculation docs](https://humandesignmcp.com/docs/tools/generate-chart) [03

generate_composite_chart

API Free

Compare two bodygraphs through a structured composite.

Read calculation docs](https://humandesignmcp.com/docs/tools/generate-composite-chart) [04

get_reference_item

API Free

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

Read calculation docs](https://humandesignmcp.com/docs/tools/get-reference-item) [05

get_transits

API Startup

Overlay transit conditions on an existing bodygraph input.

Read calculation docs](https://humandesignmcp.com/docs/tools/get-transits) [06

search_celebrities

API Business

Search the HumanDesign.ai celebrity chart catalog by name.

Read calculation docs](https://humandesignmcp.com/docs/tools/search-celebrities)

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

$0 forever

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

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

MCP Agent chooses a tool POST https://mcp.humandesign.ai/

REST Application chooses a route GET /v3/hd-data

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