Human Design MCP
Account-connected MCP

Use HumanDesign.ai from your agent.

OAuth connects the MCP to the user's HumanDesign.ai account. The server remains stateless: HumanDesign.ai continues to enforce identity, membership, workspace role, ownership, entitlements, usage, and confirmation.

Two access surfaces: OAuth is for account-connected platform tools. API keys remain supported for the original six calculation and reference tools. An API key never unlocks private account data.

Membership boundaries

Free

Your own primary chart

  • Create and save your primary chart after a one-unit preview and confirmation
  • View and render your primary chart as PNG or SVG

Not included: Composite work involving another authorized person, other people's charts, the wider library, and reports.

Individual

Your own primary chart and account usage

  • Free own-chart capabilities
  • Review account usage, calculation quota, AI-credit balance, and reservations

Not included: Composite work involving another authorized person, other people's charts, the wider library, and reports.

Personal

Your account and permitted library

  • Read other saved charts and composites you are allowed to access
  • Search and organize the library
  • Read report templates and report status
  • Review account usage

Not included: Entitled professional workspaces, and anything outside your account, ownership, or explicit entitlement.

Pro

Your account, library, and entitled workspaces

  • Personal features
  • Entitled professional workspaces
  • Website Builder tools appear only when HumanDesign.ai has enabled the Builder for your account, and only when tools/list advertises them

Not included: Anything outside your account, workspace role, ownership, or explicit entitlement.

Available account-connected tools

Account context Free, Individual, Personal, or Pro

Read-only and free. Returns the active account boundary, membership, role, primary-chart identity, entitlements, and available capabilities.

account_get_context

Usage Individual, Personal, or Pro

Read-only and free. Returns safe quota, credit, reservation, and recent-usage summaries without exposing payment details.

account_get_usage

Own chart graphics Free, Individual, Personal, or Pro

Use chart_get_primary whenever someone says my chart; it resolves the account's primary chart without a name search. If none exists, chart_generate validates a preview before one confirmed calculation unit creates it. Rendering an existing authorized chart is free and returns an inline PNG or SVG plus a short-lived download fallback. Free and Individual accounts are restricted to their primary chart.

chart_get_primary
chart_generate
chart_render

Library Personal or Pro

Reads and non-AI organization are free. Folder deletion requires preview and confirmation.

library_search
library_get
library_organize

Operations Accounts with a currently authorized operation-producing capability

Status checks are free. Each call rechecks the originating operation's capability against the current grant. Cancellation is allowed only while that capability remains granted and the underlying operation is still cancellable.

operation_get
operation_cancel

Reports Personal or Pro

The current release exposes free report discovery and status reads. Generation, export, delivery, and regeneration remain staged until wallet reservation and confirmation acceptance tests pass.

report_list_templates
report_get

Website Builder Accounts where HumanDesign.ai has enabled the Builder

Current controls cover safe reads, preview retrieval, and cancellable run cancellation. Creation, plan changes, build approval, restore, publish, and domain changes remain staged.

builder_project_list
builder_project_get
builder_plan_get
builder_run_get
builder_run_cancel
builder_preview_get
builder_asset_list

Ask for “my chart”

The agent should call chart_get_primary and use the primary chart linked to the connected account. It should not search the library for your name or guess that a chart is called “Kyle,” “My Chart,” or anything else. If no primary chart exists, chart_generate validates the birth details and returns a one-unit preview before it creates anything. To create a visual, chart_render targets the primary chart directly and returns both an MCP image and a short-lived download fallback.

Go deeper with HumanDesign.ai membership

Free is designed for a trusted first experience with your own chart. Individual adds account-usage visibility while keeping the same own-chart boundary. Personal adds broader authorized chart and saved-composite exploration, the wider library, reports you already own, and participation in the HumanDesign.ai community. Pro adds the professional workspace experience. Website Builder tools appear only when HumanDesign.ai has enabled the Builder for your account, and only when tools/list advertises them. Eligible transit experiences are available inside HumanDesign.ai; the MCP's separate get_transits calculation tool requires a Startup-or-higher API key. Membership never bypasses consent, ownership, or workspace-role checks.

What is staged

Report generation/export/delivery and Builder creation/approval/publishing are intentionally not advertised as live until credit reservation, confirmation, retry, and real-client acceptance tests are complete. High-risk publication, domain, communication, financial, collaborator, and secret-management actions will continue to use a secure HumanDesign.ai handoff.

Billing behavior

  • Connection, tool discovery, library reads, status checks, and existing-chart rendering are free.
  • New chart calculation uses the existing calculation quota.
  • AI report and Builder work uses the existing unified AI-credit wallet only when those mutations are enabled.
  • The MCP never debits credits itself; the Platform Action Gateway validates, reserves, settles, releases, and reconciles usage.

Review OAuth permissions →