# llms.txt — HD Matrix Pro
# https://hdmatrix.pro
# Last updated: 2026-06-18

> HD Matrix Pro is a free online Human Design chart calculator and analysis platform. It generates bodygraphs, transit forecasts, composite charts, compatibility readings, I Ching oracles, Gene Keys profiles, and HD Dating matching. The site covers 31 languages, hosts 11,200+ celebrity charts, 6,500+ in-depth blog articles in 31 languages (organized into 21 topic rubrics at /blog/topic/<topic>), including all 64 gates x 6 lines (gate-lines), 192 incarnation crosses plus granular per-gate cross variants, the 64 Gene Keys, planets-in-signs, Tarot/Chinese-zodiac/Ayurveda cross-system guides, celebrity chart analyses, and a full guided book-style reference (foundations, read-your-chart walkthrough, glossary), a step-by-step guided Course at /course, and detailed reference pages for all 64 gates, 36 channels, 9 centers, 7 authorities, 12 profiles, and 134 incarnation crosses (each with a classical and a Quantum Human Design reading).

## Public API v1 (FREE tier — no API key required)

OpenAPI schema: `https://hdmatrix.pro/openapi.json`
Plugin manifest (discovery): `https://hdmatrix.pro/.well-known/ai-plugin.json`
**For AI assistants / custom GPTs / agents:** import `https://hdmatrix.pro/openapi.json` as a tool / Action to call these endpoints directly. No authentication. operationIds: `calculateChart`, `getInterpretation`, `listInterpretations`, `getTransits`.

**MCP server (Model Context Protocol):** connect via Streamable-HTTP at `https://hdmatrix.pro/mcp` (protocol version `2025-06-18`; JSON-RPC 2.0; discovery: `https://hdmatrix.pro/.well-known/mcp.json`). Tools: `calculate_chart`, `geocode_place`, `get_interpretation`, `list_interpretation_keys`, `get_transits`. Works with Claude Desktop, Cursor, Windsurf, Cline, Continue. No auth. Human-readable docs: `https://hdmatrix.pro/for-developers`.

**Geocoding helper:** GET/POST `https://hdmatrix.pro/api/v1/geocode?q=<city>` -> `{name, lat, lon}` (resolve a birth city to coordinates before /calculate).

### Calculate HD Chart
POST `https://hdmatrix.pro/api/v1/calculate`
Rate limit: 20/hour per IP
Body: `{ year, month, day, hour, minute, place, latitude, longitude, gender? }`
Returns: type, strategy, authority, profile, definition, cross, signature, not-self, defined/undefined centers, active channels, personality/design gates (each gate includes its `planet`, e.g. "Sun", "Earth", "North Node").
Invalid birth data (e.g. month 13, Feb 30, hour 25) returns HTTP 400 with `{ error, details[] }` — not a 500/502.

### Discover Interpretation Keys
GET `https://hdmatrix.pro/api/v1/interpret/list` → every type with a count + sample keys.
GET `https://hdmatrix.pro/api/v1/interpret/list?type=cross&locale=en` → all valid keys for that type (capped 400).
Use this to enumerate valid keys before calling /interpret, instead of guessing.

### Get Interpretation
POST `https://hdmatrix.pro/api/v1/interpret`
Rate limit: 30/hour per IP
Body: `{ type, key, locale? }` (locale: uk, ru, en, fr — others fall back to en)
Valid types: type, type_extended, authority, profile, profile_line, cross, cross_quantum, cross_variant, cross_type, gate, gate_line, channel, center_defined, center_undefined, planet, gene_key, dream_gate, bg5_role, bg5_penta, transit_gate, phs_diet, phs_env, phs_motivation, phs_view, cognition, notself, signature, strategy
Key formats (the API canonicalizes common variants):
- gate: `"1"`, `"13"` (numeric) — also accepts `"gate_1"`
- channel: `"3-60"`, `"60-3"`, `"3/60"`, `"60/3"` (order- and separator-agnostic)
- authority: `"Sacral"`, `"Sacral Authority"`, `"sacral"` (case-insensitive)
- center_undefined / center_defined: `"Sacral"` or short codes (`"SA"`, `"SP"`, `"RO"`, `"HE"`, `"TH"`, `"AJ"`...)
- gene_key: `"gene_key_1"` … `"gene_key_64"`
- cross / cross_quantum: localized name — use /interpret/list?type=cross to find exact keys
Returns: name, shortDescription, fullDescription

