# Saju Insights

Saju Insights — an MCP server for Saju readings from birth data, period forecasts, compatibility checks, and solar-lunar date conversion.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 5994 installs · ★ 43 repo stars
- Author: hjsh200219
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hjsh200219/fortuneteller
- Updated: 2026-09-23
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/saju-insights

## What it does

Saju Insights takes a person’s birth date, time, calendar type, and gender to calculate the Four Pillars. Its analysis covers general, career, wealth, health, and love readings. Separate tools compare two people, convert solar and lunar dates, return daily readings, and show ten-year luck cycles.

The server exposes seven MCP tools: `analyze_saju`, `check_compatibility`, `convert_calendar`, `get_daily_fortune`, `get_dae_un`, `get_fortune_by_period`, and `manage_settings`. Settings can use a preset or custom weights for interpretation schools. Calendar conversion covers 1900-2200 and handles leap months.

A local setup requires Node.js 18 or later plus npm, yarn, or pnpm. Without Node.js 18 or later, the local server will not run. The supplied HTTP connection can be added to Claude Code, Codex, Cursor, GitHub Copilot, or Gemini CLI.

## Requirements
- Remote server: `https://fortuneteller--hjsh200219.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http fortuneteller https://fortuneteller--hjsh200219.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add saju-insights --url https://fortuneteller--hjsh200219.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "saju-insights": {
            "url": "https://fortuneteller--hjsh200219.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "saju-insights": {
            "type": "http",
            "url": "https://fortuneteller--hjsh200219.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http saju-insights https://fortuneteller--hjsh200219.run.tools
```

## When to use it
- calculate a Saju chart from birth details
- read daily or period-based fortunes
- compare two people for compatibility
- convert a date between solar and lunar calendars
- change the interpretation method or weighting

## Example prompts
- Calculate my Saju from birth date 1990-03-15, time 10:30, and the solar calendar.
- Compare the compatibility of two people using their birth dates and times.
- Give me the reading for 2025-01-01 and include guidance on colors, directions, and careers.

## Similar
- [entertainment](https://affpapa.org/en/nevibecode/skills/entertainment.md) — skill · 102 installs
- [SAJU (Korean Fortune Teller)](https://affpapa.org/en/nevibecode/mcp/saju-korean-fortune-teller.md) — MCP server · 1338 installs
- [ce-compound-refresh](https://affpapa.org/en/nevibecode/skills/ce-compound-refresh.md) — skill · 3500 installs
- [insights-advisor](https://affpapa.org/en/nevibecode/agents/insights-advisor.md) — subagent · ★ 1198 repo stars
- [ccam-insights](https://affpapa.org/en/nevibecode/plugins/ccam-insights.md) — plugin · ★ 1198 repo stars
- [alpha-insights](https://affpapa.org/en/nevibecode/skills/alpha-insights.md) — skill · ★ 74 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
