SAJU (Korean Fortune Teller) — Claude Code MCP server
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.
no license 1,338 installs updated 2026-04-05
claude mcp add --transport http saju https://saju--saju-from-seoul.run.toolsWhat SAJU (Korean Fortune Teller) 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.
What it helps with
- 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 for the agent
- 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.
How to install SAJU (Korean Fortune Teller)
Platform CLI: remote server
claude mcp add --transport http saju https://saju--saju-from-seoul.run.toolsPlatform CLI: remote server
codex mcp add saju-korean-fortune-teller --url https://saju--saju-from-seoul.run.toolsConfig file
{
"mcpServers": {
"saju-korean-fortune-teller": {
"url": "https://saju--saju-from-seoul.run.tools"
}
}
}Config file
{
"servers": {
"saju-korean-fortune-teller": {
"type": "http",
"url": "https://saju--saju-from-seoul.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http saju-korean-fortune-teller https://saju--saju-from-seoul.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SAJU (Korean Fortune Teller)
How do I install SAJU (Korean Fortune Teller) in Claude Code?
Run claude mcp add --transport http saju https://saju--saju-from-seoul.run.tools. This registers the MCP server as saju.
What does SAJU (Korean Fortune Teller) do?
It calculates the Four Pillars and Five Elements balance from a birth date, returns a Day Master profile, and compares two charts by element.
Does SAJU need an API key?
No. Its calculations are deterministic, and it does not call an external fortune API.