Full Human Design bodygraph from a birth moment: energy type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, defined channels, and all 26 gate activations. One key covers 12+ spiritual domains. MCP-first, verified against NASA JPL Horizons.
A Human Design bodygraph is the full chart of a person: planetary positions at the birth moment (the conscious Personality side) and 88 degrees of solar arc before birth (the unconscious Design side), mapped onto 64 gates, 36 channels, and nine centers. This repo ships working TypeScript, JavaScript, and Python samples against the RoxyAPI Human Design bodygraph endpoint. One POST returns the energy type, strategy, inner authority, signature, not-self theme, profile, definition, incarnation cross, all nine centers with defined state and active gates, the defined channels, and all 26 planetary activations. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools. One subscription unlocks 12+ spiritual domains: Western astrology, Vedic astrology, numerology, tarot, Human Design, Forecast, biorhythm, I Ching, crystals, dreams, angel numbers, and location. Every planetary position is computed by Roxy Ephemeris, verified against NASA JPL Horizons, and the Design side is solved on the exact 88 degree solar arc rather than approximated as 88 calendar days.
| Property | Value |
|---|---|
| Coverage | 12+ spiritual domains in one subscription |
| Calculation | Roxy Ephemeris, verified against NASA JPL Horizons |
| MCP server | https://roxyapi.com/mcp/human-design (Streamable HTTP, no local setup) |
| SDKs | TypeScript on npm @roxyapi/sdk, Python on PyPI roxy-sdk, PHP on Packagist roxyapi/sdk, C# on NuGet RoxyApi.Sdk, Go github.com/RoxyAPI/sdk-go, WordPress plugin roxyapi |
| Pricing | One key, flat per call, from $39/mo |
| Licensing | Personal and commercial use, including closed source apps. No AGPL or GPL entanglement. Full terms |
| Last verified | 2026-Q3 |
- Get a key at roxyapi.com/pricing
- Pick a language below
- Copy the snippet, run, ship
No location lookup, no setup: the bodygraph depends only on the birth date, time, and timezone. Latitude and longitude are optional and do not affect the chart.
curl -X POST https://roxyapi.com/api/v2/human-design/bodygraph \
-H "X-API-Key: $ROXY_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "date": "1990-07-15", "time": "13:00:00", "timezone": "America/New_York" }'importosfromroxy_sdkimportcreate_roxyroxy=create_roxy(os.environ["ROXY_API_KEY"])
# Full bodygraph in one call. No coordinates needed.result=roxy.human_design.generate_bodygraph(
date="1990-07-15",
time="13:00:00",
timezone="America/New_York",
)
print("Type:", result["type"], "|", result["strategy"])
print("Authority:", result["authority"])
print("Profile:", result["profile"], "| Definition:", result["definition"])
print("Incarnation cross:", result["incarnationCross"]["name"])
forchannelinresult["channels"]:
print("Channel", channel["gateA"], "-", channel["gateB"], channel["name"], f"({channel['circuit']})")import{createRoxy}from'@roxyapi/sdk';constroxy=createRoxy(process.env.ROXY_API_KEY);// Full bodygraph in one call. No coordinates needed.const{ data, error }=awaitroxy.humanDesign.generateBodygraph({body: {date: '1990-07-15',time: '13:00:00',timezone: 'America/New_York',},});if(error)thrownewError(error.error);console.log('Type:',data.type,'|',data.strategy);console.log('Authority:',data.authority);console.log('Profile:',data.profile,'| Definition:',data.definition);console.log('Incarnation cross:',data.incarnationCross.name);data.channels.forEach(ch=>console.log(`Channel ${ch.gateA}-${ch.gateB}${ch.name} (${ch.circuit})`));import{createRoxy}from'@roxyapi/sdk';constroxy=createRoxy(process.env.ROXY_API_KEY!);// Full bodygraph: type, authority, profile, centers, channels, gates in one callconst{ data, error }=awaitroxy.humanDesign.generateBodygraph({body: {date: '1990-07-15',time: '13:00:00',timezone: 'America/New_York',},});if(error)thrownewError(error.error);console.log('Type:',data.type,'|',data.strategy);console.log('Authority:',data.authority);console.log('Signature:',data.signature,'| Not-self:',data.notSelf);console.log('Profile:',data.profile,'| Definition:',data.definition);console.log('Incarnation cross:',data.incarnationCross.name);constdefined=data.centers.filter(c=>c.defined).map(c=>c.name);console.log('Defined centers:',defined.join(', '));data.channels.forEach(ch=>console.log(`Channel ${ch.gateA}-${ch.gateB}${ch.name} (${ch.circuit})`));constpersonality=data.gates.filter(g=>g.side==='personality');personality.forEach(g=>console.log(`${g.planet}: gate ${g.gate}.${g.line}${g.gateName}`));| Field | Type | Required | Description |
|---|---|---|---|
date | string | yes | Birth date in YYYY-MM-DD format. The anchor for both the Personality activations at birth and the Design activations 88 degrees of solar arc earlier |
time | string | yes | Birth time in 24-hour HH:MM:SS format. Precision matters: the profile lines and gate boundaries shift with the exact minute of birth |
timezone | number or string | yes | Decimal hours from UTC (e.g. -5 for EST, 5.5 for IST) OR IANA name (e.g. "America/New_York", "Asia/Kolkata"). IANA strings resolve to the DST-correct offset for the birth date |
latitude | number | no | Birth latitude in decimal degrees. Optional and does not affect the bodygraph, which depends only on ecliptic longitudes. Defaults to 0 |
longitude | number | no | Birth longitude in decimal degrees. Optional and does not affect the bodygraph. Defaults to 0 |
{
"type": "Projector",
"strategy": "Wait for the invitation",
"authority": "Emotional",
"signature": "Success",
"notSelf": "Bitterness",
"profile": "3/5",
"definition": "Split",
"incarnationCross": {
"gates": [62, 61, 42, 32],
"angle": "Right Angle",
"angleCode": "RAX",
"name": "Right Angle Cross of Maya 2"
},
"centers": [
{
"id": "solar-plexus",
"name": "Solar Plexus",
"defined": true,
"motor": true,
"awareness": true,
"theme": "An emotional wave that moves through highs and lows over time. Clarity arrives through the wave, never in the moment.",
"gates": [30, 37]
}
],
"channels": [
{
"gateA": 7,
"gateB": 31,
"name": "The Alpha",
"circuit": "Collective",
"centers": ["g", "throat"]
}
],
"gates": [
{
"planet": "Sun",
"side": "personality",
"gate": 62,
"line": 3,
"gateName": "Detail",
"ichingHexagram": { "number": 62, "english": "Preponderance of the Small" }
}
]
}| Field | Type | Description |
|---|---|---|
type | string | Human Design energy type. One of Manifestor, Generator, Manifesting Generator, Projector, Reflector |
strategy | string | The aura strategy for engaging life correctly for this type |
authority | string | Inner authority for decision making. One of Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, Lunar |
signature | string | The signature feeling of living in alignment with the type |
notSelf | string | The not-self theme, the recurring feeling that signals being out of alignment |
profile | string | Profile in conscious/unconscious form from the Personality Sun line over the Design Sun line |
definition | string | Definition type from the number of connected components among defined centers. One of None, Single, Split, Triple Split, Quadruple Split |
incarnationCross | object | The incarnation cross built from the four cardinal gates and the profile angle |
incarnationCross.gates | array | The four cardinal gates of the cross: Personality Sun, Personality Earth, Design Sun, Design Earth |
incarnationCross.angle | string | Cross angle. One of Right Angle, Juxtaposition, Left Angle |
centers | array | All nine centers with their defined state and active gates. Each has id, name, defined, motor, awareness, theme, gates |
centers[].defined | boolean | Whether the center is defined. A defined center is a consistent source of energy or awareness; an undefined center is open and conditioned by others |
centers[].motor | boolean | Whether this is a motor center (energy source). The four motors are Heart, Sacral, Solar Plexus, and Root |
centers[].awareness | boolean | Whether this is an awareness center. The three awareness centers are Ajna, Solar Plexus, and Spleen |
channels | array | The defined channels where both gates are activated. Each has gateA, gateB, name, circuit (Individual, Collective, Tribal), and the two centers it connects |
gates | array | All 26 activations, 13 Personality and 13 Design. Each has planet, side, gate (1-64), line (1-6), gateName, and the matching ichingHexagram |
gates[].side | string | Chart side. personality is the conscious birth-moment activation, design is the unconscious activation 88 degrees of solar arc before birth |
gates[].ichingHexagram | object | Cross-reference to the I-Ching hexagram that shares this gate number, with number and english name |
| Use case | Endpoint flow |
|---|---|
| Human Design chart in a self-discovery app | POST to /human-design/bodygraph, render centers[] and channels[] as the bodygraph, headline type and strategy |
| Type and authority quiz feature | POST /human-design/type for the fast subset, or read type and authority from the full bodygraph |
| Dating or relationship compatibility product | POST /human-design/connection with two birth moments for channel dynamics between two charts |
| AI coaching assistant with decision guidance | Call the post_human_design_bodygraph MCP tool, then guide from authority and strategy |
| Daily guidance and re-engagement features | POST /human-design/transit to overlay current planetary activations on a natal bodygraph |
| Gate and center reference pages | GET /human-design/gates/{number} and /human-design/centers/{id}, no birth data required |
POST /human-design/type(calculateType) - the fast lookup for type, strategy, authority, signature, not-self theme, and profile without the full bodygraph payloadPOST /human-design/connection(calculateConnection) - two-person connection chart with every channel classified as electromagnetic, dominance, compromise, or companionshipPOST /human-design/profile(calculateProfile) - the profile with the conscious and unconscious Sun lines and a keynote for each, for example 5/1 the Heretic Investigator
Connect Claude, GPT, Gemini, or Cursor to RoxyAPI through the remote MCP server. No Docker. No self hosting. The full MCP tool catalog for this domain is at https://roxyapi.com/mcp/human-design.
{
"mcpServers": {
"human-design": {
"url": "https://roxyapi.com/mcp/human-design",
"headers": { "X-API-Key": "$ROXY_API_KEY" }
}
}
}See docs/mcp for Claude Desktop, Cursor, Windsurf, VS Code, and Claude Code setup.
This repo ships an AGENTS.md execution playbook. Cursor, Claude Code, Aider, Codex, Windsurf, RooCode, and Gemini CLI will pick it up automatically. Top level overview lives at roxyapi.com/AGENTS.md.
- Methodology and gold standard tests verified against NASA JPL Horizons
- Full API reference interactive Scalar UI
- TypeScript SDK on npm
- Python SDK on PyPI
- PHP SDK on Packagist
- C# SDK on NuGet
- Go SDK on pkg.go.dev
- WordPress plugin
- llms.txt full LLM citation index
- Top level AGENTS.md
MIT for this sample repo. See LICENSE.
Catalog licensing: Personal and commercial use, including closed source proprietary apps. No AGPL or GPL entanglement. RoxyAPI APIs and SDKs are safe to embed in commercial products. Full terms at roxyapi.com/policy/license.
- Site: roxyapi.com
- Status: roxyapi.com/api-reference