Skip to main content
Glama

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.

Remote Auth Version License

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/mcp

claude.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

saju_chart

Four pillars with Hanja, Five Elements, Ten Gods, hidden stems, twelve life stages, stars, combinations, clashes and void

luck_cycles

Ten-year cycles with start ages, yearly and monthly pillars

saju_reading_context

Chart facts, current luck, term meanings and reading principles in one prompt-ready bundle. The best first call for a reading

manse_calendar

A month of solar and lunar dates, day pillars, exact solar-term times, auspicious days

find_dates_by_pillars

Reverse lookup: the dates and times that produce given pillars

find_birthplace

City search for longitude correction (births outside Korea)

lookup_term

980 Saju terms in Korean, Hanja and English

search_classics

Ziping Zhenquan, Ditian Sui, Qiongtong Baojian and more, original with a Korean translation excerpt

read_classic

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 tools
eumyang_johuYin-Yang and climate balanceA
Read-onlyIdempotent
Inspect

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 (格局)A
Read-onlyIdempotent
Inspect

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)A
Read-onlyIdempotent
Inspect

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 balanceA
Read-onlyIdempotent
Inspect

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 chartA
Read-onlyIdempotent
Inspect

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 candidatesA
Read-onlyIdempotent
Inspect

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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      2
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to compute and interpret Korean Four Pillars of Destiny (Saju) through natural language, including calculation, interpretation, compatibility analysis, and daily fortune.
      4
      33 npm
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides local, deterministic Four Pillars (Bazi) chart calculation via MCP tools, with JSON and PNG outputs, no API key or network required.
      96 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Seven deterministic I Ching (Book of Changes) and Zi Wei Dou Shu astrology tools via remote Streamable HTTP MCP or npm stdio.
      18 npm
      1
      MIT