# SAJU (Korean Fortune Teller)

Saju from Seoul — Korean Four Pillars (사주) over MCP: compute 년·월·일·시 pillars, Five Elements balance, Day Master (일간) profiles, stem/branch reference, and Day Master compatibility. Deterministic math,…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add saju-from-seoul/saju

# Browse available tools
npx -y @smithery/cli@latest tool list saju-from-seoul/saju

# Get full schema for a tool
npx -y @smithery/cli@latest tool get saju-from-seoul/saju calculate_saju

# Call a tool
npx -y @smithery/cli@latest tool call saju-from-seoul/saju calculate_saju '{}'
```

## Direct MCP Connection

Endpoint: `https://saju--saju-from-seoul.run.tools`

**Optional config:**
- `locale` (query) — Optional. Adds language hints to the server instructions for prompts (en, ko, ja).
- `detail_level` (query) — Optional. brief = shorter instruction addendum; standard = default.

## Tools (4)

- `calculate_saju` — Compute the Korean Four Pillars (년월일시) from a Gregorian birth date: stems, branches, Day Master, and Five Element count…
- `get_day_master` — Return a short personality sketch for one Heavenly Stem (天干) Hanja — the day stem (일간) from a Saju chart.
- `check_compatibility` — Compare two birth charts and summarize Day Master (일간) element harmony (생극 오행 관계). For full couple readings, see the we…
- `list_stems_and_branches` — Return all 10 Heavenly Stems (천간) and 12 Earthly Branches (지지) with Hanja, romanization, element, and animal.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get saju-from-seoul/saju <tool-name>
```

## Resources

- `saju://reference/stems-branches` — Static JSON reference for 천간·지지 (elements, animals, double-hour ranges).
- `saju://reference/day-master-stems` — Short English profiles for each 일간天干 Hanja (甲–癸) keyed by character.

## Prompts (2)

- `interpret_saju_chart` (chart_json, audience) — Prompt template for explaining Four Pillars output in plain language (entertainment / cultural context).
- `compatibility_narrative` (compatibility_json, tone) — Turn check_compatibility JSON into a warm, readable explanation (not deterministic fortune-telling).