Korean Saju (Four Pillars / 사주명리) MCP server — 5 free birth-chart analysis tools (chart, five-elements, gyeokguk, yin-yang/climate, yongshin candidates) powered by the CAFE engine.
All 5 tools have complete, well-structured input schemas with proper type definitions and comprehensive parameter descriptions. Tool names follow verb_noun convention (saju_chart, ohaeng_balance, gyeokguk, eumyang_johu, yongshin_candidates). Descriptions are detailed (150 - 250 chars) and explain WHAT the tool does, WHEN to use it, and domain context (Korean Saju terminology). All parameters are typed and described. However, output schemas are NOT documented, the code forwards backend JSON responses without declaring the structure LLMs should expect. Error handling is minimal (only 'Unknown tool' rejection visible). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all tools being read-only operations.
Yin-Yang (陰陽 / 음양) and Climate (調候 / 조후: hot-cold-wet-dry) balance diagnostic. Reports the yin-yang ratio, the warm/cold·dry/wet tendency, and how each balance shifts across both major (대운) and yearly (세운) fortune periods. Use for 'is my chart hot or cold', 'my yin-yang / climate balance', '조후 분석'.
Gyeokguk (格局, chart structure/pattern) determination. Reads the chart's governing structure from the day-master and month-branch by classical Myeongli rules. Returns the named pattern with its true/quasi grade (e.g. 편인격 · 가격), the body strength (신강/신약), supporting sub-patterns (e.g. 식상생재), the favorable element (yongshin), and the five-element distribution behind the judgment. Use for 'what is my gyeokguk', 'what's my chart pattern / structure', '내 격국이 뭐야'.
Five Elements (五行 / 오행: Wood·Fire·Earth·Metal·Water) distribution of the natal chart. Computes each element's percentage including hidden-stem (지장간) weighting, then reports the dominant and the weakest element. Use to gauge elemental balance and excess/lack. Use for 'analyze my five elements', 'which element am I missing', '오행 분석'.
Korean Saju (Four Pillars / 四柱八字) natal chart with annotations. Returns the four pillars (year/month/day/hour) with their heavenly stems and earthly branches, the Ten Gods (十神) mapping, the five-element ratios, plus the Spirit Stars (神殺 / 신살) and Twelve Life Stages (十二運星 / 십이운성) annotations on each pillar. The foundational reading other tools build on. Use for 'show me my saju', 'what's my birth chart', '내 사주 봐줘'.
Output schemas not documented. Code forwards backend /try/panels JSON responses without declaring the structure (fields, types, nesting) LLMs should expect. Forces LLMs to infer output shape from examples or trial-and-error.
No tool annotations. All 5 tools are read-only (no state modification), but readOnlyHint is not set in tool definitions. Agents cannot distinguish read-only from destructive tools without explicit hints.
Minimal error handling. Only 'Unknown tool' rejection visible in CallToolRequestSchema handler. No guidance for network failures, invalid birth dates (YYYYMMDDHHMM format), timeout errors, or backend API errors. LLMs receive raw error responses with no recovery hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Classical Yongshin (用神, favorable element) candidates. Returns all five traditional derivation methods — Eokbu (억부) / Byeongyak (병약) / Tonggwan (통관) / Johu (조후) / Gyeokguk (격국) — with each method's candidate element(s) and primary pick. Does NOT include an AI-selected final yongshin or confidence scores (those are part of the full 24Plus service). Use for 'what are my yongshin candidates', 'which element favors me', '용신 후보'.
No input validation. Birth date format (YYYYMMDDHHMM) and gender enum (0|1) are declared but not validated at tool invocation. Invalid inputs pass through to backend, risking 400/500 errors with no actionable guidance.
Shared input schema across all tools. While DRY, it obscures tool-specific parameter relevance. E.g., yongshin_candidates may not need 'name' parameter, but it's required in the shared schema. No per-tool schema customization.