BaZi, zodiac year, compatibility, five elements, Kua, I Ching, Zi Wei and Flying Stars charts.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Six line values from 6 to 9, bottom line first. A cast is made when absent.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http get-chinese-astrology https://getchineseastrology.com/api/mcp
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.
| Argument | Type | Description |
|---|---|---|
| lines | array | Six line values from 6 to 9, bottom line first. A cast is made when absent. |
{
"type": "object",
"required": [],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9,
"minimum": 6
},
"maxItems": 6,
"minItems": 6,
"description": "Six line values from 6 to 9, bottom line first. A cast is made when absent."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| firstYear | integer | First birth year from 1901 to 2100, paired with secondYear. |
| secondYear | integer | Second birth year from 1901 to 2100, paired with firstYear. |
| firstAnimal | string | First zodiac animal, paired with secondAnimal. |
| secondAnimal | string | Second zodiac animal, paired with firstAnimal. |
{
"type": "object",
"required": [],
"properties": {
"firstYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1901,
"description": "First birth year from 1901 to 2100, paired with secondYear."
},
"secondYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1901,
"description": "Second birth year from 1901 to 2100, paired with firstYear."
},
"firstAnimal": {
"enum": [
"Rat",
"Ox",
"Tiger",
"Rabbit",
"Dragon",
"Snake",
"Horse",
"Goat",
"Monkey",
"Rooster",
"Dog",
"Pig"
],
"type": "string",
"description": "First zodiac animal, paired with secondAnimal."
},
"secondAnimal": {
"enum": [
"Rat",
"Ox",
"Tiger",
"Rabbit",
"Dragon",
"Snake",
"Horse",
"Goat",
"Monkey",
"Rooster",
"Dog",
"Pig"
],
"type": "string",
"description": "Second zodiac animal, paired with firstAnimal."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| date* | string | Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08. |
| time | string | Local birth time as HH:MM on a 24-hour clock. Without it the count covers six characters instead of eight. |
| utcOffset | string | Fixed UTC offset of the birthplace as +HH:MM or -HH:MM, used for solar-term boundaries. +08:00 when absent. |
{
"type": "object",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"minLength": 10,
"description": "Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08."
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"maxLength": 5,
"minLength": 5,
"description": "Local birth time as HH:MM on a 24-hour clock. Without it the count covers six characters instead of eight."
},
"utcOffset": {
"type": "string",
"pattern": "^[+-]\\d{2}:\\d{2}$",
"maxLength": 6,
"minLength": 6,
"description": "Fixed UTC offset of the birthplace as +HH:MM or -HH:MM, used for solar-term boundaries. +08:00 when absent."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| time | string | Local birth time as HH:MM on a 24-hour clock. Without it the chart has no hour pillar and is read at midday. |
| timeZone | string | IANA time zone of the birthplace, such as Asia/Shanghai, Asia/Tokyo or America/New_York. Asia/Shanghai when absent. |
| birthDate* | string | Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08. |
{
"type": "object",
"required": [
"birthDate"
],
"properties": {
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"maxLength": 5,
"minLength": 5,
"description": "Local birth time as HH:MM on a 24-hour clock. Without it the chart has no hour pillar and is read at midday."
},
"timeZone": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "IANA time zone of the birthplace, such as Asia/Shanghai, Asia/Tokyo or America/New_York. Asia/Shanghai when absent."
},
"birthDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"minLength": 10,
"description": "Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Year from 1900 to 2099. |
{
"type": "object",
"required": [
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2099,
"minimum": 1900,
"description": "Year from 1900 to 2099."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| formula* | string | Calculation table: male or female. |
| birthDate* | string | Birth date as YYYY-MM-DD, from 1901-02-19 to 2099-12-31. |
{
"type": "object",
"required": [
"birthDate",
"formula"
],
"properties": {
"formula": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Calculation table: male or female."
},
"birthDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"minLength": 10,
"description": "Birth date as YYYY-MM-DD, from 1901-02-19 to 2099-12-31."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| time* | string | Local birth time as HH:MM on a 24-hour clock. |
| gender* | string | Traditional calculation table: male or female. |
| birthDate* | string | Birth date as YYYY-MM-DD, from 1900-01-01 to 2099-12-31. |
{
"type": "object",
"required": [
"birthDate",
"time",
"gender"
],
"properties": {
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"maxLength": 5,
"minLength": 5,
"description": "Local birth time as HH:MM on a 24-hour clock."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Traditional calculation table: male or female."
},
"birthDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"minLength": 10,
"description": "Birth date as YYYY-MM-DD, from 1900-01-01 to 2099-12-31."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| date | string | Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08. The year can be given instead. |
| year | integer | Zodiac year from 1901 to 2099, opened by Chinese New Year of that year. The date can be given instead. |
{
"type": "object",
"required": [],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"minLength": 10,
"description": "Birth date as YYYY-MM-DD, from 1901-02-19 to 2100-02-08. The year can be given instead."
},
"year": {
"type": "integer",
"maximum": 2099,
"minimum": 1901,
"description": "Zodiac year from 1901 to 2099, opened by Chinese New Year of that year. The date can be given instead."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 11, 2026.