dangsaju-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dangsaju-mcpGet dangsaju reading for 1990-01-01 13:30"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
당사주 MCP (dangsaju-mcp)
생년월일시로 당사주(唐四柱) 12성(星)을 산출하는 MCP 서버. 년성(초년)·월성(중년)·일성(말년)·시성(총운·평생)의 지지·별과 해당 시기 해설 원문을 그대로 반환한다.
데이터 전용 서버. 해석·조언·페르소나는 이 서버가 만들지 않는다. 결정론적 구조화 데이터만 반환하며, 해석은 상위 레이어(SKILL/LLM)의 몫이다.
12성(星) 배속
12지지에 12성을 순서대로 고정 배속한다.
지지 | 별 | 지지 | 별 | 지지 | 별 |
자(子) | 천귀성(天貴星) | 진(辰) | 천간성(天奸星) | 신(申) | 천고성(天孤星) |
축(丑) | 천액성(天厄星) | 사(巳) | 천문성(天文星) | 유(酉) | 천인성(天刃星) |
인(寅) | 천권성(天權星) | 오(午) | 천복성(天福星) | 술(戌) | 천예성(天藝星) |
묘(卯) | 천파성(天破星) | 미(未) | 천역성(天驛星) | 해(亥) | 천수성(天壽星) |
Related MCP server: OpenFate Bazi MCP
작괘(作卦) — 12성 뽑는 법
년성을 출발점으로, 음력 생월·생일·시수만큼 지지를 순서대로 짚어 4성을 얻는다.
성 | 시기 | 산출 |
년성(年星) | 초년 | 음력 출생년의 지지 |
월성(月星) | 중년 | 년성에서 (생월−1)칸 이동 |
일성(日星) | 말년 | 월성에서 (생일−1)칸 이동 |
시성(時星) | 총운·평생 | 일성에서 (시수−1)칸 이동 (시수 子1~亥12) |
데이터의
jang(장년) 해설 필드는 보존하되 기본 4성 조합에서는 사용하지 않는다(주류 표기 정렬).
세기 규칙 (판본 분기점 명시)
inclusive(출발자리 포함): 출발 지지를 1로 세기 시작한다. 예) 丑에서 9칸 → 丑⑴寅⑵卯⑶辰⑷巳⑸午⑹未⑺申⑻酉⑼ = 酉.
순행 고정(남녀 동일)이 기본: 현재 한국 당사주 주류는 남녀 모두 순행이다.
direction="forward"(기본)에서는 성별과 무관하다.남순여역(男順女逆)은 변형:
direction="male_forward_female_backward"로 지원한다. 이 모드에서만sex가 필요하며 남자는 순행·여자는 역행한다.윤달: 평달로 정규화하여 월 번호를 그대로 쓴다(당사주 통례).
meta.leap_month_normalized로 표기.지지 순환은 12를 넘거나(순행) 0 미만(역행)이면 wrap한다.
meta.calc_trace에 년성→월성→일성→시성 이동 경로를 남긴다(세기 규칙 검증·감사용).
채택 근거 (1차 소스 완주 예시 재현): 1차 소스 다음 카페 황룡사 — 당사주 12천성 뽑는 방법이 조견표 3종과 완주 예시 2건을 싣고, "현재 한국 당사주는 남녀 모두 순행이 기본, 남순여역은 변형"임을 명시한다.
앵커 A — 을축(丑)년 음9월12일 오시(순행) → 천액·천인·천고·천권
앵커 B — 갑인(寅)년 음7월26일 오시(순행) → 천권·천고·천인·천파
변형(역행) 참고 — 子(천귀)년 음3월 여자(역행) → 월성 戌 천예성 (달마대사 당사주)
두 앵커가 inclusive 세기 + 순행으로 정확히 재현된다. 테스트(test/calc.test.js)가 이를 강제한다.
시진(時辰)표
입력 HH:MM을 12지지 시진으로 변환한다. 경계는 :30(한국 통용 30분 보정), 2시간 간격.
시진 | 시각 | 시수 | 시진 | 시각 | 시수 |
자(子) | 23:30~01:30 | 1 | 오(午) | 11:30~13:30 | 7 |
축(丑) | 01:30~03:30 | 2 | 미(未) | 13:30~15:30 | 8 |
인(寅) | 03:30~05:30 | 3 | 신(申) | 15:30~17:30 | 9 |
묘(卯) | 05:30~07:30 | 4 | 유(酉) | 17:30~19:30 | 10 |
진(辰) | 07:30~09:30 | 5 | 술(戌) | 19:30~21:30 | 11 |
사(巳) | 09:30~11:30 | 6 | 해(亥) | 21:30~23:30 | 12 |
진태양시 등 정밀 보정은 적용하지 않는 단순 시진표다(당사주 통례).
생시 미상
birth_time을 입력하지 않으면 시성(총운·평생)을 제외한 년·월·일성 3성만 반환하고 meta.time_unknown: true로 표기한다.
도구(Tools)
dangsaju_reading (주력)
입력 | 타입 | 기본값 | 설명 |
| string (YYYY-MM-DD) | (필수) | 생년월일 |
|
|
| 입력 달력 종류 |
| boolean |
| 음력 윤달 여부 ( |
| string (HH:MM) | (없음) | 출생 시각. 미입력 시 3성만 반환 |
|
|
| 방향 규칙 (기본 순행 고정) |
|
| (없음) | 변형 모드( |
출력: stars{cho,cheong,mal,summary} (각 별의 pillar·시기·지지·별명·한자·상징·총평·해당 시기 reading), 그리고 감사용 meta(방향, 음/양력 생일, 윤달 정규화, 시진 지지, 생시 미상 여부, calc_trace).
dangsaju_star_lookup (보조)
지지(한글 자해 또는 한자 子亥) 또는 별 이름(천귀성/天貴星)으로 해당 별의 원문 전체를 조회한다. 브라우징·테스트·SKILL 개발용.
설치
npm install
npm test # 픽스처 11종 검증MCP 클라이언트 등록
{
"mcpServers": {
"dangsaju": {
"command": "node",
"args": ["/absolute/path/to/mcp-dangsaju/src/index.js"]
}
}
}데이터·해설문 출처
12성 해설문은 전통 당사주 통설을 바탕으로 자체 집필(2026) 한 것이다. 데이터 구조: data/dangsaju_12stars.json — _meta(스키마 설명) + 12지지 항목(키 ja~hae) → { jiji, star, hanja, symbol, summary, cho, cheong, jang, mal }. 이 JSON이 단일 진실 출처(master)이며, 로더는 항목의 jiji 한자로 인덱싱하므로 키 스킴·_meta 유무에 견고하다.
라이선스
MIT © molpass
Available Tools
2 toolsdangsaju_reading당사주 12성 사주 조회A
생년월일시로 당사주(唐四柱) 12성(星)을 산출한다. 년성(초년)·월성(중년)·일성(말년)·시성(총운·평생)의 지지·별과 해당 시기 해설 원문을 그대로 반환한다. 세기는 inclusive, 방향은 순행 고정(남녀 동일)이 기본이며 남순여역은 변형 모드로 지원한다. 해석·조언은 생성하지 않는 데이터 전용 도구다.
| Name | Required | Description | Default |
|---|---|---|---|
| sex | No | 성별. direction=male_forward_female_backward일 때만 사용(male=순행, female=역행) | |
| calendar | No | 입력 달력 종류 (기본 solar=양력) | solar |
| direction | No | 방향 규칙. forward=순행 고정(기본). male_forward_female_backward=남순여역 변형(sex 필요) | forward |
| birth_date | Yes | 생년월일 (YYYY-MM-DD) | |
| birth_time | No | 출생 시각 (HH:MM). 미입력 시 시성(총운·평생) 제외, 년·월·일성만 반환 | |
| is_leap_month | No | 음력 윤달 여부 (calendar=lunar일 때만 유효, 평달로 정규화) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses key behaviors: inclusive counting, default forward direction for both sexes, the variant mode, and that it returns original text without generated interpretation. This is strong coverage. It could be improved by noting that omitting birth_time yields only year/month/day stars, but that detail is present in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and densely packed, with three sentences covering purpose, output, counting/direction rules, and tool type. There is no redundant or filler content, and it is front-loaded with the primary function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that no output schema exists, the description should clearly explain return values and edge cases. It mentions the four periods and what is returned, but it omits the behavior when birth_time is not provided (hour star excluded, only year/month/day returned), which is an important nuance. This leaves a gap in understanding the tool's full behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds meaningful context beyond the schema by explaining the direction parameter's two modes, specifying that sex is required only for the variant, and clarifying the tool's data-only nature. This helps the agent understand how parameters interact.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: it calculates the Dangsaju 12 stars from birth date/time and returns the branches, stars, and original explanation texts for the year, month, day, and hour periods. It also distinguishes itself from the sibling tool by emphasizing it is a data-only tool that does not generate interpretations, making its purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides context for use: it specifies the default forward direction and the male-forward/female-backward variant, and warns that it does not produce interpretations or advice, implying it is for raw data retrieval. However, it does not explicitly name the sibling tool or state when to prefer this over it, so it falls short of explicit exclusion guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
dangsaju_star_lookup당사주 별 원문 조회A
지지(자해 또는 子亥) 또는 별 이름(예: 천귀성)으로 해당 별의 원문 전체(상징·총평·시기별 해설 cho/cheong/jang/mal)를 그대로 조회한다. 브라우징·테스트·SKILL 개발용 보조 도구다.
| Name | Required | Description | Default |
|---|---|---|---|
| jiji | No | 지지 (한글 자~해 또는 한자 子~亥) | |
| star | No | 별 이름 (예: 천귀성 또는 天貴星) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description discloses key behavioral traits: it returns the full original text '그대로' (as-is), including symbolic, overall, and period-based sections. This gives the agent a clear expectation of the output's scope and nature, though edge cases like invalid inputs or both-parameter behavior are not addressed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, well-structured sentence that front-loads the main action and output, then adds context. Every phrase earns its place with no filler or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of an output schema, the description lists the output sections (상징, 총평, 시기별 해설) and the intended use case, providing sufficient context for an agent to decide when to invoke. Minor omissions such as the exact return type or error behavior prevent a perfect score, but it is complete for a simple lookup tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds meaningful semantics beyond the schema: it clarifies the 'or' relationship between jiji and star, provides example formats (Hangul and Hanja), and gives a specific example value, which helps correct usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('조회한다') and a specific resource ('별 원문 전체') to clearly state what the tool does. It also differentiates itself as a browsing/testing auxiliary tool, which implies a distinct role from the sibling dangsaju_reading.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly identifies usage contexts: browsing, testing, and SKILL development. It does not list exclusions or directly contrast with the sibling tool, but the auxiliary-tool framing gives clear guidance on when this lookup should be used instead of a full reading.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
2 tool updates
v1.0.0- First observed
dangsaju_reading - First observed
dangsaju_star_lookup
TDQS
The two tools have clearly distinct purposes: one computes a full Dangsaju reading from birth date/time, while the other looks up static star information by branch or name. No overlap in intended use cases, making misselection unlikely.
Both tool names share the consistent prefix 'dangsaju_' and use snake_case with descriptive suffixes ('reading', 'star_lookup'). This creates a predictable and uniform naming pattern.
With only two tools, the server is minimal, but the specialized domain of Dangsaju fortune-telling makes this count reasonable. It falls on the borderline of being too thin for broader use.
The core workflow of generating a Dangsaju reading is fully covered, and the lookup tool supports verification and exploration. A minor gap is the lack of a way to list all stars or batch queries, but the existing surface is functional.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Korean Four Pillars (Saju/BaZi) calculator: pillars, elements, ten gods, sinsal, luck cycles.
Deterministic Korean Saju / BaZi Four Pillars MCP. Day Master, five elements, compatibility.
BaZi four pillars, Chinese zodiac, lunisolar calendar and almanac days for AI agents.
BaZi (Chinese Four Pillars) chart calculator. Structured chart data only, no predictions.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceCalculates Chinese BaZi (Four Pillars of Destiny) charts based on birth date, time, and location, including solar term information, decade luck cycles, and true solar time corrections.2-

OpenFate Bazi MCPofficial
AlicenseAqualityAmaintenanceEnables AI agents to calculate deterministic Bazi (Four Pillars) charts with True Solar Time and Earthly Branch interactions, avoiding LLM hallucination of calendrical math.6161140MIT- AlicenseAqualityCmaintenanceCalculates and returns a Ziwei Doushu (Purple Star Astrology) chart based on birth date, time, and gender. Returns both structured text of the 12 palaces and a PNG image of the chart.1MIT
- AlicenseAqualityBmaintenanceCalculates Tojeongbigyul (토정비결) fortune for a given birth date and year, returning total fortune and monthly forecasts based on traditional Korean divination methods.2MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/molpass/mcp-dangsaju'
If you have feedback or need assistance with the MCP directory API, please join our Discord server