Saju
Give Claude Code or Cursor a stdio MCP tool that computes Korean Saju birth charts, Day Masters, Five Elements balance, and compatibility for niche wellness, dating, or cultural content products.
Overview
io.github.heungmangoo-art/saju is a Build-phase MCP server that exposes Korean Four Pillars (Saju) birth charts, Day Masters, Five Elements, and compatibility to AI coding agents over stdio.
What is this MCP server?
- Stdio MCP server (saju-mcp-server on npm) at version 1.0.1 for Claude Desktop, Claude Code, Cursor, and other MCP hosts
- Four Pillars (Saju) birth-chart logic with Day Master and Five Elements (오행) analysis for agent-driven readings
- Compatibility workflows between two birth profiles for matching, counseling, or social app prototypes
- GitHub source at heungmangoo-art/saju-mcp-server with MCP 2025-12-11 server.schema.json metadata
- Domain-specific cultural astrology API, not a general LLM wrapper—deterministic chart data for your agent to narrate
- Server version 1.0.1 per server.schema.json
- Single npm package identifier: saju-mcp-server with stdio transport
- Repository: github.com/heungmangoo-art/saju-mcp-server
What problem does it solve?
Agents guess lunar-calendar pillars and element balances unless you embed vetted Saju calculation logic behind a proper tool call.
Who is it for?
Indie builders adding Korean astrology or compatibility features to agent-driven apps who want chart math behind MCP instead of prompt-only folklore.
Skip if: Teams with no Saju use case, production medical or legal advice flows, or builders who only need mainstream dev MCPs like GitHub or Postgres.
What do I get? / Deliverables
After you register saju-mcp-server, your agent can pull consistent chart and compatibility facts you shape into product copy, APIs, or prototypes.
- Registered stdio MCP server reachable from your coding agent
- Agent-callable Saju chart, element, and compatibility structured outputs for your feature layer
- A repeatable integration pattern for Korean astrology data in prototypes or content pipelines
Recommended MCP Servers
Journey fit
MCP servers are installed while you wire agent tooling into a product, which is the Build phase even when the end-user value shows up later in content or growth features. Saju is exposed as the npm stdio package saju-mcp-server for model clients, so the canonical shelf is agent-tooling rather than a standalone frontend or backend scaffold.
How it compares
Domain astrology MCP integration, not a general-purpose agent skill or a curated skills marketplace listing.
Common Questions / FAQ
Who is io.github.heungmangoo-art/saju for?
Solo and indie developers using Claude Code, Cursor, or similar MCP hosts who are building Korean Saju, wellness, or compatibility experiences and need structured chart data in the agent loop.
When should I use io.github.heungmangoo-art/saju?
Use it during Build when you wire agent-tooling and want birth charts, Day Master context, Five Elements breakdowns, or two-person compatibility without maintaining the calendrical rules yourself.
How do I add io.github.heungmangoo-art/saju to my agent?
Install the npm package saju-mcp-server (v1.0.1), add an MCP server entry with stdio transport pointing at that binary, restart your client, and confirm the Saju tools appear in the host’s MCP tool list.