HumanDesign.ai Logo
Get Started

MCP Tools Reference

APIUpdated Mar 12, 20261 min read

Available MCP Tools

Tool Minimum Tier Purpose
resolve_timezone Creator Search locations and return matching IANA timezones.
generate_chart Creator Generate a natal chart. detailLevel=full requires Startup.
generate_composite_chart Creator Generate a two-person compatibility chart.
get_reference_item Creator Load a gate, channel, center, or profile reference record.
get_transits Startup Return a daily forecast or natal-versus-transit chart.
search_celebrities Business Search the celebrity database by name.

resolve_timezone

Arguments: { query }

Returns ranked location matches including timezone and geo metadata.

generate_chart

Arguments: { birthDateTime, timezone, detailLevel? }

  • detailLevel=core maps to Creator-tier chart generation.
  • detailLevel=full maps to Startup-tier chart generation.

generate_composite_chart

Arguments: { personA, personB } where each person is { birthDateTime, timezone }.

get_reference_item

Arguments: { kind, id }

  • kind must be one of gate, channel, center, or profile.
  • id can be values such as 48, 48-16, Sacral, or 1/3.

get_transits

Arguments: { date?, timezone?, natalChart? }

  • Without natalChart, the tool returns a one-day planetary forecast.
  • With natalChart, the tool returns a natal-versus-transit chart.

search_celebrities

Arguments: { query, limit? }

Business and Enterprise plans can search the celebrity dataset and return ranked matches.