MCP Server
Requires SAGE API Plan
MCP Server access is included with the SAGE API subscription — a separate plan from Advanced Chart. An Advanced Chart key cannot connect to the MCP endpoint. See billing for details.
The Model Context Protocol (MCP) is an open standard that lets AI assistants — Claude, GPT, custom agents — discover and call external tools in a structured way. Instead of crafting HTTP requests, the AI client negotiates capabilities with the server and invokes tools by name.
THD exposes a single MCP endpoint that gives AI agents access to Human Design chart generation, composite analysis, transits, and planetary returns — plus read-only reference resources for terminology and field definitions.
Endpoint
POST https://api.totalhumandesign.com/mcpTransport: Streamable HTTP (the MCP standard HTTP transport). Your MCP client handles the protocol automatically.
Authentication
Use the same API key you use for the REST API:
Authorization: Bearer thd_YOUR_API_KEYGenerate or manage keys from your dashboard.
Available capabilities
Tools (4)
| Tool | Description |
|---|---|
generate_chart | Generate a full V2 Human Design chart from birth data |
generate_composite | Generate a composite chart for two people |
get_transits | Get planetary transit data for a date range |
get_planetary_return | Calculate a planetary return chart |
Resources (2)
| URI | Description |
|---|---|
thd://reference/terminology | Human Design terminology — types, strategies, authorities, centers, channels, gates |
thd://reference/chart-fields | V2 chart response field definitions, data types, and nested object structure |
MCP vs REST
| Use case | Choose |
|---|---|
| AI agent integration (Claude Desktop, Cursor, custom LLM pipelines) | MCP |
| Traditional app, mobile client, server-to-server | REST API |
| SAGE knowledge queries | REST API (SAGE is REST-only) |
MCP tools return the same chart data as the REST endpoints. The protocol layer is different — JSON-RPC over Streamable HTTP instead of plain REST — but the underlying data is identical.
Data only
MCP tools return raw chart data, not AI-generated interpretations. If you need natural-language explanations from the knowledge base, use the SAGE API via REST.
Next steps
- Quickstart — Connect your MCP client in 5 minutes
- Tools Reference — Input schemas and JSON-RPC examples for all 4 tools
- Resources Reference — Read-only reference data available to your agent