MCP Quickstart

Connect your AI agent to the THD MCP server in 5 minutes.

1. Get an API key

Create an account and generate an API key from your dashboard. Your key will look like thd_abc123....

2. Configure your MCP client

Claude Desktop

{
"mcpServers": {
  "thd": {
    "url": "https://api.totalhumandesign.com/mcp",
    "headers": {
      "Authorization": "Bearer thd_YOUR_KEY"
    }
  }
}
}

Add this to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\\Claude\\claude_desktop_config.json

Cursor

{
"mcpServers": {
  "thd": {
    "url": "https://api.totalhumandesign.com/mcp",
    "headers": {
      "Authorization": "Bearer thd_YOUR_KEY"
    }
  }
}
}

Place this in .cursor/mcp.json at the root of your project or in your global Cursor config.

TypeScript SDK

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
new URL("https://api.totalhumandesign.com/mcp"),
{
  requestInit: {
    headers: {
      Authorization: "Bearer thd_YOUR_KEY",
    },
  },
}
);

const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(transport);

// List available tools
const { tools } = await client.listTools();
console.log(tools.map(t => t.name));

// Call a tool
const result = await client.callTool({
name: "generate_chart",
arguments: {
  birthDate: "1990-05-15",
  birthTime: "14:30",
  birthLocation: "New York, NY",
},
});
console.log(result);

3. Test with generate_chart

Once your client is connected, try generating a chart. In Claude Desktop or Cursor, just ask:

"Generate a Human Design chart for someone born May 15, 1990 at 2:30 PM in New York"

The agent will call generate_chart automatically and return the chart data.

If you are using the SDK, the code above already includes a callTool example. The response will contain chart data as a JSON string inside result.content[0].text.

4. Practical workflow

Combine tools and resources for richer results. Ask your agent:

"Generate a Human Design chart for May 15, 1990 at 14:30 in New York, then explain the results using Human Design terminology"

Behind the scenes, the agent will:

1. Call generate_chart to get the raw chart data
2. Read thd://reference/terminology for Human Design definitions
3. Synthesize a clear explanation using both

Next steps

• Tools Reference — Full input schemas and response examples for all 4 tools
• Resources Reference — Reference data available to your agent
• MCP Overview — Architecture and when to use MCP vs REST