
Practitioner Website Template
Web App / Open Source30 minThe practitioner website you own. Free birth charts, tarot, and human design built in.
Ship a Human Design bodygraph your users can trust. This week.
BodygraphTypeConnectionProfileTransit …and so much more
Want to try without writing code? Try this domain live in API playground →
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.humanDesign.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.human_design.get(...) # async: await roxy.human_design.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->humanDesign->get(/* ... */);dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.HumanDesign.<resource>.GetAsync() or .PostAsync(new() { ... })go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.HumanDesign.<Method>(context.Background(), nil)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/human-design/claude mcp add --transport http \
roxy-human-design https://roxyapi.com/mcp/human-design \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration. Responses can come back token-optimized and lossless, cutting the tokens your agent spends per call by roughly 40 to 52 percent.
Want to ship faster? Clone a free template and go from zero to production in 30 minutes.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
{
"type": "Projector",
"typeDescription": "A focused, penetrating aura that reads and guides others. Recognition and a genuine invitation are the keys to being seen and succeeding.",
"strategy": "Wait for the invitation",
"strategyDescription": "Wait to be recognized and genuinely invited into the things that matter: relationships, career, and major commitments. Guidance offered without an invitation is not absorbed, and that wasted insight is what sours into bitterness.",
"authority": "Emotional",
"authorityDescription": "Decisions are made across an emotional wave rather than inside a moment. The defined Solar Plexus moves on its own rhythm between hope and pain, so no single moment carries the truth: clarity is what remains once the wave has run its course and settled toward neutral. The trap is committing at the peak, where enthusiasm reads as certainty, or at the trough, where gloom reads as insight, and treating any pressure to answer now as a reason to skip the wait.",
"profile": "3/5",
"profileDescription": "Martyr over Heretic. Conscious experimentation learns by collision, discovering what fails, and the unconscious fifth line turns that hard-won knowledge into practical solutions others project onto in advance. The competence is real, the expectations attached to it usually are not, so this role is trusted while it delivers and blamed the moment a projection breaks.",
"definition": "Split",
"definitionDescription": "The defined centers fall into two groups with no channel between them, so energy is consistent inside each group and does not cross the divide. The gap is bridged by the gates other people carry, which is why particular company can make thinking suddenly feel joined up, and why that company is easily mistaken for completion rather than recognized as a temporary bridge. What the configuration needs is time for the two areas to synthesize and awareness of who is bridging them, not a rushed decision taken while the halves are still speaking separately.",
"incarnationCross": {
"gates": [
62,
61,
42,
32
],
"angle": "Right Angle",
"angleCode": "RAX",
"name": "Right Angle Cross of Maya 2",
"description": "A memory for small facts and a compulsion to share them. The detail is a real contribution to work that depends on precision, and a burden to a listener who did not ask for it."
},
"aura": "Focused and absorbing. The field penetrates deeply into one other person at a time and takes in how they work, which is why the attention feels intense and why recognition arrives unevenly.",
"signature": "Success",
"notSelf": "Bitterness",
"centers": [
{
"id": "throat",
"name": "Throat",
"defined": true,
"motor": false,
"awareness": false,
"theme": "Consistent expression and the ability to manifest through speech and action when connected to a motor.",
"notSelfQuestion": "Is all this talking and doing an attempt to attract attention? The open Throat fills the silence and stays busy to be noticed, rather than waiting to be recognized and asked.",
"biology": "The thyroid and parathyroid glands. Thyroid hormones set the metabolic rate and the parathyroids regulate calcium, and in the bodygraph this pair governs the timing of speech and action.",
"gates": [
12,
31,
62
]
}
],
"channels": [
{
"gateA": 7,
"gateB": 31,
"name": "The Alpha",
"circuit": "Collective",
"centers": [
"g",
"throat"
],
"description": "Direction held in the G Center reaches the Throat as the voice of leadership. The authority is granted rather than taken, so the guidance only works once the group has chosen to be led.",
"circuitDescription": "Sharing for the species, carried by 14 channels. Pattern and experience are worked into something transmissible: the logical half tests patterns and projects them forward, the abstract half harvests wisdom from experience already lived."
}
],
"gates": [
{
"planet": "Sun",
"side": "personality",
"gate": 62,
"line": 3,
"gateName": "Detail",
"gateDescription": "The throat gate that names things. It sorts facts, labels, and details into practical language, giving the opinions of gate 17 something concrete to stand on.",
"lineMeaning": "Facts stated, corrected, and stated again. Every detail that turned out wrong sharpens the next one, and boredom with the small thing is what causes the miss.",
"planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
"ichingHexagram": {
"number": 62,
"english": "Preponderance of the Small"
}
}
]
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Render Human Design API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Human Design API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
HD type card widget snippet
HD connection widget snippet
HD penta widget snippet
HD variables widget snippet
Reference card widget snippet
The complete UI libraryExplore Roxy UI| Element | Renders |
|---|---|
| <roxy-bodygraph> | Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaning |
| <roxy-hd-type-card> | Type, strategy, authority, and profile tiles with the aura, signature, and not-self themes, plus the reading behind each label and the profile line keynotes |
| <roxy-hd-connection> | Electromagnetic, compromise, and dominance channels between two charts |
| <roxy-hd-penta> | Group penta channels split into upper and lower triangles |
| <roxy-hd-variables> | The four transformation arrows with direction, color, tone, and base, plus a reading per arrow grouped by layer and the cognition |
| <roxy-reference-card> | Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup |
Works with your stack
Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, defined channels, and all 26 gate activations, plus two-person connection charts and small-group Penta analysis. Planetary positions verified against NASA JPL Horizons, the Design side solved on the exact 88 degree solar arc. One key, Remote MCP, typed SDKs.
Every Human Design calculation is covered by 6,991 automated tests per deploy, 1,527 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.
Multi-language API responses
Everything you need from our Human Design API, built for production:
Full bodygraph in one call: energy type, strategy, inner authority, signature, not-self theme, profile, definition, and incarnation cross from a single birth date, time, and timezone
All five energy types derived from the graph: Manifestor, Generator, Manifesting Generator, Projector, and Reflector, with strategy and signature for each
Seven inner authorities resolved in strict priority: Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, and Lunar
The 26 gate activations split into 13 conscious Personality and 13 unconscious Design, each enriched with its gate keynote and matching I-Ching hexagram
The nine centers reported as defined or open with motor and awareness flags, theme text, and the active gates that sit in each
The 36 channels with circuit family, returning only the defined channels that wire the bodygraph together
Profile from the two Sun lines with line keynotes, plus definition computed from connected components among defined centers
True (osculating) lunar node by default, matching professional Human Design software, computed EXACTLY from the Moon instantaneous orbital plane rather than from a truncated perturbation series, which is what keeps a node inside the correct gate on a boundary chart where the two approaches disagree by more than half a line. An optional nodeType parameter switches to the mean node when matching another calculator
Static gate and center lookups for reference UIs, with the Design moment solved on the 88 degree solar arc rather than approximated as 88 calendar days
Transit overlay that maps the current planetary positions onto a natal bodygraph and reports the channels the transit temporarily completes, split into personal and educational, with the centers they define
Small-group Penta (BG5) analysis for three to five people: the six Penta channels as defined Strengths or gaps, the twelve Penta gates with who fills each, the upper leadership and lower generative roles, and the 2/14 material core
Every one is live in the public OpenAPI spec and callable as an MCP tool. Click any endpoint to view detailed documentation, parameters, and response examples.
Clone. Edit. Ship. Free and open source by Team Roxy.

The practitioner website you own. Free birth charts, tarot, and human design built in.

Talk to the stars. Real readings across every domain, spoken aloud.
Browse all templates or use AI prompts to generate a custom app.
Real-world applications and use cases for integrating Human Design API into your projects:
Spiritual and self-discovery apps: full bodygraph generation, type and authority readings, and profile insights for personal growth journeys
Dating and relationship platforms: type, authority, and profile compatibility context derived from two birth charts
AI chatbots and coaching assistants: bodygraph data via remote MCP tool calls for Human Design conversations and decision-making guidance
Practitioner and reading tools: activation columns, defined channels, and center analysis for professional Human Design charts
Wellness and mindfulness platforms: strategy and authority prompts that help users make aligned decisions
Content and editorial platforms: gate and center reference lookups for explainer pages and structured Human Design libraries
Dhani M.
Indie App Developer
Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.
Tom H.
Senior Developer
The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.
Chris W.
Backend Engineer
Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.
The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.
Opens a live web search in a new tab.
From zero to production in 3 steps. No signup required for testing.
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12+ domains under one key.
Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.
Audit it yourself: every Human Design endpoint runs live in the API playground
Send a birth date, time, and timezone to the Human Design API and get the full bodygraph back in one response: energy type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, the defined channels, and every gate activation. No location lookup, no setup. Drop in the typed SDKs for TypeScript, Python, or PHP, or point a client at our Remote MCP server, and you ship a chart your users can trust this week. One API key also unlocks the other eleven spiritual domains on the same flat plan.
Every chart is built from precise planetary positions computed by Roxy Ephemeris and verified against NASA JPL Horizons, so type, authority, profile, and each gate activation reflect the real sky at the birth moment. The design side is solved on the exact 88 degree solar arc rather than approximated as 88 calendar days, which is where lesser tools drift on knife-edge charts. Birth time matters: a few minutes can change a gate, and we honor that precision instead of rounding it away. Nodes use the true (osculating) node that professional Human Design software uses, and it is computed exactly from the Moon instantaneous orbital plane rather than approximated by a perturbation series, so a node close to a gate boundary lands on the correct side of it; if you are matching a mean-node calculator, pass nodeType set to mean.
Both come straight from the geometry of the chart, not from a guess. Type is read from which centers are defined and how they wire to the throat, returning Manifestor, Generator, Manifesting Generator, Projector, or Reflector with the matching strategy and signature. Inner authority is resolved by strict priority so the first defined source wins, covering Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, and Lunar. Activation happens the moment you check out, so you can call it the same minute you sign up.
Yes. Send two birth moments and the Human Design API returns a connection chart that classifies every channel by its relationship dynamic, from electromagnetic attraction to dominance, compromise, and companionship, plus the centers each person defines for the other. This is the engine behind dating, relationship, and coaching features that go deeper than a sun-sign match. For teams and families, group analysis covers three to five people in a single call, and the same logic is available through our Remote MCP server with no local setup or Docker.
Ask the Human Design API for the profile and you get the full pairing, such as 5/1 or 6/2, with the conscious and unconscious lines and a keynote for each. The profile is derived from the real solar geometry at birth and the precise design point, so it holds up even on charts that sit close to a line boundary. The same profile arrives inside the full bodygraph response when you want it alongside the rest of the chart, so you never make two calls for one screen.
Yes. The Human Design API can overlay todays planetary positions onto any natal bodygraph and report the channels the transit temporarily completes, which powers daily guidance and re-engagement features that keep users coming back. For reference pages and long-tail content, you can pull a single gate or a single center with its meaning, no birth data required, and pair it with our drop-in UI components or render it yourself. The full catalog is also published in our llms.txt and AGENTS.md so coding agents can wire it up unattended.
Ship a Human Design bodygraph your users can trust. This week.
All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.
View Pricing & Get API KeyHi, I'm Rosie, your guide to RoxyAPI's insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I'll interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.