Get Chinese Astrology
BaZi, Zi Wei Dou Shu, I Ching, Kua number and Flying Stars calculators for AI assistants
- Pricing
- Free
- Platforms
- Web, API
- Runs
- Remotely
- Version
- 1.0.1
- Listing updated
- 3 days ago
About Get Chinese Astrology
Get Chinese Astrology is a free MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http get-chinese-astrology https://getchineseastrology.com/api/mcpAdd to Settings → Connectors → Add custom connector
https://getchineseastrology.com/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"get-chinese-astrology": {
"url": "https://getchineseastrology.com/api/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"get-chinese-astrology": {
"type": "http",
"url": "https://getchineseastrology.com/api/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"get-chinese-astrology": {
"serverUrl": "https://getchineseastrology.com/api/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"get-chinese-astrology": {
"type": "http",
"url": "https://getchineseastrology.com/api/mcp"
}
}
}Tools this server provides (8)
Read directly from the server.
- 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.
What it does
- 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
Pricing
Free
Hosted endpoint with no key listed
Prices change. Check getchineseastrology.com before you buy.
Get Chinese Astrology 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 to Get Chinese Astrology
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments