yolstudio26-oss avatar

Saroday Mcp Server

yolstudio26-oss/saroday-mcp-server

Connects Claude to Saroday's Korean Saju (사주) calculation API so you stop getting wrong Four Pillars results from LLMs that can't handle manse-ryeok lookups or jeolgi boundaries correctly. Exposes four tools: calculate_saju for full eight-character analysis with sipseong, sinsal, hapchung, and daeun cycles; lookup_glossary for 80+ myeongni-hak terms like 도화살 or 천을귀인; get_daily_fortune for zodiac readings; and discover_saroday_api for endpoint metadata. Runs via stdio, delegates all math to Saroday's verified server while Claude handles interpretation. Public tier gives you 100 requests per hour. Useful when you need accurate Korean fortune-telling calculations without teaching an LLM the entire 滴天髓 corpus.

tools
4
transport
STDIO
last updated
Apr 29, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

calculate_sajuCompute full Saju analysis (8 characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, daeun) from birth date / time / gender.

Compute full Saju analysis (8 characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, daeun) from birth date / time / gender.

No parameter schema in public metadata yet.

lookup_glossaryLook up any of 80+ myeongni-hak terms (도화살, 천을귀인, 식신, 육합, etc.) with full Korean explanation.

Look up any of 80+ myeongni-hak terms (도화살, 천을귀인, 식신, 육합, etc.) with full Korean explanation.

No parameter schema in public metadata yet.

get_daily_fortuneToday's fortune for one of 12 Western zodiac signs or 12 Chinese zodiac signs. Cached server-side, fast response.

Today's fortune for one of 12 Western zodiac signs or 12 Chinese zodiac signs. Cached server-side, fast response.

No parameter schema in public metadata yet.

discover_saroday_apiList available Saroday API endpoints and metadata.

List available Saroday API endpoints and metadata.

No parameter schema in public metadata yet.

Sponsors

Readme

@saroday/mcp-server

MCP (Model Context Protocol) server for Saroday — Korean Saju (사주) calculation and myeongni-hak (命理學) glossary lookup.

This MCP server lets Claude Desktop, Cline, Cursor, and any other MCP-compatible AI client perform accurate Korean Saju (Four Pillars of Destiny) calculation by calling the public Saroday API under the hood.


What it does

When connected, the AI client gains access to four tools:

ToolDescription
calculate_sajuCompute full Saju analysis (8 characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, daeun) from birth date / time / gender.
lookup_glossaryLook up any of 80+ myeongni-hak terms (도화살, 천을귀인, 식신, 육합, etc.) with full Korean explanation.
get_daily_fortuneToday's fortune for one of 12 Western zodiac signs or 12 Chinese zodiac signs. Cached server-side, fast response.
discover_saroday_apiList available Saroday API endpoints and metadata.

View the full README on GitHub

Details

Repository
github.com/yolstudio26-oss/saroday-mcp-server
Website
saroday.com
Package
@saroday/mcp-server
Transport
STDIO
Registry
MCP registry, active