MCP
Language models easily get it wrong when they build a BaZi chart, set up a Liu Yao hexagram or work out which day carries which stem and branch on their own. Zhiming exposes these calculations as an MCP server. Once connected, Claude and other AI assistants can call Zhiming’s chart engine directly, get accurate chart data, and then do the interpreting.
Server URL
https://app.example.com/mcpTransport is Streamable HTTP, with no authentication.
Tools
| Tool | Description |
|---|---|
| bazi_chart BaZi chart | From a birth time: Four Pillars, Ten Gods of the stems, hidden stems, twelve life stages, Na Yin, clashes and combinations in the chart, the solar terms around birth, when luck cycles start, luck cycles and this year, and symbolic stars for each pillar. Supports true solar time from birthplace longitude, lunar-calendar input and unknown birth hour. |
| liuyao_cast Liu Yao hexagram | Primary and changed hexagrams, palace with Self and Other lines, Na Jia with Six Relations and Six Spirits, hidden spirits, day void and day stars; for each line, its strength against the month and day, interactions, hidden movement and day break, life stages, what moving lines transform into and how they act on other lines, the Self–Other relationship, and triple combinations and punishments. Pass in the lines you cast yourself, or let the program simulate a three-coin toss. |
| ganzhi_calendar Stem-branch calendar | The stem and branch of each day for up to 120 days from a given date, plus the exact times of the next 3 solar terms. Use it to work out timing or to check which date a given stem-branch day falls on. |
Tool output is in Chinese, using standard Chinese metaphysics terms; your assistant can translate and explain it.
How to connect
Claude Code: run in your terminal
claude mcp add --transport http zhiming https://app.example.com/mcpClaude on the web and desktop: add a custom connector in connector settings with the server URL above.
Other clients that support remote MCP: add it the way your client is configured; a common format is:
{
"mcpServers": {
"zhiming": { "url": "https://app.example.com/mcp" }
}
}Things to ask
- “Build the BaZi chart for a man born at 4:18 am on 23 December 1994 and tell me how strong the Day Master is.”
- “From bottom to top I cast 6 8 7 8 8 7, asking whether I’ll pass this interview. Set up the hexagram and analyze it.”
- “The reading says it will happen on an Ox (丑) day. Which days in the next month are Ox days?”
Notes
- All times are in Beijing time (UTC+8); charts and hexagrams switch to the next day at 23:00;
- The tools return only objective, computed data. Strength, structure, key elements and judgments are up to the AI you use and may contain errors or inconsistencies;
- To keep the service stable, each IP can make up to 30 calls per minute;
- For full chart readings, timing rhythms, AI hexagram readings and a question journal, try the Zhiming app.
Data and privacy
The MCP server needs no account and doesn’t keep the birth information, questions or hexagrams you submit — they’re discarded once computed and never written to logs. The server keeps only ordinary access logs (such as IP address and request time) for rate limiting and security. See our Privacy Policy.
About the content
Zhiming’s content is based on traditional culture and is for life-planning reference only. It is not a definitive statement about the future and is not medical, legal, investment or other professional advice. Use means you agree to our Terms of Service.