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
Your own primary chart
- Generate your own chart
- View and render your own primary chart as PNG or SVG
Not included: Composite work involving another authorized person, other people's charts, the wider library, reports, and Website Builder controls.
Your account and permitted library
- Generate and explore entitled composite relationship charts
- 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: Website Builder controls unless a separate Builder entitlement is present.
Your account, library, and entitled workspaces
- Personal features
- Entitled Website Builder projects, plans, runs, previews, and assets
- All projects inside the authorized Builder boundary
Not included: Anything outside your account, workspace role, ownership, or explicit entitlement.
Available account-connected tools
Account and usage Personal or Pro
Read-only and free. Returns safe account, entitlement, quota, credit, and reservation summaries.
account_get_contextaccount_get_usageOwn chart graphics Free, Personal, or Pro
Use chart_get_primary whenever someone says my chart; it resolves the account's primary chart without a name search. Rendering an existing authorized chart is free and returns an inline PNG or SVG plus a short-lived download fallback. Free accounts are restricted to their primary chart.
chart_get_primarychart_renderLibrary Personal or Pro
Reads and non-AI organization are free. Folder deletion requires preview and confirmation.
library_searchlibrary_getlibrary_organizeOperations Personal or Pro
Status checks are free. Cancellation is allowed only while the underlying operation remains cancellable.
operation_getoperation_cancelReports 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_templatesreport_getWebsite Builder Pro or explicit Builder entitlement
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_listbuilder_project_getbuilder_plan_getbuilder_run_getbuilder_run_cancelbuilder_preview_getbuilder_asset_listAsk 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. To create a visual, chart_render can target the primary chart directly and returns both an MCP image and a short-lived download fallback.
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.