About Chinese Astrology Skill
Chinese Astrology Skill is a set of Chinese astrology tools for AI agents, covering BaZi charts, reverse BaZi lookup, the Chinese almanac, and bone-weight fortune. It is available both as an Agent Skill and as an MCP server for client connections.
Key features
- 01Calculate complete BaZi charts
- 02Look up birth dates from a BaZi string
- 03Retrieve almanac information for a date
- 04Calculate Yuan Tiangang bone weight and return poems
- 05Provide bilingual English and Chinese tool descriptions
Use cases
- 01Add BaZi readings to AI chatbots
- 02Integrate Chinese astrology features into applications
- 03Add almanac and auspicious-date lookup to calendar apps
- 04Explore traditional Chinese metaphysics computationally
MCP support
It provides four MCP tools for BaZi charts, reverse birth-date lookup, almanac queries, and bone-weight calculations. MCP clients can connect over stdio or HTTP transport.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| solarDatetime | string | No | Birth datetime in ISO format, e.g. "2000-01-15T12:00:00+08:00". 公历出生时间。 |
| lunarDatetime | string | No | Lunar birth datetime, e.g. "2000-5-5 12:00:00". 农历出生时间。 |
| gender | number | Yes | 0 = female, 1 = male. 0=女，1=男。 |
| eightCharProviderSect | number | No | Late Zi hour config. 1 = next day, 2 = same day (default). 早晚子时：1=明天，2=当天。 |
Details
From the project READMEChinese Astrology Skill 🔮
The most comprehensive Chinese astrology AI skill — 4 tools covering BaZi (Four Pillars of Destiny), bone weight fortune telling, and Chinese almanac. Available as an Agent Skill (SKILL.md) and MCP server.
Built by Ba-Zi.ai — Free AI-powered BaZi calculator and Chinese astrology platform.
Features
| Tool | Description | Unique? |
|---|---|---|
getBaziChart | Full BaZi (四柱八字) chart calculation with Ten Gods, Hidden Stems, Decade Fortune | — |
findBirthDates | Reverse-lookup: find birth dates from a BaZi string | — |
getAlmanac | Chinese almanac (黄历) with auspicious activities and directional gods | — |
calculateBoneWeight | Yuan Tiangang bone weight fortune (秤骨算命) with 52 destiny poems | ✅ Exclusive |
What makes this different?
- Bone Weight Fortune (秤骨算命) — The only MCP/Skill that includes Yuan Tiangang's 1,300-year-old bone weight calculation with all 52 classical poems and modern interpretations
- Bilingual descriptions — All tool descriptions in both English and Chinese
- Accurate calculations — Powered by tyme4ts, the most precise Chinese calendar library
Quick Start
Claude Desktop / Claude Code
Add to your MCP config:
{
"mcpServers": {
"chinese-astrology": {
"command": "npx",
"args": ["-y", "chinese-astrology-skill"]
}
}
}
Stdio Transport
npx chinese-astrology-skill
HTTP Transport
git clone https://github.com/xlw-pro/chinese-astrology-skill.git
cd chinese-astrology-skill
npm install
npm start
# Server runs at http://localhost:3000/mcp
Tools
1. getBaziChart — BaZi Chart Calculation (八字排盘)
Calculate a complete Four Pillars of Destiny chart from birth datetime.
Input:
{
"solarDatetime": "2000-01-15T12:00:00+08:00",
"gender": 1
}
Returns: Complete BaZi chart including:
- Four Pillars (年柱/月柱/日柱/时柱) with Heavenly Stems & Earthly Branches
- Five Elements (五行) for each position
- Ten Gods (十神) relationships
- Hidden Stems (藏干) — main, middle, and residual qi
- Nayin (纳音), Void (空亡), Terrain (星运)
- Decade Fortune (大运) — 10 periods with start ages
- Gods & Spirits (神煞) for all four pillars
- Branch Relations (刑冲合会) — clashes, combinations, penalties
2. findBirthDates — Reverse BaZi Lookup (八字反查)
Find all possible birth dates (from 1700 to present) that match a given BaZi string.
Input:
{
"bazi": "戊寅 己未 己卯 辛未"
}
Returns: Array of matching solar datetimes.
3. getAlmanac — Chinese Almanac (黄历)
Get Chinese almanac information for any date.
Input:
{
"solarDatetime": "2026-04-06T00:00:00+08:00"
}
Returns: Lunar date, zodiac, Nayin, solar terms, 28 mansions, Peng Zu taboos, directional gods (Joy/Yang Noble/Yin Noble/Mascot/Wealth), auspicious & inauspicious activities, clash info.
4. calculateBoneWeight — Bone Weight Fortune (秤骨算命) ⭐
Calculate bone weight fortune using Yuan Tiangang's ancient Tang Dynasty method (c. 600 CE).
Input:
{
"solarDatetime": "1990-06-15T14:00:00+08:00"
}
Returns:
{
"totalWeight": 4.8,
"unit": "两 (liǎng)",
"percentile": 54,
"breakdown": {
"year": { "ganzhi": "庚午", "weight": 0.9 },
"month": { "lunarMonth": 5, "weight": 0.5 },
"day": { "lunarDay": 23, "weight": 0.8 },
"hour": { "earthBranch": "未", "weight": 0.8 }
},
"poem": "初年运道未曾亨...",
"interpretation": "Late success through independence..."
}
Weight ranges from 2.1 to 7.2 liǎng across 52 destiny types. Learn more about bone weight fortune →
Use Cases
- AI Chatbots — Give your AI assistant accurate BaZi reading capabilities
- Fortune Telling Apps — Build Chinese astrology features into your product
- Calendar Apps — Add Chinese almanac and auspicious date lookup
- Research — Explore traditional Chinese metaphysics computationally
Tech Stack
- tyme4ts — Chinese calendar calculation engine
- cantian-tymext — Extended BaZi analysis
- MCP SDK — Model Context Protocol for AI integration
Related
- Ba-Zi.ai — Free AI BaZi calculator with deep analysis reports
- BaZi Calculator — Generate your Four Pillars chart in 30 seconds
- Bone Weight Calculator — Free online Yuan Tiangang bone weight fortune
- BaZi Compatibility — Check relationship compatibility with BaZi
- What is BaZi? — Complete guide to Four Pillars of Destiny
Roadmap
- v1.0 — BaZi chart, reverse lookup, almanac, bone weight
- v2.0 — Qi Men Dun Jia (奇门遁甲)
- v3.0 — Zi Wei Dou Shu (紫微斗数)
License
MIT — see LICENSE
Built with ❤️ by Ba-Zi.ai — AI-powered Chinese astrology for everyone.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.