Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://getchineseastrology.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "get-chinese-astrology": {
      "url": "https://getchineseastrology.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments