# Cafe MCP

> Cafe MCP is a freemium MCP server for astrology. Computed Saju and BaZi Four Pillars charts, luck cycles and classics for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://24plus.ai.kr/mcp
- **Repository:** https://github.com/dangamsoft/cafe-mcp
- **MCP Registry name:** io.github.dangamsoft/cafe-mcp
- **Categories:** astrology
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.24plus.ai.kr/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cafe-mcp": {
      "url": "https://mcp.24plus.ai.kr/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/cafe-mcp
