Cafe Mcp

io.github.dangamsoftPublished by GitHub account dangamsoftv1.1.0Updated Nov 8, 2026

Saju & BaZi (Four Pillars) charts, luck cycles, manseryeok and classics. Free with sign-in.

VerifiedStreamable HTTPWeb executableLocation & LifestyleKnowledge & Memory

Overview

AI-generated overview

Remote MCP server that computes Saju and BaZi (Four Pillars) charts, luck cycles and manseryeok calendars from birth data for AI readings.

What you can do
  • Compute Four Pillars charts with Five Elements, Ten Gods, hidden stems and life stages
  • Derive ten-year luck cycles with yearly and monthly pillars, plus a prompt-ready reading bundle
  • Build monthly solar/lunar calendars with exact solar-term times and auspicious days
  • Reverse-look up dates from given pillars and find birthplaces for longitude correction
  • Look up Saju terms and search or browse classical texts with Korean translation excerpts
When to use it
Use it when an assistant should produce Saju or BaZi readings grounded in deterministic chart data rather than improvised calculations, or when you need manseryeok calendar dates, solar-term times or classical text references.
Requirements
Remote streamable HTTP endpoint; a 24PLUS account with OAuth sign-in, or a bearer token created in the account area. No local runtime or environment variables. Free plan limited to 10 distinct charts and 300 tool calls per month, 20 calls per minute.
Before you install
Requires sign-in and sends birth date, time and sex to the 24PLUS server for calculation; the server says it keeps only a one-way fingerprint, not the birth date. A bearer token is a credential to protect. Free plan has monthly chart and call limits; engine judgments and product use require a paid business agreement.

Installation

In SourceWeft

  1. Open Cafe Mcp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dangamsoft%2Fcafe-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "cafe": {
      "type": "http",
      "url": "https://mcp.24plus.ai.kr/mcp"
    }
  }
}

README

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:

bash
claude mcp add --transport http cafe-mcp https://mcp.24plus.ai.kr/mcp --header "Authorization: Bearer mcp_live_..."
json
{ "mcpServers": { "cafe-mcp": { "url": "https://mcp.24plus.ai.kr/mcp", "headers": { "Authorization": "Bearer mcp_live_..." } } } }

Disconnect any time from My account > Connected AI.

Plans

cafe-mcp is free with a 24PLUS account.

FreeBusiness
Different charts per month10by agreement
Tool calls per month300by agreement
Calls per minute20by agreement
Toolsthe 9 tools belowCAFE Core API
Engine judgments (useful element, chart structure, luck index, personality, compatibility, fortune)–✓
Classics3 results, translation excerpt, table of contentsfull 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.

ToolWhat it does
saju_chartFour pillars with Hanja, Five Elements, Ten Gods, hidden stems, twelve life stages, stars, combinations, clashes and void
luck_cyclesTen-year cycles with start ages, yearly and monthly pillars
saju_reading_contextChart facts, current luck, term meanings and reading principles in one prompt-ready bundle. The best first call for a reading
manse_calendarA month of solar and lunar dates, day pillars, exact solar-term times, auspicious days
find_dates_by_pillarsReverse lookup: the dates and times that produce given pillars
find_birthplaceCity search for longitude correction (births outside Korea)
lookup_term980 Saju terms in Korean, Hanja and English
search_classicsZiping Zhenquan, Ditian Sui, Qiongtong Baojian and more, original with a Korean translation excerpt
read_classicThe library and each book's table of contents

Full reference with inputs and example prompts: https://24plus.ai.kr/docs/tools

About the engine's useful element judgment

The useful element (yongshin) is not part of the public tools; it is available through the CAFE Core API. CAFE looks at a chart from several classical methods (eokbu/support, johu/climate, byeongyak/illness-remedy, tonggwan/mediation, gyeokguk/structure including jonggyeok/following), and a model trained on classical and real consultation cases picks among their candidates.

Useful/favorable-element agreement (희용신 일치율): 75%. On charts not used in training, the expert's useful element is within the useful/favorable pair CAFE gives for 75% of charts; for the single useful element alone it is 56% (cross-validated, 2026-10-10).

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.

Source: README.md at commit 9a9381c

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

3
  1. v1.1.0LatestOct 18, 2026
  2. v1.0.1Sep 27, 2026
  3. v0.6.4Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts