fortuneteller

Overview

This MCP server provides comprehensive Korean traditional fortune-telling capabilities based on Saju (Four Pillars of Destiny). It offers 7 integrated tools for calculating and analyzing birth charts, fortune analysis, compatibility checking, calendar conversion, and daily fortune predictions. The server uses local lunar calendar data for 1900-2200 and includes advanced features like Yong-sin (用神) analysis and special stars (神殺) detection. The implementation is well-structured with TypeScript, includes proper error handling with Zod validation, and is optimized for token efficiency.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• analyze_saju

  Analyze saju (Four Pillars of Destiny) with various types including basic calculation, fortune analysis, and yongsin evaluation

  Try:Analyze my saju with birth date 1990-03-15 at 10:30Try:Tell me about my career fortune based on my birth informationTry:Compare different schools of saju interpretation for my birth chart
• check_compatibility

  Analyze compatibility between two people's saju charts

  Try:Check compatibility between me (1990-03-15, male) and my partner (1992-07-20, female)Try:How compatible are these two birth charts?
• convert_calendar

  Convert between solar and lunar calendars (1900-2200)

  Try:Convert 2025-01-01 from solar to lunar calendarTry:What is the solar date for the first day of the 3rd lunar month in 2025?
• get_daily_fortune

  Get daily fortune for a specific date based on saju

  Try:What's my fortune for January 1st, 2025?Try:Tell me about today's luck based on my saju
• get_dae_un

  Get 10-year major fortune cycles (Dae-un) based on saju

  Try:What is my current 10-year fortune cycle?Try:When will my next major fortune cycle begin?
• get_fortune_by_period

  Get fortune analysis for different time periods (yearly, monthly, hourly, multi-year)

  Try:What's my fortune for the next 5 years?Try:Tell me about my monthly fortune for March 2025Try:How will my luck be this afternoon?
• manage_settings

  Manage interpretation settings for saju analysis

  Try:Set my saju analysis preference to balanced modeTry:Check my current saju interpretation settings

Comparable tools

Installation

curl -fsSL https://raw.githubusercontent.com/hjsh200219/fortuneteller/main/install.sh | bash

npm install -g @hoshin/saju-mcp-server

npx @hoshin/saju-mcp-server

{
  "mcpServers": {
    "saju": {
      "command": "npx",
      "args": ["-y", "@hoshin/saju-mcp-server"]
    }
  }
}

FAQ

What is Saju (Four Pillars of Destiny)?

Saju is a traditional Korean fortune-telling system that analyzes a person's fate and characteristics based on their birth date and time, represented by eight characters.

Does this support both lunar and solar calendar dates?

Yes, it includes full support for converting between lunar and solar calendars from 1900-2200, with proper leap month handling.

How does the Yong-sin (用神) analysis work?

The Yong-sin analysis identifies the beneficial element in a person's chart that helps balance the five elements, providing guidance on colors, directions, and suitable careers.

Compare fortuneteller with