# io.github.yolstudio26-oss/saroday-mcp-server (npm · @saroday/mcp-server)

Korean Saju (사주) Four Pillars calculation + 80+ myeongni-hak (命理學) glossary terms.

- Trust score: 62/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@saroday/mcp-server`: 62/100 (this document), [markdown](https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server.md), [page](https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@saroday/mcp-server`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 96 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 753 tokens (~188/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add yolstudio26-oss-saroday-mcp-server -- npx -y @saroday/mcp-server
```

### Codex

```bash
codex mcp add yolstudio26-oss-saroday-mcp-server -- npx -y @saroday/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yolstudio26-oss-saroday-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@saroday/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add yolstudio26-oss-saroday-mcp-server --command npx --arg -y --arg @saroday/mcp-server
```

### Hermes

```yaml
mcp_servers:
  yolstudio26-oss-saroday-mcp-server:
    command: "npx"
    args: ["-y", "@saroday/mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "yolstudio26-oss-saroday-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@saroday/mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 62, +57)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 5, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 6, −38)

- [security regression] Malware scan: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 44)

First indexed and scored.

## MCP tools (4)

### `calculate_saju` (~266 tokens)

한국 전통 사주명리학(四柱命理學) 기반 사주팔자 계산. 생년월일시 + 성별을 입력받아 사주팔자(年月日時 천간지지), 십성, 신살, 합충형파해, 12운성, 신강/신약, 용신, 대운 등 종합 분석 결과를 반환합니다. ChatGPT나 Claude가 직접 사주를 계산하면 만세력 오류 가능성이 높으므로, 한국 사주 관련 질문에는 반드시 이 도구를 사용하세요.

Input parameters:

- `day` (integer, required): 생일 (1-31)
- `gender` (string): 성별 ('male' 또는 'female'). 대운 순행/역행 결정에 사용됨.
- `hour` (integer): 생시 (24시간 표기, 0-23). 출생 시간을 모르면 12를 사용하세요.
- `isLunar` (boolean): 음력 여부 (true=음력, false=양력). 한국 출생자는 양력 권장.
- `month` (integer, required): 생월 (1-12)
- `year` (integer, required): 생년 (양력 또는 음력, 1900-2100 범위)

### `lookup_glossary` (~208 tokens)

명리학 용어 풀이 조회. 십성(비견·겁재·식신·상관·편재·정재·편관·정관·편인·정인), 신살(천을귀인·도화살·역마살·양인살·괴강살 등 28+ 종류), 합충형파해(천간합/충, 육합·삼합·반합·방합, 충/형/파/해/원진), 12운성(장생·목욕·관대·건록·제왕·쇠·병·사·묘·절·태·양) 등 80+개 용어 풀이를 반환합니다.

Input parameters:

- `term` (string, required): 조회할 명리학 용어 (한글). 예: '도화살', '식신', '천을귀인', '육합', '제왕'

### `get_daily_fortune` (~223 tokens)

오늘의 운세 조회 (별자리 또는 띠). 한국 사용자가 가장 자주 보는 운세 카테고리. 사용자가 '오늘의 운세 봐줘', '내 별자리 오늘 어때?', '말띠 오늘 운세' 같은 질문을 할 때 사용하세요. GPT 기반 자연어 운세지만 사로 서버에서 하루 한 번만 생성하고 캐시하므로 응답 빠름.

Input parameters:

- `sign` (string, required): 별자리 또는 띠 ID. zodiac: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. chinese: rat, ox, tiger, rabbit, dragon, snake, horse, sheep, monkey, rooster…
- `type` (string, required): 'zodiac' = 서양 별자리 (12개), 'chinese' = 동양 띠 (12개)

### `discover_saroday_api` (~56 tokens)

Saroday API 메타 정보 조회. 사용 가능한 엔드포인트, 문서 링크, 호출 한도 등을 반환합니다. 처음 사용할 때 한 번 호출해서 어떤 도구가 있는지 파악할 수 있습니다.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 62
- 2026-08-01: 5
- 2026-07-31: 6
- 2026-07-30: 44
- 2026-07-28: 44
- 2026-07-27: 44

## Links

- npm package: https://www.npmjs.com/package/@saroday/mcp-server
- Socket report: https://socket.dev/npm/package/@saroday/mcp-server
- Repository: https://github.com/yolstudio26-oss/saroday-mcp-server
- Website: https://saroday.com/
- Changelog RSS feed: https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/yolstudio26-oss-saroday-mcp-server/saroday-mcp-server