Log inSubmit server
Saju MCP logo

Saju MCP

Compute and interpret Korean Four Pillars charts, compare compatibility, and retrieve daily fortune data through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Saju MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "saju-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "saju-mcp"
      ],
      "env": {
        "SAJU_API_KEY": "YOUR_VALUE_HERE",
        "SAJU_API_BASE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 4 tools correctly (3d ago).

Overview

  • saju
  • bazi
  • astrology
  • mcp

The saju-mcp MCP server connects MCP-capable clients to a remote Saju API for Korean Four Pillars calculations and readings. It runs over stdio and provides tools for chart calculation, interpretation, two-person compatibility, and daily fortune snapshots. Responses include readable text and structured data for fields such as elements, Day Master, and compatibility scores. Reach for it when an agent needs Saju or BaZi results from solar birth details, with support for localized output.

Use cases

  • Calculate a Four Pillars chart from solar birth details
  • Interpret Ten Gods, Yongshin, and Daeun data
  • Compare two people using a compatibility score
  • Retrieve daily fortune advice for a Day Master

Key features

  • Four Pillars with stems, branches, and Hanja
  • Five-element distribution and Day Master data
  • Ten Gods, hidden stems, Yongshin, and Daeun readings
  • Compatibility scoring with relationship breakdowns
  • Localized output in 10 languages
  • Structured MCP responses

Tools4

What Saju MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

4/4 checks healthy over the last 21d

What it can do

From the 4 tools this server returned when we ran it.

Read-only tools · 4
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age124 days
Maintainers1

Observed 2026-10-19 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · saju-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads118Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed4Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Saju MCP works

What saju-mcp MCP server does

The saju-mcp MCP server exposes the Saju API through four MCP tools for Korean Four Pillars of Destiny, also called Saju or BaZi. It accepts solar birth details and returns chart data, interpretive information, relationship comparisons, or daily fortune results.

The server is suited to conversational agents that need to calculate or explain Saju charts without implementing calendar conversion and interpretation logic locally. Output can be requested in Korean, English, Japanese, Chinese, Spanish, Portuguese, Vietnamese, Indonesian, Hindi, or Thai. The default language is Korean.

How it works

The package starts as a Node.js process and communicates with the MCP client over stdio. Each tool forwards a request to the corresponding endpoint on the hosted Saju API. The default upstream URL is https://saju-api.pages.dev, and requests are authenticated with an API key sent as the X-API-Key header.

Results are returned both as readable tool text and as structuredContent. Agents can therefore use fields such as the Day Master element, five-element counts, or a compatibility score without extracting values from prose.

Birth inputs are validated by the service. Supported bounds include years 1920–2050, months 1–12, days 1–31, and hours from -1 to 23. An hour of -1 represents an unknown birth hour. Gender accepts M or F, and language must use one of the supported language codes.

Setup and configuration

To run the saju-mcp MCP server, install Node.js and start it with npx:

bash
SAJU_API_KEY="sajuapi_free_xxx" npx -y saju-mcp

Create an API key through the Saju API key endpoint before making real requests. The free tier provides 100 requests per day with a one-request-per-second limit. The key is displayed once when created, so it should be stored securely and supplied through the environment rather than embedded in client configuration or source code.

The required environment variable is SAJU_API_KEY. SAJU_API_BASE is optional and can point to another API deployment, such as a staging service. Claude Desktop, Cursor, VS Code, and Windsurf can all register the server with npx, the package name, and an environment entry containing the key. Reload or restart the client after changing its MCP configuration.

Tools and capabilities

  • saju_calculate derives the four pillars, including stems, branches, and Hanja, from a solar birthdate. It also reports five-element distribution, the Day Master, and zodiac sign.
  • saju_interpret produces a fuller reading with Ten Gods, hidden stems, Yongshin, Daeun, and localized summaries.
  • saju_compatibility compares two people and returns a score from 0 to 100 with element-balance, Day Master relationship, and branch harmony or clash details.
  • saju_daily provides a dated fortune snapshot and advice using a Day Master supplied by the caller.

For calculation and interpretation, requests can include year, month, day, hour, gender, and language. Compatibility takes two person records plus a language. Daily fortune takes a Day Master, date, and language.

Limitations and notes

Because the saju-mcp MCP server depends on the upstream API, missing, invalid, or revoked keys produce an authentication error. Exceeding the free quota returns a rate-limit error, while malformed or out-of-range fields return an input error. Network or proxy failures may result in a non-JSON response and require a retry or verification of the configured base URL.

The documented server transport is stdio; it is not described as a standalone HTTP MCP service. Daily fortune expects a Day Master value, typically obtained from an earlier calculation or interpretation call. The project is marked proprietary in its repository metadata.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Saju MCP

saju-mcp is an MCP server that connects AI clients to the Saju API for Korean Four Pillars and BaZi calculations. Its main tools calculate charts, interpret Ten Gods and related readings, compare two people for compatibility, and return daily fortune snapshots using a Day Master and date.

Run it with Node.js and npx using `SAJU_API_KEY="your_key" npx -y saju-mcp`. No repository clone or local build is required for the package route. You must first create a Saju API key and provide it through the `SAJU_API_KEY` environment variable.

Yes, saju-mcp works with Cursor through its stdio MCP configuration. Add the server to `~/.cursor/mcp.json` or a project-level `.cursor/mcp.json` with `npx`, `-y`, `saju-mcp`, and an environment entry for `SAJU_API_KEY`, then reload Cursor.

It requires a Saju API key in the `SAJU_API_KEY` environment variable. The server sends that value as the `X-API-Key` header, and calls without a valid key return `401 invalid_api_key`. `SAJU_API_BASE` can optionally override the default upstream URL.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSaju MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/saju-mcp?style=directory)](https://allmcps.com/mcp/saju-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/saju-mcp"><img src="https://allmcps.com/api/badge/saju-mcp?style=directory" alt="Saju MCP on AllMCPs" /></a>