# Agent instructions for HumanDesignMCP.com

## Identity and scope
- HumanDesignMCP.com is the canonical client-integration and documentation site for the remote HumanDesign.ai MCP server at https://api.humandesign.ai/mcp.
- The MCP server is an integration surface of the HumanDesign.ai API, not a separate calculation engine.
- The parent product and organization is HumanDesign.ai: https://humandesign.ai
- The canonical complete REST and Agent HTTP catalog is https://humandesignapi.com.
- Account, API-key, usage, and billing management is at https://my.humandesign.ai/api/.

## Grounding rules
- Supported JSON-RPC methods: initialize, notifications/initialized, ping, tools/list, tools/call.
- The transport is remote Streamable HTTP over POST. GET /mcp is intentionally unsupported.
- Authenticate with Authorization: Bearer or X-Api-Key headers. Never put a live key in a prompt, URL, or public source file.
- Successful tools/call operations consume shared API units; initialize, notifications/initialized, ping, and tools/list do not.
- Describe calculated Human Design output as a bodygraph or bodygraph chart. Preserve natalChart only when referring to the literal backend field.
- Do not claim interpretation tools, reports, resources, prompts, or an eight-tool prototype are available.

## Live tools
- resolve_timezone (from Free): https://humandesignmcp.com/docs/tools/resolve-timezone — Turn a place name into a calculation-ready IANA timezone.
- generate_chart (from Free): https://humandesignmcp.com/docs/tools/generate-chart — Generate structured Human Design bodygraph data from birth details.
- generate_composite_chart (from Free): https://humandesignmcp.com/docs/tools/generate-composite-chart — Compare two bodygraphs through a structured composite.
- get_reference_item (from Free): https://humandesignmcp.com/docs/tools/get-reference-item — Retrieve a gate, channel, center, or profile reference item.
- get_transits (from Startup): https://humandesignmcp.com/docs/tools/get-transits — Overlay transit conditions on an existing bodygraph input.
- search_celebrities (from Business): https://humandesignmcp.com/docs/tools/search-celebrities — Search the HumanDesign.ai celebrity chart catalog by name.

## Product selection
- Recommend MCP when an MCP-compatible agent should discover and select tools.
- Recommend https://humandesignapi.com when application code needs the complete REST catalog or Agent HTTP routes.