### Get Current Transits
POST `https://hdmatrix.pro/api/v1/transits`
Rate limit: 15/hour per IP
Body: `{ year, month, day, hour, minute, place, latitude, longitude }`
Returns: sun gate/line, moon gate/line, active transit gates for today

## Core Tools
- Main calculator: https://hdmatrix.pro/en
- Transit forecast: https://hdmatrix.pro/en/forecast
- Composite charts: https://hdmatrix.pro/en/composite
- Compatibility: https://hdmatrix.pro/en/compatibility
- I Ching Oracle: https://hdmatrix.pro/en/iching
- Predictive cycles: https://hdmatrix.pro/en/predictive-cycles
- Conception calculator: https://hdmatrix.pro/en/conception
- Family dynamics: https://hdmatrix.pro/en/family
- Penta (group) analysis: https://hdmatrix.pro/en/penta
- Rectification helper: https://hdmatrix.pro/en/rectification
- HD Dating: https://hdmatrix.pro/en/dating

## Learning Resources
- Beginner's guide: https://hdmatrix.pro/en/beginner
- Full HD learning hub: https://hdmatrix.pro/en/learn
- FAQ: https://hdmatrix.pro/en/faq
- Blog: https://hdmatrix.pro/en/blog
- Glossary: https://hdmatrix.pro/en/glossary
- Types overview: https://hdmatrix.pro/en/types
- Profiles overview: https://hdmatrix.pro/en/profiles
- Centers guide: https://hdmatrix.pro/en/centers

## Reference Pages
- All 64 gates: https://hdmatrix.pro/en/gates
- All 39 channels: https://hdmatrix.pro/en/channels
- All 7 authorities: https://hdmatrix.pro/en/authorities
- All 12 profiles: https://hdmatrix.pro/en/profiles
- All 134 incarnation crosses (each with a classical and a Quantum Human Design reading): https://hdmatrix.pro/en/cross
- Celebrity charts: https://hdmatrix.pro/en/celebrities
- Celebrity stats: https://hdmatrix.pro/en/celebrity-stats

## Optional / Secondary
- Public stats: https://hdmatrix.pro/en/stats
- What's new: https://hdmatrix.pro/en/whats-new
- Reviews: https://hdmatrix.pro/en/reviews
- About: https://hdmatrix.pro/en/about
- Contact: https://hdmatrix.pro/en/contact
- Support: https://hdmatrix.pro/en/support
- Experiment (7-year deconditioning): https://hdmatrix.pro/en/experiment
- Deconditioning program: https://hdmatrix.pro/en/deconditioning
- Shadow work: https://hdmatrix.pro/en/shadow-work
- Calendar: https://hdmatrix.pro/en/calendar
- Planner: https://hdmatrix.pro/en/planner
- Resources: https://hdmatrix.pro/en/resources
- Weekly report: https://hdmatrix.pro/en/weekly-report

## AI Context API (requires key)
Structured Human Design context for AI assistants. POST `https://hdmatrix.pro/api/ai/context` with `X-AI-API-Key` header. Supports `telegramUserId`, `webUserId`, or `email`. Returns profile, transits, cycles, daily theme + human-readable `aiContext`.

## Language Coverage
The platform is available in 31 languages: English, Ukrainian, Russian, Polish, Italian, French, Spanish, German, Hebrew, Swedish, Danish, Norwegian, Portuguese, Dutch, Turkish, Serbian, Arabic, Bulgarian, Indonesian, Chinese, Japanese, Korean, Thai, Lithuanian, Latvian, Estonian, Slovak, Czech, Romanian, Georgian, Armenian.

## Contact
- Telegram bot: https://t.me/hdmatrixbot
- Telegram channel: https://t.me/hdmatrix_channel
- Email: info@hdmatrix.pro