Get Chinese Astrology in ChatGPT and Claude
Calculate a BaZi chart, a zodiac year, animal compatibility, the five elements, a Kua number, an I Ching reading, a Zi Wei Dou Shu chart or the annual Flying Stars in a chat. The app uses the same calculators as this website and needs no account.
Connect
Server address: https://getchineseastrology.com/api/mcp. Transport: Streamable HTTP. Authentication: none.
ChatGPT: open Plugins, choose Add custom MCP server, enter the address above and select no authentication. Claude: open Customize, then Connectors, choose Add custom connector and enter the address.
Tools
| Tool | What it returns |
|---|---|
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. |
Example prompts
- 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.
Your data
The app only reads. The birth data you give is used for the calculation and is not stored, and following a link from a result to this website records no click. See the privacy page and the terms.
Troubleshooting
If the tools do not appear, check that the address above is entered exactly, with no authentication, then refresh the connector or start a new chat. Birth times are read in the birthplace time zone you give; Asia/Shanghai is assumed when none is given.
Support
Questions or problems: support@getchineseastrology.com.