Skip to content
MCP server

Cafe MCP

Computed Saju and BaZi Four Pillars charts, luck cycles and classics for AI assistants

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.1.0
Listing updated
2 days ago

About Cafe MCP

Cafe MCP is a freemium MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

The premise is that language models often miscalculate Four Pillars charts, so the CAFE engine, developed since 2019, does the arithmetic and the assistant only explains it. The engine works out solar terms to the second, corrects for birthplace longitude and applies historical time zones and daylight saving. The same input always gives the same chart.

Nine read-only tools cover charts with Ten Gods, hidden stems, twelve life stages, stars, combinations and clashes; ten-year luck cycles with yearly and monthly pillars; a ready-made reading context bundle; a manseryeok calendar with solar and lunar dates; reverse lookup of dates from pillars; birthplace search; a 980-term glossary in Korean, Hanja and English; and excerpts from classics such as Ziping Zhenquan. Results come in Korean with Hanja, with English term names available.

The server is free with a 24PLUS account, and includes 10 charts and 300 tool calls a month on the free plan. Judgments such as useful element, chart structure and fortune readings are not in the public tools and require a business agreement. Birth data is used only for the calculation, with a one-way fingerprint kept to count the monthly limit.

Install

Run in a terminal

claude mcp add --transport http cafe-mcp https://mcp.24plus.ai.kr/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.24plus.ai.kr/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cafe-mcp": {
      "url": "https://mcp.24plus.ai.kr/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cafe-mcp": {
      "serverUrl": "https://mcp.24plus.ai.kr/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

saju_chart
Returns Four Pillars with elements, Ten Gods, hidden stems and stars.
luck_cycles
Returns ten-year cycles with yearly and monthly pillars.
saju_reading_context
Returns chart facts and reading principles as one bundle.
manse_calendar
Returns a month of solar and lunar dates and solar-term times.
find_dates_by_pillars
Finds dates and times that produce given pillars.
find_birthplace
Searches cities for longitude correction.
lookup_term
Looks up Saju terms in Korean, Hanja and English.
search_classics
Searches classical texts with translation excerpts.
read_classic
Lists the library and each book's table of contents.

What it does

Deterministic charts
Same birth data always returns the same Four Pillars chart.
Luck cycles
Ten-year cycles with yearly and monthly pillars.
Manseryeok calendar
A month of solar and lunar dates, day pillars and solar-term times.
Reading context bundle
One call gives chart facts, current luck and principles for an assistant.
Classics and glossary
Search classical texts and 980 Saju terms.
Birthplace correction
Find a city's longitude for births outside Korea.

Good for

  • Get a reliable Four Pillars chart before an AI interprets it
  • Look up the luck cycle for a given year
  • Find dates that produce a set of pillars
  • Search a classical text for a concept
  • Build a Saju widget or bot with an AI coding assistant

Pricing

Freemium

Free with account: 300 calls and 10 charts per month; Business by agreement

Prices change. Check 24plus.ai.kr before you buy.

Cafe MCP FAQ

Is it free?

Yes with a 24PLUS account: 10 different charts and 300 tool calls per month. A business plan is by agreement.

Is my birth data stored?

No. It is used only for the calculation, and a one-way fingerprint is kept to count the monthly limit.

How do I connect?

Add https://mcp.24plus.ai.kr/mcp as a connector and sign in, or use a key created on the 24PLUS site as a Bearer token.

What does it not include?

Engine judgments like useful element, chart structure and personality readings, which need the paid CAFE Core API.

Is Cafe MCP free?

Cafe MCP has a free plan, with paid plans for more usage or features.

How do I add Cafe MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http cafe-mcp https://mcp.24plus.ai.kr/mcp

What are the best alternatives to Cafe MCP?

The closest alternatives to Cafe MCP are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

Alternatives to Cafe MCP

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments