# SAJU (Korean Fortune Teller)

SAJU (Korean Fortune Teller) is a Claude Code MCP server that calculates Four Pillars from a birth date and compares charts by Day Master element in agent chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1338 installs
- Author: saju-from-seoul
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/saju-from-seoul/saju
- Updated: 2026-04-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/saju-korean-fortune-teller

## What it does

The server derives year, month, day, and hour pillars from a Gregorian birth date. It also reports the Five Elements balance and Day Master details. Supply a local birth time to refine the hour pillar.

Four tools are available: `calculate_saju` builds a chart, `get_day_master` returns a brief profile, `check_compatibility` compares two charts, and `list_stems_and_branches` provides a reference list. The calculations are deterministic and need no API key; the server makes no calls to an external fortune API. These tools provide chart data and short summaries, not full narrative readings.

## Requirements
- Remote server: `https://saju--saju-from-seoul.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http saju https://saju--saju-from-seoul.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add saju-korean-fortune-teller --url https://saju--saju-from-seoul.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "saju-korean-fortune-teller": {
            "url": "https://saju--saju-from-seoul.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "saju-korean-fortune-teller": {
            "type": "http",
            "url": "https://saju--saju-from-seoul.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http saju-korean-fortune-teller https://saju--saju-from-seoul.run.tools
```

## When to use it
- calculate Four Pillars from a birth date
- check a chart’s Five Elements balance
- get a brief Day Master profile
- compare two charts by element harmony
- look up stems and branches

## Example prompts
- Calculate the chart for birth date 1990-05-12 and report its element balance.
- Give me the short profile for this chart’s Day Master.
- Compare these two charts by Day Master compatibility.

## Similar
- [Saju Insights](https://affpapa.org/en/nevibecode/mcp/saju-insights.md) — MCP server · 5994 installs
- [Korean Law Search](https://affpapa.org/en/nevibecode/mcp/korean-law-search.md) — MCP server · 5297 installs
- [Korean Crypto](https://affpapa.org/en/nevibecode/mcp/korean-crypto.md) — MCP server · 3930 installs
- [korean-jangbu-for](https://affpapa.org/en/nevibecode/skills/korean-jangbu-for.md) — skill · 11500 installs
- [kordoc-korean-document-parser](https://affpapa.org/en/nevibecode/skills/kordoc-korean-document-parser.md) — skill · 782 installs
- [korean-law-mcp](https://affpapa.org/en/nevibecode/skills/korean-law-mcp.md) — skill · 215 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
