Get Chinese Astrology

Get Chinese Astrology MCP app

Calculate Chinese astrology charts from a birth date.

Ask for your BaZi Four Pillars, your zodiac year, how two animals match, your five elements, a Kua number, an I Ching reading, a Zi Wei Dou Shu chart or the Flying Stars of a year. The app uses the same calculations as getchineseastrology.com and draws the result.

• Website: https://getchineseastrology.com
• Documentation: https://getchineseastrology.com/app
• Privacy: https://getchineseastrology.com/privacy
• Terms: https://getchineseastrology.com/terms

This repository documents the hosted connector. It does not contain the website or its code.

Connect

• Endpoint: https://getchineseastrology.com/api/mcp
• Transport: Streamable HTTP
• Authentication: none (no account, sign-in or API key)

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

In ChatGPT, add it as a custom MCP server with no authentication. In Claude, open Customize, then Connectors, choose Add custom connector and enter the URL.

Tools

All tools are read-only.

Tool	What it does
get_bazi_chart	Calculates the Four Pillars (BaZi) chart for a birth date, an optional birth time and the birthplace time zone.
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.
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.
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.
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.
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.
get_zi_wei_chart	Builds a Zi Wei Dou Shu chart for a birth date, a birth time and a traditional calculation table.
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.

Try asking

• "What is my BaZi chart? I was born on 15 June 1990 at 12:30 in Shanghai."
• "Are the Rat and the Horse compatible?"
• "Show the Flying Stars chart for 2027."

Report an issue

Open an issue in this repository or email [email protected].

License

The documentation files in this repository are MIT licensed (see LICENSE). The Get Chinese Astrology website, its content, data and brand are not covered by this license.