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.
resolve_timezone. Minimum API tier: Creator. What it does: Find location matches with IANA timezones and geographic metadata.generate_chart. Minimum API tier: Creator. What it does: Generate a natal Human Design chart. Thefulldetail level requires Startup.generate_composite_chart. Minimum API tier: Creator. What it does: Generate a compatibility chart for two people.get_reference_item. Minimum API tier: Creator. What it does: Retrieve a gate, channel, center, or profile reference item.get_transits. Minimum API tier: Startup. What it does: Return a dated forecast or natal-versus-transit chart.search_celebrities. Minimum API tier: Business. What it does: Search the public-figure catalog by name.
Input summaries
resolve_timezonerequiresquery.generate_chartrequiresbirthDateTimeand an IANAtimezone;detailLeveliscoreor, when available,full.generate_composite_chartrequirespersonAandpersonB, each withbirthDateTimeandtimezone.get_reference_itemrequireskind(gate,channel,center, orprofile) andid.get_transitsaccepts optionaldate,timezone, andnatalChart.search_celebritiesrequiresqueryand acceptslimitfrom 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.