Skip to main content
Glama
Get Chinese Astrology

Get Chinese Astrology

by pyxlino

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.

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.

Related MCP server: BaZi (Eight Characters) Calculator

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 support@getchineseastrology.com.

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables generation of detailed Chinese Ziwei Doushu (Purple Star) astrological charts with geographic location support and true solar time conversion. Provides tools for geocoding locations, converting Beijing time to apparent solar time, and creating comprehensive astrology readings based on birth information.
      12 npm
      14
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Calculates Chinese BaZi (Four Pillars of Destiny) charts based on birth date, time, and location, including solar term information, decade luck cycles, and true solar time corrections.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables traditional Chinese fortune-telling through BaZi (Four Pillars) analysis, including solar/lunar date conversion, Five Element balance calculations, Ten Gods deduction, and destiny interpretation for metaphysics applications.
      22 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides tools for Bazi (Chinese astrology) chart calculation and analysis, enabling LLMs to generate accurate birth charts, determine patterns, and answer follow-up questions based on actual calculations rather than model knowledge.
      2
      MIT