HumanDesign.aiPersonalOpen app ↗
FOR YOURSELFHelp center

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. The full detail 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_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.

Back to top ↑Need a hand? Contact support ↗

Find your next answer.