Server data from the Official MCP Registry
Korean Four Pillars of Destiny (Saju/Bazi): calculate, interpret, compatibility & daily fortune.
Korean Four Pillars of Destiny (Saju/Bazi): calculate, interpret, compatibility & daily fortune.
Valid MCP server (3 strong, 4 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: SAJU_API_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-ghdejr11-beep-saju-mcp": {
"env": {
"SAJU_API_KEY": "your-saju-api-key-here"
},
"args": [
"-y",
"saju-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
An MCP (Model Context Protocol) server that wraps the Saju API — Korean Four Pillars of Destiny (사주팔자 / Bazi) — so MCP-capable clients (Claude Desktop, Cursor, and other MCP hosts) can compute and interpret Saju directly in a conversation.
Backed by the live API at https://saju-api.pages.dev (10 languages: ko, en, ja, zh, es, pt-br, vi, id, hi, th).
| Tool | Upstream endpoint | What it does |
|---|---|---|
saju_calculate | POST /api/v1/calculate | Four Pillars (stem+branch+hanja), five-element distribution, Day Master, zodiac, from a solar birthdate. |
saju_interpret | POST /api/v1/interpret | Full reading: Ten Gods (십신), hidden stems, Yongshin (용신), Daeun (대운), localized summaries. |
saju_compatibility | POST /api/v1/compatibility | Two-person 궁합 score (0–100) with breakdown (element balance, Day Master relation, branch harmony/clash). |
saju_daily | GET /api/v1/daily | Daily fortune snapshot (score + advice) for a Day Master and date. |
fetch).curl -X POST https://saju-api.pages.dev/api/v1/keys/create \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com"}'
The response contains an api_key of the form sajuapi_free_.... Keep it
secret — it is passed to the server via the SAJU_API_KEY environment variable,
never hardcoded.
npm install
npm run build # compiles src/index.ts -> dist/index.js
Quick local check (lists the 4 tools, then exits):
SAJU_API_KEY="sajuapi_free_xxx" npm start
Edit your claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd (use the absolute path to the built dist/index.js):
{
"mcpServers": {
"saju": {
"command": "node",
"args": ["D:\\kunstudio-apps\\saju-mcp\\dist\\index.js"],
"env": {
"SAJU_API_KEY": "sajuapi_free_your_key_here"
}
}
}
}
Restart Claude Desktop. The four saju_* tools appear in the tools menu.
Other MCP hosts (Cursor, Windsurf, custom clients) use the same shape:
command: "node",args: ["<abs path>/dist/index.js"], and aSAJU_API_KEYenv var.
| Variable | Required | Default | Notes |
|---|---|---|---|
SAJU_API_KEY | yes (for real calls) | (empty) | Your sajuapi_* key, sent as the X-API-Key header. Without it, every call returns 401 invalid_api_key. |
SAJU_API_BASE | no | https://saju-api.pages.dev | Override the upstream base URL (e.g. for a staging deploy). |
saju_calculate / saju_interpret:
{ "year": 1990, "month": 5, "day": 15, "hour": 14, "gender": "M", "lang": "en" }
(hour: -1 if the birth hour is unknown.)
saju_compatibility:
{
"person_a": { "year": 1990, "month": 5, "day": 15, "hour": 14, "gender": "M" },
"person_b": { "year": 1992, "month": 8, "day": 3, "hour": 9, "gender": "F" },
"lang": "en"
}
saju_daily (Day Master from a prior calculate/interpret call):
{ "day_master": "갑", "date": "2026-06-17", "lang": "en" }
Proprietary — KunStudio. Wraps the Saju API; subject to that API's terms.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.