{
  "markdown": "# @saroday/mcp-server\n\nMCP (Model Context Protocol) server for [Saroday](https://saroday.com) — Korean Saju (사주) calculation and myeongni-hak (命理學) glossary lookup.\n\nThis 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.\n\n---\n\n## What it does\n\nWhen connected, the AI client gains access to four tools:\n\n| Tool | Description |\n|------|-------------|\n| `calculate_saju` | Compute full Saju analysis (8 characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, daeun) from birth date / time / gender. |\n| `lookup_glossary` | Look up any of 80+ myeongni-hak terms (도화살, 천을귀인, 식신, 육합, etc.) with full Korean explanation. |\n| `get_daily_fortune` | Today's fortune for one of 12 Western zodiac signs or 12 Chinese zodiac signs. Cached server-side, fast response. |\n| `discover_saroday_api` | List available Saroday API endpoints and metadata. |\n\nWhy this matters: ChatGPT, Claude, and other LLMs frequently miscalculate Saju when asked directly because manse-ryeok (萬歲曆) lookup and 절기 (jeolgi) boundary handling require precise data. This MCP delegates the math to a verified server while letting the AI focus on the interpretation.\n\n---\n\n## Installation\n\n### Option A — npx (no install)\n\n```bash\nnpx @saroday/mcp-server\n```\n\n### Option B — global install\n\n```bash\nnpm install -g @saroday/mcp-server\nsaroday-mcp\n```\n\n### Option C — clone and run\n\n```bash\ngit clone https://github.com/saroday/mcp-server.git\ncd mcp-server\nnpm install\nnode index.js\n```\n\nRequires Node.js 18 or newer.\n\n---\n\n## Configure Claude Desktop\n\nEdit your Claude Desktop config file:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd (or merge) the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"saroday\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@saroday/mcp-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see \"saroday\" listed in the MCP servers panel (the plug icon in the input area).\n\n### Local development (running from cloned repo)\n\n```json\n{\n  \"mcpServers\": {\n    \"saroday\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-server/index.js\"]\n    }\n  }\n}\n```\n\n---\n\n## Configure Cline / Cursor / other MCP clients\n\nAny MCP client that supports stdio transport works. Point it at the `saroday-mcp` binary or `node index.js`. See your client's docs for the exact config format.\n\n---\n\n## Try it out\n\nAfter connecting, ask Claude things like:\n\n- *\"My birthday is March 15, 1992 at 10am. Calculate my Korean Saju.\"*\n- *\"What does 도화살 (dohwa-sal) mean in Korean fortune-telling?\"*\n- *\"내 사주 봐줘. 1990년 5월 20일 음력 14시 여성.\"*\n- *\"제왕(jeokwang) 12-unseong이 뭐야?\"*\n\nClaude will automatically invoke `calculate_saju` or `lookup_glossary` and give you a polished interpretation based on the structured data returned.\n\n---\n\n## Environment variables\n\n| Variable | Default | Purpose |\n|----------|---------|---------|\n| `SARODAY_API_BASE` | `https://saroday.com` | Override the API base URL (e.g., for self-hosted or staging environments). |\n\n---\n\n## Rate limits\n\nThe public Saroday API allows **100 requests per hour per IP** for free use. Heavy users — apps shipping to many end-users, AI agents handling many concurrent users — should request an API key (coming soon) for higher quotas.\n\nContact: contact@saroday.com\n\n---\n\n## How it works\n\n```\n[User in Claude Desktop]\n        ↓ types \"내 사주 봐줘\"\n[Claude Desktop]\n        ↓ calls calculate_saju via MCP stdio\n[saroday-mcp (this package, runs locally)]\n        ↓ HTTPS POST /api/v1/saju\n[saroday.com server]\n        ↓ runs verified manse-ryeok algorithm\n[result JSON]\n        ↑ flows back through the chain\n[Claude] writes a beautiful Korean interpretation\n```\n\nThis MCP package is a thin adapter — all calculation lives on Saroday's servers, so updates to the algorithm or glossary roll out without you having to upgrade the package.\n\n---\n\n## Differentiators\n\n- **Manse-ryeok accuracy** — handles 절기 (solar terms) boundaries that LLMs routinely get wrong (verified against `@fullstackfamily/manseryeok` library)\n- **80+ glossary entries (~400 interpretation fields)** — every sinsal, hapchung, sipseong, 12-unseong term has summary / meaning / positive / negative / practical-tip interpretation written in friendly Korean\n- **Korean myeongni-hak tradition** — based on 적천수(滴天髓), 자평진전(子平真詮), 궁통보감(窮通寶鑑) references\n- **Three-channel exposure** — same algorithm available as web service (saroday.com), public REST API (saroday.com/api/v1), and MCP server (this package). Pick the channel that fits your integration.\n\n---\n\n## License\n\nMIT\n\n---\n\n## Support\n\n- Web: https://saroday.com\n- API docs: https://saroday.com/api/docs\n- LLM-friendly index: https://saroday.com/llms.txt\n- Email: contact@saroday.com\n",
  "bytes": 4888,
  "sha": "0f004f1cb1292f9514a8bda5a188e91a34e0822c2565a925b3f44045ba112710",
  "repo_slug": "yolstudio26-oss/saroday-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_yolstudio26_oss_saroday_mcp_se_adb8c705/readme"
}