Content
# Human Design for Claude, Cursor & Cline
[](https://www.npmjs.com/package/@simplechart/mcp)
[](./LICENSE)
[](https://simplechartcalculator.com/mcp)
Compute Human Design charts, cycle returns, transits, synthesis, and chart
comparison **natively inside your AI assistant** — powered by
[Simple Chart Calculator](https://simplechartcalculator.com/mcp). 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:
```json
{
"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
