cafe-mcp
cafe-mcp is a read-only MCP server for deterministic Korean Saju/Chinese BaZi chart calculation and calendar data, leaving interpretation to the AI client.
Generate Four Pillars (四柱八字) natal charts with stems/branches, Ten Gods, hidden stems, five-element ratios, spirit stars, and twelve life stages.
Analyze five-element balance, chart structure (格局), yin-yang/climate balance, and classical favorable-element (用神) candidates.
Provide manse-ryeok (萬歲曆) calendar data: day/month/year pillars, lunar dates, exact solar-term times, and auspicious-day flags.
Per the README, also compute luck cycles, reverse-lookup dates by pillars, find birthplaces, look up Saju terms, and search/read classical texts (the provided schema lists only six of these tools).
Use OAuth or a bearer key; free tier has monthly chart/tool-call limits; outputs are structured and reproducible.
cafe-mcp: Saju & BaZi (Four Pillars of Destiny) MCP server
Korean astrology (Saju, 사주) and Chinese BaZi (八字) for AI agents. Computed, not guessed. Give Claude, ChatGPT, Cursor or any MCP client a birth date and time. cafe-mcp returns the Four Pillars chart, luck cycles, a manseryeok (만세력) calendar and the classical texts as structured, reproducible data from the CAFE engine. Your AI writes the reading in the user's language.
Why not just ask the LLM? A general model improvises the chart: the same birth data gives a different Day Master on different days, and solar-term boundaries, hidden stems and luck cycles are routinely wrong. cafe-mcp calculates them with an engine built since 2019: solar terms to the second, birthplace longitude, historical time zones and daylight saving. Same input, same chart, every time.
Quick start
Server URL:
https://mcp.24plus.ai.kr/mcpclaude.ai, Claude apps, ChatGPT: add a custom connector with the URL above, sign in to 24PLUS, then allow. No key needed.
Claude Code, Cursor and other clients: either add the URL and sign in (OAuth), or create a key at https://24plus.ai.kr/my and send it as a bearer token:
claude mcp add --transport http cafe-mcp https://mcp.24plus.ai.kr/mcp --header "Authorization: Bearer mcp_live_..."{ "mcpServers": { "cafe-mcp": { "url": "https://mcp.24plus.ai.kr/mcp", "headers": { "Authorization": "Bearer mcp_live_..." } } } }Disconnect any time from My account > Connected AI.
Related MCP server: Saju MCP Server
Plans
cafe-mcp is free with a 24PLUS account.
Free | Business | |
Different charts per month | 10 | by agreement |
Tool calls per month | 300 | by agreement |
Calls per minute | 20 | by agreement |
Tools | the 9 tools below | CAFE Core API |
Engine judgments (useful element, chart structure, luck index, personality, compatibility, fortune) | – | ✓ |
Classics | 3 results, translation excerpt, table of contents | full translation, full chapters |
A chart you have already looked up does not count again. Engine judgments and use inside your own product go through the CAFE Core API under a business agreement: https://24plus.ai.kr/mcp#business
Tools
The server lists 9 read-only tools, all free.
Tool | What it does |
| Four pillars with Hanja, Five Elements, Ten Gods, hidden stems, twelve life stages, stars, combinations, clashes and void |
| Ten-year cycles with start ages, yearly and monthly pillars |
| Chart facts, current luck, term meanings and reading principles in one prompt-ready bundle. The best first call for a reading |
| A month of solar and lunar dates, day pillars, exact solar-term times, auspicious days |
| Reverse lookup: the dates and times that produce given pillars |
| City search for longitude correction (births outside Korea) |
| 980 Saju terms in Korean, Hanja and English |
| Ziping Zhenquan, Ditian Sui, Qiongtong Baojian and more, original with a Korean translation excerpt |
| The library and each book's table of contents |
Full reference with inputs and example prompts: https://24plus.ai.kr/docs/tools
About the useful element
The useful element (yongshin) and other engine judgments are not part of the public tools; they are available through the CAFE Core API under a business agreement.
Values come back in Korean with Hanja; pass lang="en" for English term names.
Principles
Calculation is deterministic; interpretation is left to your AI, grounded in the returned data.
No scores, grades or fixed predictions.
Birth data is used only for the calculation. The server keeps a one-way fingerprint for the monthly chart count, never the birth date itself. See PRIVACY.md.
The old local npx wrapper (
npx @dangamsoft/cafe-mcp) does not calculate on your machine either: it sends the birth date, time and sex to the 24PLUS server to compute the chart.
Before v1.1.0
Until 2026-10-18 this URL served an open server with six tools and no sign-in, and the npm package
@dangamsoft/cafe-mcp ran it locally over stdio. Both are retired; the npm package is deprecated.
See CHANGELOG.md.
About
cafe-mcp is run by 24PLUS (Dangamsoft, Korea), built on the CAFE engine. Website: https://24plus.ai.kr · Business API (Core API): https://24plus.ai.kr/mcp#business
License: Apache-2.0 for the code in this repository.
Available Tools
6 toolseumyang_johuYin-Yang and climate balanceARead-onlyIdempotentInspect
Yin-Yang (陰陽) ratio and climate (調候: hot/cold, dry/wet) balance, and how they shift across 10-year and yearly luck cycles. Use for 'is my chart hot or cold', '조후 분석'.
Inputs: birth (required), loc, sex, name, +11 more. Returns: data, tool, basis, links, +4 more
gyeokgukChart structure (格局)ARead-onlyIdempotentInspect
Gyeokguk (格局) chart structure by classical rules: named pattern and grade, body strength (strong/weak), sub-patterns, and the elements behind the judgment. Use for 'what is my chart pattern', '내 격국'.
Inputs: birth (required), loc, sex, name, +11 more. Returns: data, tool, basis, links, +4 more
manse_calendarManse-ryeok calendar (day pillars)ARead-onlyIdempotentInspect
Korean manse-ryeok (萬歲曆) calendar for a month or a single day: each day's pillar (日辰), month and year pillars, lunar date, solar term (節氣) with its exact start time (Korea time) when one falls on that day, 손없는날 and 황도일 flags. No birth data needed. Use for 'what is today's day pillar', '이번 달 손없는날', '2027년 2월 일진'.
Inputs: date, month. Returns: days, tool, links, month, +3 more
ohaeng_balanceFive Elements balanceARead-onlyIdempotentInspect
Five Elements (五行: Wood, Fire, Earth, Metal, Water) distribution with hidden-stem weighting; dominant and weakest element. Use for 'which element am I missing', '오행 분석'.
Inputs: birth (required), loc, sex, name, +11 more. Returns: data, tool, basis, links, +4 more
saju_chartSaju / BaZi natal chartARead-onlyIdempotentInspect
Four Pillars (四柱八字) natal chart: year/month/day/hour stems and branches, Ten Gods (十神), hidden stems, five-element ratios, Spirit Stars (神殺) and Twelve Life Stages (十二運星) per pillar. The foundation other tools build on. Use for 'show my saju / bazi chart', '내 사주 봐줘'.
Inputs: birth (required), loc, sex, name, +11 more. Returns: data, tool, basis, links, +4 more
yongshin_candidatesFavorable element candidatesARead-onlyIdempotentInspect
Classical Yongshin (用神, favorable element) candidates from five methods (Eokbu, Byeongyak, Tonggwan, Johu, Gyeokguk) with each method's pick. No final engine decision. Use for 'my favorable element candidates', '용신 후보'.
Inputs: birth (required), loc, sex, name, +11 more. Returns: data, tool, basis, links, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct aspect of saju analysis: natal chart, five elements, chart pattern, yin-yang/climate, favorable element candidates, and calendar. There is no overlap in purpose, and descriptions clearly differentiate them.
All tool names use snake_case with consistent lowercase styling, and they follow a predictable noun-based pattern (e.g., saju_chart, ohaeng_balance). No mixing of conventions or verb styles.
Six tools is well-scoped for a specialized saju analysis server. Each tool earns its place by covering a distinct analytical layer, with no redundancy or bloat.
Core chart analysis is well-covered, including natal chart, elements, pattern, climate, and favorable elements. However, advanced analyses like dedicated 10-year luck cycle (daeun) interpretation or compatibility (gunghap) are missing, leaving minor gaps.
Maintenance
Related MCP Connectors
Korean Four Pillars (Saju/BaZi) calculator: pillars, elements, ten gods, sinsal, luck cycles.
Korean Saju (Four Pillars) calculator: birth chart, day pillar, luck flow, monthly fortune
Deterministic Korean Saju / BaZi Four Pillars MCP. Day Master, five elements, compatibility.
Free BaZi, I Ching, tarot, Zi Wei and bilingual learning tools with transparent methods. No API key.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides tools for Bazi (Chinese astrology) chart calculation and analysis, enabling LLMs to generate accurate birth charts, determine patterns, and answer follow-up questions based on actual calculations rather than model knowledge.2MIT
- FlicenseAqualityCmaintenanceEnables MCP clients to compute and interpret Korean Four Pillars of Destiny (Saju) through natural language, including calculation, interpretation, compatibility analysis, and daily fortune.433 npm-
- AlicenseNot gradedqualityCmaintenanceProvides local, deterministic Four Pillars (Bazi) chart calculation via MCP tools, with JSON and PNG outputs, no API key or network required.96 npm2MIT
- AlicenseNot gradedqualityCmaintenanceSeven deterministic I Ching (Book of Changes) and Zi Wei Dou Shu astrology tools via remote Streamable HTTP MCP or npm stdio.18 npm1MIT