# Get Chinese Astrology

> Get Chinese Astrology is a free MCP server for astrology. BaZi, Zi Wei Dou Shu, I Ching, Kua number and Flying Stars calculators for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://getchineseastrology.com
- **Repository:** https://github.com/pyxlino/getchineseastrology-mcp
- **MCP Registry name:** com.getchineseastrology/get-chinese-astrology
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

This server goes deeper into traditional Chinese metaphysics than a sign lookup. It builds a Four Pillars (BaZi) chart from a birth date, optional time and the birthplace time zone, counts Wood, Fire, Earth, Metal and Water across the visible characters, and builds a Zi Wei Dou Shu chart from a birth date, time and calculation table.

Other tools return the zodiac year with its Chinese New Year dates and Li Chun date, compare two animals or birth years as Six Harmony, Three Harmony, clash, harm, break, punishment or neutral, work out a feng shui Kua number with favourable directions, and read an I Ching hexagram from six line values entered bottom first. The annual Flying Stars chart shows the star in each of nine palaces.

The endpoint is hosted over Streamable HTTP and the registry entry lists no packages or keys.

## Features

- **BaZi chart:** Calculates the Four Pillars from date, optional time and time zone.
- **Zi Wei Dou Shu:** Builds a chart with palaces and stars for a birth moment.
- **Five elements count:** Counts the elements across a chart's visible characters.
- **I Ching casting:** Reads a hexagram from six line values, including changing lines.
- **Kua and Flying Stars:** Gives a Kua number with directions and the annual nine-palace chart.

## Good for

- Get a Four Pillars chart for a birth moment
- Check animal compatibility between two people
- Find favourable directions from a Kua number
- Read a cast hexagram

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http get-chinese-astrology https://getchineseastrology.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://getchineseastrology.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "get-chinese-astrology": {
      "url": "https://getchineseastrology.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "get-chinese-astrology": {
      "type": "http",
      "url": "https://getchineseastrology.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "get-chinese-astrology": {
      "serverUrl": "https://getchineseastrology.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "get-chinese-astrology": {
      "type": "http",
      "url": "https://getchineseastrology.com/api/mcp"
    }
  }
}
```

## Tools

- `get_bazi_chart`: Calculates the Four Pillars (BaZi) chart for a birth date, an optional birth time and the birthplace time zone. Returns the year, month, day and hour pillars, the Day Master, each stem's Ten Gods relation to it, the hidden stems in each branch and the five-element count.
- `get_zodiac_year`: Returns the Chinese zodiac year for a birth date or a calendar year: the animal, Heavenly Stem, element, yin or yang, the Chinese New Year dates that open and close the year and the Li Chun date. A birth date also reports whether Chinese New Year and Li Chun give different animals.
- `check_animal_compatibility`: Compares two Chinese zodiac animals, or the animals of two birth years, and names their relationship: Six Harmony, Three Harmony, clash, harm, break, punishment or neutral. Returns the relation types, the phase interaction, the distance on the twelve-animal circle and a written reading of the pair.
- `count_five_elements`: Counts Wood, Fire, Earth, Metal and Water across the visible characters of the Four Pillars chart for a birth date, with an optional birth time and UTC offset. Returns each count with its relation to the Day Master, the leading element, the elements missing from view and the Day Master.
- `get_kua_number`: Returns the feng shui Kua number for a birth date and calculation table: its trigram, element, East or West group, and the four favourable and four unfavourable directions. Birthdays before Chinese New Year use the preceding Chinese year.
- `cast_i_ching`: Reads an I Ching hexagram from six line values, bottom line first: 6 is a changing Yin line, 7 a Yang line, 8 a Yin line and 9 a changing Yang line. Without line values it makes a random three-coin cast. Returns the primary and relating hexagrams, the changing lines and their classical texts.
- `get_zi_wei_chart`: Builds a Zi Wei Dou Shu chart for a birth date, a birth time and a traditional calculation table. Returns the lunar date, the Five Element bureau, the Life and Body palace branches and the major stars with their brightness and transformations in each of the twelve palaces.
- `get_flying_stars`: Returns the annual Flying Stars chart for a year: the star in each of the nine palaces, the centre star and the moment Li Chun begins the year. The grid has south at the top.

## FAQ

### What does the BaZi tool need?

A birth date, optionally a birth time and the time zone of the birthplace.

### How are I Ching lines entered?

As six values, bottom line first: 6 changing Yin, 7 Yang, 8 Yin, 9 changing Yang.

### Which relationships can compatibility return?

Six Harmony, Three Harmony, clash, harm, break, punishment or neutral.

### Is an account needed?

The registry entry lists a remote endpoint with no key.

### Is Get Chinese Astrology free?

Yes. Get Chinese Astrology is free to use.

### How do I add Get Chinese Astrology to Claude Code?

Run this command in your terminal: claude mcp add --transport http get-chinese-astrology https://getchineseastrology.com/api/mcp

### What are the best alternatives to Get Chinese Astrology?

The closest alternatives to Get Chinese Astrology are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [12 Chinese Zodiac Signs](https://ai-powered.com/mcp/12-chinese-zodiac-signs): 12 Chinese Zodiac Signs is a free MCP server for astrology.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/get-chinese-astrology
