Deterministic first
Pillars, solar terms, palaces, stars, and hexagrams are computed in code—not guessed by a language model.
Official open-source MCP by BaziWei
Let AI find the meaning. Let Mingpan get the chart right.
A deterministic Chinese metaphysics calculator built for AI agents. It computes solar terms, pillars, palaces, stars, and divination charts so the model can focus on understanding, reasoning, and expression.
No install or account required. Connect from any client that supports Remote MCP / Streamable HTTP.
18
MCP tools
6
metaphysics and divination systems
1900–2100
primary year range
Apache-2.0
open-source license
Why Mingpan
Put calculation and interpretation where each belongs
Mingpan is not another fortune-telling bot. It supplies reproducible chart facts and leaves contextual, human interpretation to the AI you choose.
Privacy by architecture
The official service is stateless and does not store or cache birth inputs or chart results.
Open and auditable
Source, dependencies, and tests are public so developers and researchers can inspect the calculation conventions.
18 Tools · One Endpoint
Natal charts, timing cycles, and divination through one endpoint
Every tool returns structured text designed for AI consumption. Mingpan deliberately avoids fortune scores, pattern verdicts, and life conclusions.
5 tools
BaZi
Four pillars, ten gods, hidden stems, na yin, growth stages, decade luck, and annual, monthly, and daily cycles.
6 tools
Zi Wei Dou Shu
Twelve palaces, major and auxiliary stars, four transformations, five-element bureau, and multi-level timing cycles.
1 tool
LiuYao
Primary and transformed hexagrams, Najia, six relatives, six spirits, host/guest lines, void, and hidden spirits.
1 tool
MeiHua YiShu
Time- or number-based casting with primary, mutual, transformed hexagrams and body–function relations.
1 tool
Da Liu Ren
Derives calendar primitives from Gregorian time and returns the heaven–earth plate, four lessons, three transmissions, and generals.
2 tools
Qi Men Dun Jia
Multiple chart styles and intercalation methods, with the nine-palace chart and deterministic yong-shen facts by subject.
Plus 2 calendar primitives: precise times for the 24 solar terms and Gregorian–lunar conversion.
Connect
Give your AI reliable charts in three steps
No package download or server maintenance. If your AI client supports Remote MCP, you can use the official service directly.
- 1
Open the MCP or Connectors settings in your AI client.
- 2
Add a remote service and paste the official MCP endpoint shown here.
- 3
Provide the time, gender, or casting data in natural language and ask the AI to use Mingpan.
Official service endpoint
https://mingpan.bzwai.com/mcp
The official service is currently free. Please use it fairly; interfaces and quota policies may evolve as the service matures.
Prompt Ideas
Try these after connecting
- Use Mingpan to calculate a BaZi chart for a male born on April 12, 1992 at 07:30, then interpret the resulting chart.
- Find the exact time of LiChun in 2027 and explain whether it changes the year pillar for this birth chart.
- Cast a Qi Men Dun Jia hourly chart for June 21, 2024 at 10:00. List the computed facts before interpreting them.
Mingpan × BaziWei
Mingpan computes the chart. BaziWei completes the experience.
Mingpan is an independent, open-source calculation foundation. BaziWei connects subject management, BaZi and Zi Wei, AI readings, calendars, and sharing into a complete product. They complement each other without forcing the same school of interpretation.