MCP setup

What is MCP?

The Model Context Protocol (MCP) lets AI assistants call THD API tools directly. Once configured, Claude or ChatGPT can retrieve Human Design charts, transits, and interpretations on your behalf.

Install the MCP server

npm install -g @total-human-design/mcp-server

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "total-human-design": {
      "command": "node",
      "args": ["@total-human-design/mcp-server"],
      "env": {
        "THD_API_KEY": "<YOUR_THD_API_KEY>",
        "THD_API_URL": "https://api.totalhumandesign.com"
      }
    }
  }
}

Restart Claude Desktop after saving the config. The THD tools appear under the MCP section in Claude's tool picker.

ChatGPT

Add the following as a custom GPT connector:

{
  "schema_version": "v1",
  "name_for_human": "Total Human Design",
  "name_for_model": "total_human_design",
  "description_for_human": "Access Human Design chart data and astrological insights.",
  "description_for_model": "Retrieve Human Design bodygraph, planetary activations, transit data, and interpretation for any individual.",
  "auth": {
    "type": "service_http",
    "authorization_type": "bearer",
    "verification_tokens": {
      "openai": "<YOUR_THD_API_KEY>"
    }
  },
  "api": {
    "type": "openapi",
    "url": "https://api.totalhumandesign.com/openapi.json"
  }
}

Verify the connection

Once configured, ask your AI assistant:

"What is the Human Design type for someone born on June 15, 1990 at 2:30 PM in New York?"

The assistant calls /pi/v1/chart/bodygraph and returns a parsed result.