Mmcp.market

Saju MCP server

by ghdejr11-beep·io.github.ghdejr11-beep/saju-mcp·v0.1.0
No reviews yet

Korean Four Pillars of Destiny (Saju/Bazi): calculate, interpret, compatibility & daily fortune.

C69/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C69/100

full report

Adoption
New

0 stars31 downloads/wk

Reviews

Write one

Nobody has reviewed Saju yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Saju tools (4)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • saju_calculate

    Compute the Korean Four Pillars of Destiny (사주팔자 / Bazi) from a

  • saju_compatibility

    Score two-person compatibility (궁합) from 0–100 based on both

  • saju_daily

    Daily fortune snapshot (0–100 score + advice) for a given Day Master

  • saju_interpret

    Full Saju interpretation from a solar birthdate: the Four Pillars plus

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 90 days ago8/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the Saju repository's README, as published. We do not edit it. Read it on GitHub

Saju MCP — Korean Four Pillars & BaZi Astrology

An MCP (Model Context Protocol) server that wraps the Saju API — Korean Four Pillars of Destiny (사주팔자 / BaZi / 八字) — so any MCP-capable AI client (Claude Desktop, Cursor, VS Code, Windsurf, and custom agents) can compute, interpret, and compare Korean Saju charts directly in a conversation.

SAJU_API_KEY="sajuapi_free_xxx" npx saju-mcp

30-second path: get a free key → add the config → ask your AI client "calculate the saju for someone born 1990-05-15 14:00, male."

Why this MCP?

from generic Western astrology APIs that only return sun/moon signs.

  • The only production-grade Korean Saju engine available as an MCP server.
  • KASI-validated lunar conversion (47,000+ days cross-checked, zero failures).
  • Ten Gods (十神) + Yongshin (用神) + Daeun (大運) — interpretive features absent

Portuguese, Vietnamese, Indonesian, Hindi, Thai.

  • 10 output languages: Korean, English, Japanese, Chinese, Spanish,

and upgrade only when your app needs production volume.

  • Free tier: 100 requests/day, no credit card. Freemium — start building today

Backed by the live API at https://saju-api.pages.dev.

What it looks like in practice

Ask your AI client a natural-language question; it calls sajucalculate and gets back structured data it can reason over. This is a real, unedited** response from the live API for { year: 1990, month: 5, day: 15, hour: 14, gender: "M", lang: "en" }:

{
  "pillars": {
    "year":  { "stem": "경", "branch": "오", "stem_hanja": "庚", "branch_hanja": "午" },
    "month": { "stem": "신", "branch": "사", "stem_hanja": "辛", "branch_hanja": "巳" },
    "day":   { "stem": "경", "branch": "진", "stem_hanja": "庚", "branch_hanja": "辰" },
    "hour":  { "stem": "계", "branch": "미", "stem_hanja": "癸", "branch_hanja": "未" }
  },
  "elements": { "wood": 0, "fire": 2, "earth": 2, "metal": 3, "water": 1 },
  "day_master": { "stem": "경", "element": "metal", "polarity": "yang" },
  "zodiac": "horse",
  "tier": "free",
  "remaining": 99
}

Every response is returned to the model as both human-readable text and structuredContent, so agents can branch on day_master.element, elements, a compatibility score, etc. without re-parsing prose.

Tools

Quickstart

1. Get a free API key (no card)

The free tier is 100 requests/day, no credit card:

curl -X POST https://saju-api.pages.dev/api/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@yourcompany.com"}'

The response contains an apikey of the form sajuapifree_...:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y saju-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add saju-mcp -- npx -y saju-mcp
Add to Cursor

Saju: common questions

Is Saju MCP server safe?
With care: it is graded C, so read the findings first (69/100). Read the Saju safety report
How do I install Saju?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Saju need an API key?
Yes. The registry entry asks for SAJU_API_KEY.
Is Saju maintained?
The last commit was 91 days ago (2026-06-28). The latest release is v0.1.0.

More from ghdejr11-beep →