Claude MarketplacesSubmit
heungmangoo-art avatar

Saju

heungmangoo-art/saju-mcp-server

This gives Claude access to Korean Saju (Four Pillars) astrology calculations based on birth date and time. You can generate complete birth charts showing the heavenly stems and earthly branches across year, month, day, and hour pillars, identify someone's Day Master element, analyze their Five Elements balance, and check compatibility between two people. Reach for this when you're building apps that need traditional East Asian astrology readings or want to explore how birth time correlates with elemental personality types in the Korean system. The calculations follow classical Saju principles, so it's useful for cultural applications, divination tools, or anyone curious about this branch of astrological practice.

tools
4
transport
STDIO
last updated
Apr 5, 2026
View on GitHub

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

calculate_sajuCompute the Korean Four Pillars (년월일시) from a Gregorian birth date: stems, branches, Day Master, and Five Element counts. Optional local hour refines the hour pillar.5 params

Compute the Korean Four Pillars (년월일시) from a Gregorian birth date: stems, branches, Day Master, and Five Element counts. Optional local hour refines the hour pillar.

Parameters* required
dayinteger
Birth day of month.
genderstring
Optional; included in chart metadata only.one of male · female · other
hourinteger
Local clock hour (0–23) for the time pillar; omit if unknown.
monthinteger
Birth month (1–12).
yearinteger
Birth year in the Gregorian calendar.
get_day_masterReturn a short personality sketch for one Heavenly Stem (天干) Hanja — the day stem (일간) from a Saju chart.1 params

Return a short personality sketch for one Heavenly Stem (天干) Hanja — the day stem (일간) from a Saju chart.

Parameters* required
stemstring
Single Hanja stem: 甲乙丙丁戊己庚辛壬癸 (same as returned in calculate_saju).
check_compatibilityCompare two birth charts and summarize Day Master (일간) element harmony (생극 오행 관계). For full couple readings, see the website.10 params

Compare two birth charts and summarize Day Master (일간) element harmony (생극 오행 관계). For full couple readings, see the website.

Parameters* required
person1_dayinteger
Person 1 birth day.
person1_genderstring
Optional metadata for person 1.one of male · female · other
person1_hourinteger
Person 1 local hour 0–23 if known.
person1_monthinteger
Person 1 birth month.
person1_yearinteger
Person 1 birth year (Gregorian).
person2_dayinteger
Person 2 birth day.
person2_genderstring
Optional metadata for person 2.one of male · female · other
person2_hourinteger
Person 2 local hour 0–23 if known.
person2_monthinteger
Person 2 birth month.
person2_yearinteger
Person 2 birth year (Gregorian).
list_stems_and_branchesReturn all 10 Heavenly Stems (천간) and 12 Earthly Branches (지지) with Hanja, romanization, element, and animal.2 params

Return all 10 Heavenly Stems (천간) and 12 Earthly Branches (지지) with Hanja, romanization, element, and animal.

Parameters* required
include_animalsboolean
If false, omit zodiac animal labels from branch rows (default true).
include_hour_rangesboolean
If false, omit double-hour ranges on branches (default true).

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

Details

Repository
github.com/heungmangoo-art/saju-mcp-server
Package
saju-mcp-server
Transport
STDIO
Registry
MCP registry, active