generate_chart
Return core bodygraph properties in a stable, agent-friendly response. Startup and above can request the expanded full detail level.
Developer outcome: Give an AI product reliable bodygraph inputs without teaching the model chart-calculation rules.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
birthDateTime | string (local wall time) | Yes | Birth date and time as it read on the clock where the person was born, with no Z and no UTC offset. The timezone field supplies the zone. |
timezone | string | Yes | IANA timezone such as America/New_York. |
detailLevel | "core" | "full" | No | Core is available on Free; full requires Startup or above. |
idempotencyKey | string | Yes | Stable key for this intended calculation. Reuse it only with identical arguments when retrying. |
Birth times are local wall clock times. Send the birth date and time as it read on the clock where the person was born, with no Z and no UTC offset, and give the timezone separately as an IANA identifier. "birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.
Deprecated: Values ending in Z or a numeric offset are deprecated. The MCP forwards them and the API still accepts them for now, reading them as UTC, and the deprecation is announced on the API response. They will stop being accepted, and the date will be announced in advance. Read the full rule.
Request
Sanitized JSON-RPC
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}Success response shape
- Type, strategy, authority, profile, and definition
- Centers, channels, gates, and activations
- Quota metadata alongside the tool result
The response also includes tier and quota metadata supplied by the API entitlement layer. Exact domain fields vary by tool and requested detail level.
Errors
- Birth time that is not a local wall clock time
- Wall time skipped or repeated by a daylight-saving change
- Birth time in the future
- Unknown timezone
- Full detail requires Startup
- Quota exceeded
Quota behavior
After input validation, authorization, and tier checks pass, an execution attempt that reaches the calculation provider consumes exactly one shared API unit—even if a later presentation step fails. Malformed or ambiguous input, denied tiers, unknown references, and other pre-provider failures consume zero. Check current usage at my.humandesign.ai.