Log inSubmit server
Saroday MCP Server logo

Saroday MCP Server

Calculates Korean Saju, explains 80+ myeongni-hak terms, and provides daily fortune data through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Saroday MCP Server

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": {
    "saroday-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@saroday/mcp-server"
      ],
      "env": {
        "SARODAY_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.

Install not yet sandbox-testedโ€” the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The saroday-mcp-server MCP server connects MCP-compatible AI clients to Saroday for Korean Saju calculation and myeongni-hak glossary lookups. It exposes four tools: full Four Pillars analysis, glossary search, daily fortune retrieval, and Saroday API discovery. The local stdio adapter sends requests to the Saroday API, which performs the calculation and returns structured results. Use it when an AI client needs Saju data without relying on the model to calculate manse-ryeok or interpret terminology from scratch.

Use cases

  • Calculate a userโ€™s Korean Saju from birth details
  • Explain Korean myeongni-hak terminology
  • Retrieve daily Western or Chinese zodiac fortunes
  • Inspect available Saroday API endpoints

Key features

  • Full Four Pillars calculation
  • 80+ myeongni-hak glossary terms
  • Western and Chinese zodiac daily fortunes
  • Saroday API endpoint discovery
  • Stdio MCP transport
  • Configurable API base URL

Tools4

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

Verified live~504 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 2d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev ยท @saroday/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks โ€” not a rating.

npm downloads179Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Saroday MCP Server works

What saroday-mcp-server MCP server does

The saroday-mcp-server MCP server gives an AI client access to Sarodayโ€™s Korean Saju and myeongni-hak services. It is intended for applications that need structured Four Pillars data, Korean fortune-telling terminology, or daily fortune results through the Model Context Protocol.

Its primary calculation tool accepts a birth date, time, and gender, then returns a broad Saju analysis. The response can include the eight characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, and daeun. This keeps calendar and solar-term boundary calculations on the Saroday service instead of asking the language model to reproduce them.

The glossary tool covers more than 80 myeongni-hak terms, including concepts such as ๋„ํ™”์‚ด, ์ฒœ์„๊ท€์ธ, ์‹์‹ , and ์œกํ•ฉ. Entries provide Korean explanations. A separate daily-fortune tool supports the 12 Western zodiac signs and the 12 Chinese zodiac signs, while the discovery tool lists Saroday API endpoints and metadata.

How it works

The package runs locally as an MCP process and communicates with the client over stdio. When the client invokes a tool, the adapter sends an HTTPS request to Saroday. Saroday performs the Saju calculation or retrieves the requested information, then returns JSON through the adapter to the AI client.

The package is a thin connection layer; the calculation and glossary data live on Sarodayโ€™s servers. This means changes to the remote algorithm or content can become available without upgrading the local package. Daily fortune responses are cached server-side.

The public Saroday API has a free-use limit of 100 requests per hour for each IP address.

Setup and configuration

The saroday-mcp-server MCP server requires Node.js 18 or newer. You can run it without a global installation with npx @saroday/mcp-server, install it globally with npm and run saroday-mcp, or clone the repository, install dependencies, and start node index.js.

For Claude Desktop, add an MCP entry that uses npx with the -y argument and the package name, then restart the application. Cline, Cursor, and other clients with stdio support can point to the saroday-mcp executable or to node index.js; their configuration syntax varies by client.

Set SARODAY_API_BASE to replace the default https://saroday.com API base. This is useful for a staging or self-hosted endpoint, where supported by that deployment. No other environment variables are documented.

Tools and capabilities

  • calculate_saju calculates a full Saju result from birth information.
  • lookup_glossary retrieves explanations for supported myeongni-hak terms.
  • get_daily_fortune returns todayโ€™s fortune for a Western or Chinese zodiac sign.
  • discover_saroday_api reports available Saroday API endpoints and metadata.

The server is suited to conversational prompts in Korean or English when the client can translate the userโ€™s request into one of these tool calls.

Limitations and notes

The saroday-mcp-server MCP server depends on the Saroday API for its calculations and content, so it is not a standalone local manse-ryeok implementation. Network access to the configured API base is required. Free public API usage is limited to 100 requests per hour per IP, which may restrict high-volume applications.

The documented transport is stdio. The README names Claude Desktop, Cline, and Cursor as compatible clients and does not document client-specific features beyond MCP stdio support. The project is released under the MIT license.

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 Saroday MCP Server

saroday-mcp-server is an MCP server that connects AI clients to the Saroday API for Korean Saju calculation and myeongni-hak lookup. Its main tools calculate full Four Pillars results, explain more than 80 glossary terms, retrieve daily fortunes for Western or Chinese zodiac signs, and discover Saroday API endpoints.

Install it with npx, npm, or from a cloned repository. Run `npx @saroday/mcp-server`, install globally with `npm install -g @saroday/mcp-server` and run `saroday-mcp`, or install dependencies and start `node index.js`. Node.js 18 or newer is required.

Yes, saroday-mcp-server works with Cursor when configured through its MCP stdio support. Point Cursor at the `saroday-mcp` executable or at `node index.js`; the exact configuration format depends on the client.

Set the `SARODAY_API_BASE` environment variable to the replacement API base URL. The default is `https://saroday.com`, and the variable can be used for staging or self-hosted environments.

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 PreviewSaroday MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/saroday-mcp-server?style=directory)](https://allmcps.com/mcp/saroday-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/saroday-mcp-server"><img src="https://allmcps.com/api/badge/saroday-mcp-server?style=directory" alt="Saroday MCP Server on AllMCPs" /></a>