Ba-Zi.ai Chinese Astrology

Chinese 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

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

• [x] 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.