Chinese Fortune

You can use the Chinese Fortune Analysis System MCP to convert birth data into BaZi pillars, analyze the Five Elements, deduce the Ten Gods relationships, and generate destiny interpretations. It provides practical insights for traditional fortune-telling applications, prediction platforms, and related SaaS products by turning birth information into structured metaphysical analyses.

How to use

Start the MCP service locally and interact with it through an MCP client. You can obtain BaZi pillars (Year, Month, Day, Hour) from a birth date, analyze element balance, derive Ten Gods relationships to the Day Master, and generate interpretations of strength, favorable elements, luck cycles, and yearly fortunes. The service is designed to be invoked as a modular component in your fortune-telling workflow, enabling you to build features like personalized readings, age- and year-name labeling, and extended modules such as Ziwei Doushu or Ming Gong.

What you can accomplish with the MCP service

• Generate Four Pillars (BaZi) from a birth date
• Compute Five Element balance (Wood, Fire, Earth, Metal, Water)
• Derive Ten Gods relationships relative to the Day Master
• Interpret destiny with factors like strength, Yong Shen (favorable elements), Da Yun (luck cycles), and Liu Nian (annual fortune)
• Calculate Chinese age and stem-branch year names (e.g., Wu Zi Year)
• Explore extended modules such as Ziwei Doushu, Shen Sha (Auspicious Spirits), Ming Gong (Life Palace), Shen Gong (Body Palace)

Using the MCP in practice

Run the MCP service via the provided command to start the local server, then connect with your MCP client to submit birth data and retrieve the readings. Build your UI around the returned pillars, element analysis, and fortune interpretations to present users with structured, interpretable results.

Available tools

BaZiGeneration

Converts birth date into Heavenly Stems and Earthly Branches for Year, Month, Day, and Hour.

FiveElementAnalysis

Calculates the balance of Wood, Fire, Earth, Metal, and Water elements.

TenGodsDeduction

Derives relationships of each stem to the Day Master (Ri Zhu) to support personalized readings.

DestinyInterpretation

Analyzes Day Master strength, Yong Shen, Da Yun luck cycles, and Liu Nian annual fortune.

ChineseAgeStemBranch

Calculates Chinese virtual age and names the birth year with stem-branch notation.

ExtendedModules

Supports extended modules such as Ziwei Doushu, Shen Sha, Ming Gong, and Shen Gong for deeper readings.