{"service":"Human Design API Server","version":"4.0.0","auth":"Bearer token required","rateLimit":{"enabled":true,"maxConcurrent":100,"queueCapacity":12000,"maxQueueWait":"120s","note":"Requests exceeding concurrent limit are queued. Queue wait time returned in X-Queue-Wait-Ms header."},"features":{"staticDatabase":"Major cities worldwide","googleMapsIntegration":"Disabled (offline-only)","asteroids":"Chiron, Ceres, Pallas, Juno, Vesta","chartAngles":"AC, MC, IC, DC","compositeCharts":"Relationship analysis with electromagnetic, compromise, dominance, companionship channels","transits":"Universal planetary transit positions over date ranges","trueInnerAuthority":"V3 endpoint with nodal exclusion logic for Type/Authority calculation"},"endpoints":{"health":"/health (public)","v1":"/api/v1/data - Lean enterprise (empty tooltips)","v1Tooltip":"/api/v1/data-tooltip - Lean enterprise (full tooltips)","v2":"/api/v2/data - Full featured (empty tooltips)","v2Tooltip":"/api/v2/data-tooltip - Full featured (full tooltips)","v3":"/api/v3/data - True Inner Authority (nodal exclusion)","v3Tooltip":"/api/v3/data-tooltip - True Inner Authority (full tooltips)","astrology":"/api/v1/astrology - Western natal chart (empty tooltips)","astrologyTooltip":"/api/v1/astrology-tooltip - Western natal chart (full tooltips)","composite":"/api/v1/composite - Relationship chart (empty tooltips)","compositeTooltip":"/api/v1/composite-tooltip - Relationship chart (full tooltips)","transitMoonRange":"GET /api/transit/moon-range - Moon transits over date range","transitRange":"GET /api/transit-range - All 13 planets transits over date range","transitChart":"GET /api/v2/transit-chart - Full HD charts (type, authority, channels) over date range","legacy":"/api/human-design - Original format","sageQuery":"POST /api/sage/query - AI-powered knowledge answers (also supports GET ?q=...)"},"v3Concept":{"name":"True Inner Authority","philosophy":{"northNode":"Rahu = FUTURE trajectory - excluded until Uranus Opposition (~age 38-43)","southNode":"Ketu = Already conditioned energy - VALID for authority (has defined you since birth)"},"rule":"Gates activated EXCLUSIVELY by North Node are excluded from Type/Authority calculation","uranusOpposition":"At age ~38-43, North Node trajectory activates and chart transitions to standard Type/Authority","centersStillDefine":"All nodal channels still define centers for conditioning awareness","typeCanChange":"Type may change if North Node exclusively defines key centers (e.g., Generator → Reflector)"},"transitEndpoints":{"moonRange":{"method":"GET","path":"/api/transit/moon-range","params":"startDate, endDate (required), granularity (optional: daily|hourly)","example":"/api/transit/moon-range?startDate=2024-01-01&endDate=2024-01-07&granularity=daily"},"allPlanets":{"method":"GET","path":"/api/transit-range","params":"startDate, endDate (required), granularity (optional: daily|hourly)","example":"/api/transit-range?startDate=2024-01-01&endDate=2024-01-07","planets":["Sun","Earth","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Rahu","Ketu"]},"fullTransitChart":{"method":"GET","path":"/api/v2/transit-chart","params":"startDate, endDate (required), granularity (optional: daily|hourly, default: hourly)","example":"/api/v2/transit-chart?startDate=2024-01-01&endDate=2024-01-02&granularity=hourly","returns":"Full HD charts with Type, Authority, Channels, Centers, PHS, Variables","note":"Computes complete Human Design interpretation at each timestamp. No birth location required."},"sage":{"method":"POST (GET also supported)","path":"/api/sage/query","body":"{\"query\": \"What is Gate 1 in Human Design?\"}","getParams":"q (required query string)","example":"POST /api/sage/query with {\"query\": \"Gate 1\"} OR GET /api/sage/query?q=Gate%201","returns":"AI-generated answer with sources and domain classification","unitsConsumed":5,"note":"Requires SAGE API subscription (sage_api product). Returns AI-mediated answers using the knowledge base as context. Each query consumes 5 units."}},"documentation":"https://github.com/sphinxcode/humandesignmcp"}