bazi-mcp is an MCP server launched by Cantian AI, aimed at the field of Bazi (Chinese fortune-telling). According to the project description, it is called the first AI-driven Bazi calculator, with the main purpose of solving the common problem of inaccurate chart casting in existing AI fortune-telling tools such as GPT and DeepSeek, and providing reliable Bazi data for AI agents for scenarios such as personality analysis and destiny prediction.
Main capabilities:
- Accurate chart casting: Calculate Bazi information based on a given Gregorian or lunar time.
- AI empowerment: Provide reliable Bazi services for AI agents.
- Community co-construction: The project is an open-source repository, and fortune-telling enthusiasts are welcome to participate in discussion and development.
Tools and parameters:
- Calculate the Bazi results based on the solar/lunar datetime. Parameters include: solarDatetime (string, solar calendar time in ISO format, for example 2000-05-15T12:00:00+08:00); lunarDatetime (string, lunar time, for example 2000-05-15 12:00:00); gender (number, gender, optional, 0 means female, 1 means male, default 1); eightCharProviderSect (number, early/late Zi hour configuration, optional, 1 means the day stem-branch for 23:00-23:59 is tomorrow, 2 means the day stem-branch for 23:00-23:59 is the current day, default 2).
- Return a list of possible solar calendar datetime based on the given Bazi. Parameters: bazi (string, Bazi, with each pillar separated by a space).
- getChineseCalendar: Get chinese calendar information for the specified solar calendar date (default is today). Parameters: solarDatetime, solar calendar time in ISO format, for example 2000-05-15T12:00:00+08:00.
Usage and prerequisites: Node.js 22 or above is required before use. It can be started via Streamable HTTP transport or via Stdio transport, and can be configured in AI applications (for example Claude Desktop). In addition, it supports automatically installing bazi-mcp into Claude Desktop via Smithery.
Applicable scenarios: It is intended for developers and fortune-telling researchers who need to integrate accurate Bazi chart casting capabilities into AI agents, and can be used for applications such as personality analysis and destiny prediction.
Limitations and notes: The materials do not provide information such as specific charges, pricing, platform support scope, accuracy verification data, or usage results, and such information is not currently available. The project contact email is support@cantian.ai.
