HumanDesign.ai MCP tools reference

How tool access works

Call tools/list after authenticating. The server returns only the tools your API key can use, including the allowed input options for that key. Do not hard-code an assumed tool list.

Tool	Minimum API tier	What it does
`resolve_timezone`	Creator	Find location matches with IANA timezones and geographic metadata.
`generate_chart`	Creator	Generate a natal Human Design chart. The `full` detail level requires Startup.
`generate_composite_chart`	Creator	Generate a compatibility chart for two people.
`get_reference_item`	Creator	Retrieve a gate, channel, center, or profile reference item.
`get_transits`	Startup	Return a dated forecast or natal-versus-transit chart.
`search_celebrities`	Business	Search the public-figure catalog by name.

Input summaries

resolve_timezone requires query.
generate_chart requires birthDateTime and an IANA timezone; detailLevel is core or, when available, full.
generate_composite_chart requires personA and personB, each with birthDateTime and timezone.
get_reference_item requires kind (gate, channel, center, or profile) and id.
get_transits accepts optional date, timezone, and natalChart.
search_celebrities requires query and accepts limit from 1 to 100.

Errors and billing

Malformed MCP requests and unknown tool names are protocol errors. Known tools return an error result when input, entitlement, quota, or an upstream provider prevents the request from completing. Read the error code and quota metadata in the response instead of retrying unchanged input.

A successful tool execution consumes one shared API unit. Discovery, invalid arguments, unknown tools, and insufficient-tier requests do not consume a unit.

How tool access works

Input summaries

Errors and billing

More in API