Bazi MCP

Bazi MCP

cantian_ai
GitHubnpm

About

Bazi MCP (八字 MCP) by Cantian AI delivers precise Bazi (Chinese Four Pillars of Destiny) calculations and Chinese calendar information for AI agents. Built to address inaccuracies in existing AI fortune-telling tools, this MCP provides reliable data for personality analysis, destiny forecasting, and traditional Chinese metaphysics applications.

Features

  • Accurate Bazi Calculations: Provides comprehensive Bazi chart information including Heavenly Stems, Earthly Branches, Ten Gods, Five Elements, Nayin, and more
  • Fortune Analysis: Calculates 10-year fortune cycles (大运) with detailed breakdown by age ranges
  • Multiple Calendar Systems: Supports both solar and lunar calendar inputs
  • Chinese Calendar: Retrieves traditional almanac information including auspicious/inauspicious activities
  • Reverse Lookup: Find possible birth dates from a given Bazi chart
  • No API Keys Required: Runs locally without external dependencies

Tools

getBaziDetail

Calculate comprehensive Bazi information based on solar or lunar datetime. Returns the full Four Pillars chart with:

  • Eight Characters (八字) with Heavenly Stems and Earthly Branches
  • Ten Gods (十神) relationships
  • Five Elements analysis
  • Hidden Stems (藏干)
  • Nayin (纳音) elements
  • Stellar fortune positions
  • Divine beings and auspicious/inauspicious stars (神煞)
  • 10-year fortune cycles (大运)
  • Relationships and interactions between pillars (刑冲合会)

getSolarTimes

Reverse lookup: given a Bazi string (e.g., "戊寅 己未 己卯 辛未"), returns a list of possible solar calendar birth dates that match those Four Pillars.

getChineseCalendar

Retrieve traditional Chinese almanac (黄历) information for a specified date, including:

  • Lunar calendar date
  • Heavenly Stems and Earthly Branches for the day
  • Solar terms (节气)
  • 28 Mansions (二十八宿)
  • Auspicious directions for gods of wealth, fortune, and happiness
  • Suitable and unsuitable activities for the day
  • Zodiac conflicts

Prerequisites

Requires Node.js 22 or above.

Usage

Originates from the popular Chinese Bazi Fortune Teller GPT in the GPT Store, now integrated with Cantian AI platform (cantian.ai).