Bazi MCP (八字 MCP)
AI-powered Bazi (Chinese Four Pillars) calculator for accurate destiny and personality data.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claudePaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"bazi-mcp-mcp": {
"command": "npx",
"args": [
"bazi-mcp"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js 22 or above
About Bazi MCP (八字 MCP)
Bazi MCP is the first AI-powered Bazi (八字 / Chinese Four Pillars of Destiny) calculator delivered as an MCP server. It gives AI agents accurate Bazi chart data — pillars, hidden stems, ten gods, na yin, fortune-luck cycles (大运), shensha (神煞), and clash/combine relationships — plus reverse Bazi-to-date lookup and Chinese almanac (黄历) information. It is designed to fix the chart-casting errors that general-purpose LLMs frequently make for Chinese metaphysics tasks.
Tools & capabilities (3)
getBaziDetailCalculate full Bazi (Four Pillars) results from a solar or lunar datetime. Args: solarDatetime (ISO, e.g. 2000-05-15T12:00:00+08:00), lunarDatetime (e.g. 2000-05-15 12:00:00), gender (0=female, 1=male; default 1), eightCharProviderSect (1 or 2; controls whether the 23:00-23:59 day stem belongs to tomorrow or today; default 2). Returns pillars with stems/branches, five elements, ten gods, hidden stems, na yin, void (空亡), fortune-luck cycles (大运), shensha (神煞), and clash/combine relations.
getSolarTimesReturn a list of possible solar-calendar datetimes that correspond to a given Bazi. Arg: bazi (String, the four pillars separated by spaces).
getChineseCalendarGet Chinese almanac (黄历) information for a specified solar date (defaults to today). Arg: solarDatetime (ISO format, e.g. 2000-05-15T12:00:00+08:00). Returns lunar date, ganzhi, zodiac, na yin, solar term, 28 mansions, lucky directions, clash/sha, and auspicious/inauspicious activities (宜/忌).
When to use it
- Power AI fortune-telling and personality-analysis agents with accurate Bazi chart data
- Compute a person's Four Pillars chart from their birth date and time
- Look up auspicious dates and almanac (黄历) details for a given day
- Reverse-engineer candidate birth datetimes from a known Bazi
Bazi MCP (八字 MCP) FAQ
What transports does the server support?
Both Streamable HTTP (started with `npm start`) and stdio. For stdio, configure your AI app to launch it via `npx bazi-mcp`.
Does it require an API key?
No. The documented stdio configuration runs the server locally via npx with no authentication or environment variables.
Can I install it automatically?
Yes. It can be installed for Claude Desktop via Smithery: `npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude`.
Alternatives to Bazi MCP (八字 MCP)
Compare all alternatives →
Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.
Create, read, and modify Excel workbooks with your AI agent — no Microsoft Excel required.
Official Notion server to read, search, create, and update pages and databases in your workspace.