Human Design

npm version license: MIT Human Design MCP

Compute Human Design charts, cycle returns, transits, synthesis, and chart comparison natively inside your AI assistant — powered by Simple Chart Calculator. Sub-second precision, built on Swiss Ephemeris. 9 tools.

---

⚡ Fastest: remote connector — no install at all

Works in Claude on the web, desktop and Cowork (and any MCP client that supports remote servers). In Claude: Settings → Connectors → Add custom connector, then paste your personal URL:

https://api.simplechartcalculator.com/mcp/YOUR_API_KEY

Get a free key (and your ready-made personal URL) at https://simplechartcalculator.com/portal. The URL contains your key — treat it like a password. The remote connector exposes the 5 calculation tools; the local install below adds a private on-device people roster.

---

✅ Local install — one click (Claude Desktop)

No config files, no terminal.

1. Download Human-Design-SimpleChartCalculator.mcpb.
2. Double-click it (or open Claude Desktop → Settings → Extensions → Install… and pick the file).
3. When asked, paste your API key in the box. No key yet? Get a free one at https://simplechartcalculator.com/register (30 seconds, no card). Keep the key private — it counts against your plan.
4. Done. Just chat (see Example prompts below).

---

Other clients (Cursor, Cline) — config file

If you're not on Claude Desktop, add the server to your MCP config manually:

{
  "mcpServers": {
    "human-design": {
      "command": "npx",
      "args": ["-y", "@simplechart/mcp"],
      "env": { "SCC_API_KEY": "YOUR_KEY" }
    }
  }
}

• Cursor: ~/.cursor/mcp.json (or Settings → MCP → Add Server)
• Cline: MCP Servers → Configure

The npx @simplechart/mcp command needs the package published to npm. The one-click .mcpb above is fully self-contained and works without npm.

Tools (9)

Tool	What it does
calculate_chart	Full bodygraph from birth data — type, authority, profile, centers, channels, all 14 planets as gate.line.color.tone.base.
get_synthesis	The interpretive layer — strategy, signature, not-self, incarnation cross, variables.
calculate_cycle	Exact Solar / Saturn / Uranus-opposition / Chiron return moment (sub-second) + the chart for it.
get_transit	The live global transit chart right now.
compare_charts	Connection dynamics between two people — electromagnetic, dominance, compromise & companionship channels.
save_person	Save birth data locally on your machine (~/.simplechart-mcp/people.json) to recall or compare by name.
get_person	Recall a saved person's full chart by name.
list_people	List everyone in your local roster.
remove_person	Delete someone from your roster.

Your saved people live in a local JSON file on your own machine — nothing is stored on our servers.

Example prompts

Once installed, just ask your assistant in plain language:

"Calculate the Human Design chart for Ra Uru Hu, born 9 April 1948 at 00:05 in Montreal."

"When was Ra Uru Hu's first Saturn return? Born 9 April 1948, 00:05, Montreal."

"Save my mum's birth data, then compare her chart with mine."

"What's the current Human Design transit?"

Environment variables

Var	Required	Default
SCC_API_KEY	yes	—
SCC_API_BASE	no	https://api.simplechartcalculator.com

The free tier includes 300 calls/month (6 via MCP). Pro ($33/mo) includes 25,000 calls, full synthesis data and 600 MCP calls.

License

MIT © Simple Chart Calculator