The Human Design MCP server — connect gethumandesign to your AI

Bring your Human Design into the AI you already use. Connect gethumandesign once, and your assistant can read your chart, look up the people you have saved, compare two charts and tell you what today's transits mean for you.

It works through MCP, the open standard for connecting apps to AI assistants, so you choose the model. What you save in the conversation lands in your gethumandesign account, ready in the app too.

Works with

Claude

Claude Code

Gemini CLI

ChatGPT

Codex

Grok

Perplexity

Mistral Vibe

Yours

Onboard your agent to gethumandesign

Or add the server yourself, by URL:

Copy

https://api.gethumandesign.com/mcp

Setup

Connect your favorite AI:

codex mcp add gethumandesign --url https://api.gethumandesign.com/mcp
codex mcp login gethumandesign

[mcp_servers.gethumandesign]
url = "https://api.gethumandesign.com/mcp"

claude mcp add --transport http --scope user gethumandesign https://api.gethumandesign.com/mcp

gemini mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

grok mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

https://api.gethumandesign.com/mcp

Features

• Chart calculation — Calculate a complete Human Design bodygraph for any birth date, time, and place. Returns type, authority, profile, defined centers, channels, and planetary activations.
• Saved people — Save family and friends to your account so you can retrieve their charts by name without re-entering birth data.
• Personal chart — Mark one person as "me" to quickly access your own design with a simple question like "what is my type?"
• Comparisons and groups — Compare two people for the channels they form together, or read a group of three to five as a Penta (Pro).
• Transits and cycles (Pro) — See what the sky is doing to your chart, or to two people at once, and when your Saturn return and the other cycles of your life fall.

Interactive cards

In Claude, ChatGPT and Grok, the chart tools answer with an interactive card as well as text. Tap a card to open the same view in your dashboard. A chart or group worked out on the fly carries a Save button, so it lands in your account without leaving the conversation. Other assistants get the same data as text.

Authentication

The server uses OAuth 2.0. When you connect for the first time, you'll be redirected to sign in with your gethumandesign.com account (email and password, Google, or GitHub). The same screen asks for your birth details, so your chart is ready on the first question.

Free plan: 15 requests per month, unlimited saved people.
Pro plan: Unlimited requests, plus Color, Tone and Base, Penta group analysis, and transits, cycles and returns.

Manage your plan and usage in settings.

Tools

The server exposes these tools:

• calculate_chart — Calculate a chart from a birth date, time, and place.
• get_my_design — Get the chart for the account holder (the "this is me" person).
• get_person_design — Get the chart for a saved person by name.
• compare_charts — Compare two charts for relationship dynamics and shared channels.
• list_people — List all saved people in your account.
• find_people — Answer one question about several saved people at once — who has gate 49, which of them are Projectors.
• save_person — Save a person's birth data for later retrieval.
• update_person — Correct a saved person: their name, their birth data, or which of them is you.
• set_birth_time — Set a saved person's birth time, and how sure you are of it.
• check_birth_time_stability — Measure how much of a chart the birth day settles, whatever the hour.
• compare_birth_times — Try candidate birth times for a saved person and report what differs, without saving.
• get_guidance — Load the reference a chart is read by: the layout of a chart answer and what every number means.
• read_skill — Load our own written guidance on a topic before answering.
• send_feedback — Send product feedback about the app to the gethumandesign team.

Pro plan accounts can also run Penta group analysis and read transits:

• analyse_group — Analyse a group's dynamics (Penta analysis) — a saved group, or 3-5 saved people ad hoc.
• save_group — Create or update a group with its members in one call.
• list_groups — List all your groups and their members.
• get_person_transits — What the sky is doing to a saved person's bodygraph, now or on a given day. Needs an exact birth time.
• get_pair_transits — What the sky is doing to two saved people at once, read against their composite: whose gates it completes and which of their shared channels it lights. Needs both exact birth times.
• get_transits — Where every planet is right now, or on a given day — the sky itself, read against nobody's chart.
• rank_transits — Who among your saved people today's sky is doing the most to, as one ranked table.
• next_transit — When the sky next does something — a planet entering a gate, an open center being activated for someone.
• get_cycles — The cycles of a saved person's life — the Saturn, Kiron, Nodal and Solar returns and the Uranus opposition — dated, each with its chart read against theirs.

Examples

Privacy

We collect only what the service needs: your email to sign in, and birth data to calculate charts. We never sell your personal data, and your birth data and chats are never shared with advertisers. Read our full Privacy Policy for the details.

Support

Questions or issues? Email us at hello@gethumandesign.com.