BaZi, Zi Wei, Qi Zheng Si Yu, divination and almanac from a deterministic engine. Pay per call.
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.
Chinese almanac (黄历) for a date: day pillars, do / avoid, day officer, solar term, clash. Price: $0.005 per day.
YYYY-MM-DD; default today (UTC+8)
Names and links language
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mingge https://mingge.org/mcp
Chinese almanac (黄历) for a date: day pillars, do / avoid, day officer, solar term, clash. Price: $0.005 per day.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD; default today (UTC+8) |
| lang | string | Names and links language |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD; default today (UTC+8)"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
}
}
}BaZi (Four Pillars) chart from birth data: pillars, hidden stems, ten gods, MingGe archetype (one of 55) and title, substance / volatility / rarity scores, structure verdict, favourable and unfavourable elements, shensha, the current luck decade with its score and reasons, and this year. Deterministic engine; nothing is stored. Price: $0.05 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Needed for luck decades (direction depends on gender); taken from the saved chart with chart_id |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Needed for luck decades (direction depends on gender); taken from the saved chart with chart_id"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}The full BaZi luck curve: all eight luck decades with MingGe's score (with scale), tier and grounds, plus a score for every year. MingGe members' content. Price: $0.15 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}MingGe's score and grounds for a given year, month or day of a BaZi chart (annual, monthly, daily fortune), with the solar-term month it reads. Price: $0.05 per period.
| Argument | Type | Description |
|---|---|---|
| day | integer | Day of that month (needs month) |
| lang | string | Names and links language |
| year* | integer | Year to read (Gregorian) |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| month | integer | Gregorian month; read as the solar-term month containing the 15th |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"required": [
"year"
],
"properties": {
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1,
"description": "Day of that month (needs month)"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"year": {
"type": "integer",
"maximum": 2099,
"minimum": 1901,
"description": "Year to read (Gregorian)"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Gregorian month; read as the solar-term month containing the 15th"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}BaZi skeleton only (facts, no judgement): four pillars, hidden stems, ten gods, nayin, life stages, void branches, shensha, and the luck-pillar sequence. For MingGe's archetype, scores and verdicts use bazi_chart. Price: $0.01 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Optional (taken from the saved chart with chart_id); adds the luck-pillar skeleton |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Optional (taken from the saved chart with chart_id); adds the luck-pillar skeleton"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Life-event timing from a BaZi chart: time windows by area (marriage, career, wealth, move, health, children, home, parents, peers) with grounds. MingGe members' content. Price: $0.15 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| domain | string | Only this life area (default: all) |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"domain": {
"enum": [
"parents",
"peers",
"home",
"marriage",
"children",
"career",
"wealth",
"move",
"health"
],
"type": "string",
"description": "Only this life area (default: all)"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Turn what the user said about their birth (date, time, city, gender; solar or lunar) into the `birth` object the chart tools take, with longitude and time zone filled from the city. Show it to the user to confirm. Free (API key required). Price: free (API key required).
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| text* | string | What the user said, e.g. "1990-05-01 14:30 Shanghai female" or "农历 1988 年十月十五 早上六点 北京 男" |
{
"type": "object",
"required": [
"text"
],
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"text": {
"type": "string",
"maxLength": 400,
"minLength": 1,
"description": "What the user said, e.g. \"1990-05-01 14:30 Shanghai female\" or \"农历 1988 年十月十五 早上六点 北京 男\""
}
}
}Convert a date (and optional time): Gregorian, Chinese lunar and stem-branch pillars, the solar term it falls in with exact term times, and true solar time when longitude is given. Price: $0.01 per date.
| Argument | Type | Description |
|---|---|---|
| tz | string | IANA zone of the clock time |
| date* | string | YYYY-MM-DD; with calendar=lunar this is the lunar year-month-day |
| lang | string | Names and links language |
| leap | boolean | calendar=lunar: the month is a leap month |
| time | string | HH:mm local clock time (for the hour pillar and true solar time) |
| calendar | string | What `date` is in (default solar) |
| longitude | number | For true solar time (east positive) |
{
"type": "object",
"required": [
"date"
],
"properties": {
"tz": {
"type": "string",
"maxLength": 64,
"description": "IANA zone of the clock time"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD; with calendar=lunar this is the lunar year-month-day"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"leap": {
"type": "boolean",
"description": "calendar=lunar: the month is a leap month"
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "HH:mm local clock time (for the hour pillar and true solar time)"
},
"calendar": {
"enum": [
"solar",
"lunar"
],
"type": "string",
"description": "What `date` is in (default solar)"
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "For true solar time (east positive)"
}
}
}Da Liu Ren (大六壬) lesson for the moment of asking: four lessons, three transmissions, heavenly generals, lesson type. Deterministic engine: returns the board plus MingGe's full verdict (conclusion, grounds, timing). Verdict text is in Chinese — relay it in the user's language without changing the judgement. Nothing is stored. Price: $0.05 per cast.
| Argument | Type | Description |
|---|---|---|
| d | string | Asker's local date YYYY-MM-DD (with t) |
| t | string | Asker's local time HH:mm (with d) |
| tz | string | Asker's IANA time zone; alone = cast for this moment |
| lang | string | Names and links language |
| topic* | string | What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. |
| birthBranch | string | Earthly branch of the asker's birth year (optional) |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"d": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Asker's local date YYYY-MM-DD (with t)"
},
"t": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Asker's local time HH:mm (with d)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "Asker's IANA time zone; alone = cast for this moment"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"topic": {
"enum": [
"wealth_seek",
"career_promo",
"job_seek",
"love_can",
"marriage",
"partnership",
"waiting_news",
"waiting_person",
"travel",
"lost_item",
"lawsuit",
"illness",
"other"
],
"type": "string",
"description": "What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other."
},
"birthBranch": {
"enum": [
"子",
"丑",
"寅",
"卯",
"辰",
"巳",
"午",
"未",
"申",
"酉",
"戌",
"亥"
],
"type": "string",
"description": "Earthly branch of the asker's birth year (optional)"
}
}
}Liu Yao (六爻) divination for one question: six lines by coin toss (default), by time or given manually; original and changed hexagram, six relatives, use god. Deterministic engine: returns the board plus MingGe's full verdict (conclusion, grounds, timing). Verdict text is in Chinese — relay it in the user's language without changing the judgement. Nothing is stored. Price: $0.05 per cast.
| Argument | Type | Description |
|---|---|---|
| d | string | Asker's local date YYYY-MM-DD (with t) |
| t | string | Asker's local time HH:mm (with d) |
| tz | string | Asker's IANA time zone; alone = cast for this moment |
| lang | string | Names and links language |
| mode | string | coin (default): the server tosses three coins six times; time: derived from the moment; manual: pass `values` |
| topic* | string | What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. Also exam, property, family. |
| values | string | manual mode: six line values bottom to top, 6 old yin, 7 young yang, 8 young yin, 9 old yang |
Plum Blossom (梅花易数) divination for one question, from the moment or from two numbers: original / mutual / changed hexagrams, body and use. Deterministic engine: returns the board plus MingGe's full verdict (conclusion, grounds, timing). Verdict text is in Chinese — relay it in the user's language without changing the judgement. Nothing is stored. Price: $0.05 per cast.
| Argument | Type | Description |
|---|---|---|
| a | integer | way=number: first number |
| b | integer | way=number: second number |
| d | string | Asker's local date YYYY-MM-DD (with t) |
| t | string | Asker's local time HH:mm (with d) |
| tz | string | Asker's IANA time zone; alone = cast for this moment |
| way | string | now (default): from the moment; number: from two numbers the asker thought of |
| lang | string | Names and links language |
| topic* | string | What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. |
Qi Men Dun Jia (奇门遁甲) chart for the moment of asking: nine palaces with doors, stars, deities and stems, patterns. Deterministic engine: returns the board plus MingGe's full verdict (conclusion, grounds, timing). Verdict text is in Chinese — relay it in the user's language without changing the judgement. Nothing is stored. Price: $0.05 per cast.
| Argument | Type | Description |
|---|---|---|
| d | string | Asker's local date YYYY-MM-DD (with t) |
| t | string | Asker's local time HH:mm (with d) |
| tz | string | Asker's IANA time zone; alone = cast for this moment |
| lang | string | Names and links language |
| topic* | string | What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. |
| boundary | string | When the day changes: 23:00 (default) or midnight |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"d": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Asker's local date YYYY-MM-DD (with t)"
},
"t": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Asker's local time HH:mm (with d)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "Asker's IANA time zone; alone = cast for this moment"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"topic": {
"enum": [
"wealth_seek",
"career_promo",
"job_seek",
"love_can",
"marriage",
"partnership",
"waiting_news",
"waiting_person",
"travel",
"lost_item",
"lawsuit",
"illness",
"other"
],
"type": "string",
"description": "What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other."
},
"boundary": {
"enum": [
"zi23",
"midnight"
],
"type": "string",
"description": "When the day changes: 23:00 (default) or midnight"
}
}
}Xiao Liu Ren (小六壬) quick reading for the moment of asking: month / day / hour palaces and the final palace. Deterministic engine: returns the board plus MingGe's full verdict (conclusion, grounds, timing). Verdict text is in Chinese — relay it in the user's language without changing the judgement. Nothing is stored. Price: $0.02 per cast.
| Argument | Type | Description |
|---|---|---|
| d | string | Asker's local date YYYY-MM-DD (with t) |
| t | string | Asker's local time HH:mm (with d) |
| tz | string | Asker's IANA time zone; alone = cast for this moment |
| lang | string | Names and links language |
| topic* | string | What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"d": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Asker's local date YYYY-MM-DD (with t)"
},
"t": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Asker's local time HH:mm (with d)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "Asker's IANA time zone; alone = cast for this moment"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"topic": {
"enum": [
"wealth_seek",
"career_promo",
"job_seek",
"love_can",
"marriage",
"partnership",
"waiting_news",
"waiting_person",
"travel",
"lost_item",
"lawsuit",
"illness",
"other"
],
"type": "string",
"description": "What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other."
}
}
}Create an account + API key (shown once; includes a small free trial). Save it and configure it as the Bearer token for this MCP server. Free.
| Argument | Type | Description |
|---|---|---|
| label | string |
{
"type": "object",
"properties": {
"label": {
"type": "string"
}
}
}Draw a temple lot (灵签) — Guanyin, the Matchmaker (Yuelao) or Guan Di. The server draws the number uniformly at random; returns the lot's rank, poem and the classical annotations by topic. Text is in Chinese. Nothing is stored. Price: $0.02 per lot.
| Argument | Type | Description |
|---|---|---|
| kind* | string | guanyin: Guanyin's 100 lots (general); yuelao: the Matchmaker's lots (love); guandi: Guan Di's 100 lots (general) |
| lang | string | Names and links language |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"guanyin",
"yuelao",
"guandi"
],
"type": "string",
"description": "guanyin: Guanyin's 100 lots (general); yuelao: the Matchmaker's lots (love); guandi: Guan Di's 100 lots (general)"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
}
}
}Remaining prepaid credits and recent charges. Free.
No arguments.
{
"type": "object",
"properties": {}
}Prices and payment methods. Free.
No arguments.
{
"type": "object",
"properties": {}
}Synastry (合盘) of two people's birth data for romance, business partnership, friendship or family: overall score and title, six dimension scores with their grounds, cross-chart interactions, cross shensha, ten-god matrix, Zi Wei cross transformations. Deterministic engine; nothing is stored. Price: $0.10 per pair.
| Argument | Type | Description |
|---|---|---|
| a | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| b | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| lang | string | Names and links language |
| genderA | string | Required with `a` |
| genderB | string | Required with `b` |
| relation* | string | romance = love / marriage, partner = business, friend, family |
| chart_id_a | string | Saved chart id instead of a |
| chart_id_b | string | Saved chart id instead of b |
Look up a Chinese metaphysics term, star, shensha or pattern: meaning, the condition under which it forms, its share of all charts, and the classical source text. Price: $0.01 per term.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| term* | string | A term, star or pattern in Chinese, e.g. 天乙贵人, 七杀, 紫微, 伤官配印 |
{
"type": "object",
"required": [
"term"
],
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"term": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "A term, star or pattern in Chinese, e.g. 天乙贵人, 七杀, 紫微, 伤官配印"
}
}
}List the user's saved charts in MingGe (id, label, birth summary). Pass an id as `chart_id` to the chart tools instead of `birth`. Needs a connected MingGe account (OAuth at mingge.org/mcp/account). Free, rate-limited. Price: free (API key required).
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
}
}
}Qi Zheng Si Yu (七政四余, Chinese sidereal astrology) natal chart: the eleven luminaries' mansions and degrees, degree lords, benefic and malefic roles, star patterns, life and body lords. Rarely available anywhere else. Price: $0.15 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Qi Zheng Si Yu transits at a moment (default now) against the natal chart: where each luminary is and what it activates. Price: $0.10 per moment.
| Argument | Type | Description |
|---|---|---|
| at | string | Moment to read, local clock time YYYY-MM-DDTHH:mm (default: now) |
| tz | string | IANA zone of `at` |
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Moment to read, local clock time YYYY-MM-DDTHH:mm (default: now)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "IANA zone of `at`"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Get a payment link (card or USDC) to give to the human. Amounts: 5, 20, 100 USD. Free.
| Argument | Type | Description |
|---|---|---|
| amount_usd* | integer |
{
"type": "object",
"required": [
"amount_usd"
],
"properties": {
"amount_usd": {
"enum": [
5,
20,
100
],
"type": "integer"
}
}
}Date selection (择日): usable days for an event (wedding, engagement, moving in, opening, signing, groundbreaking, travel, seeing a doctor) within a date range, with reasons, excluding days that clash with the person's chart. Price: $0.10 per range.
| Argument | Type | Description |
|---|---|---|
| to* | string | Last day YYYY-MM-DD (up to about a year) |
| from* | string | First day YYYY-MM-DD |
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| event* | string | jiaqu wedding, dinghun engagement, ruzhai moving in, kaiye opening a business, jiaoyi signing a deal, dongtu groundbreaking or renovation, chuxing travel, qiuyi seeing a doctor |
| gender | string | |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
Zi Wei Dou Shu board only (facts, no patterns): twelve palaces with stars, brightness, four transformations and decade-limit ranges. For patterns and their share use ziwei_chart. Price: $0.01 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Zi Wei Dou Shu natal chart from birth data: soul and body palaces, five-element bureau, twelve palaces with major / minor stars, brightness and four transformations, decade limits, and the patterns the chart forms with their share of all charts. Deterministic engine; nothing is stored. Price: $0.05 per chart.
| Argument | Type | Description |
|---|---|---|
| lang | string | Names and links language |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| gender | string | Required with `birth`; taken from the saved chart with chart_id |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth`; taken from the saved chart with chart_id"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}Zi Wei Dou Shu limits for a year, month or day: decade, annual, monthly and daily palaces with flying four transformations and notes. Price: $0.10 per period.
| Argument | Type | Description |
|---|---|---|
| day | integer | Day of that month (needs month) |
| lang | string | Names and links language |
| year* | integer | Year to read (Gregorian) |
| birth | object | Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form. |
| month | integer | Gregorian month; read as the solar-term month containing the 15th |
| gender | string | Required with `birth` (taken from the saved chart with chart_id) |
| chart_id | string | Saved chart id from my_charts, instead of birth (needs a MingGe account) |
{
"type": "object",
"required": [
"year"
],
"properties": {
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1,
"description": "Day of that month (needs month)"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"year": {
"type": "integer",
"maximum": 2099,
"minimum": 1901,
"description": "Year to read (Gregorian)"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Gregorian month; read as the solar-term month containing the 15th"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `birth` (taken from the saved chart with chart_id)"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}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 17, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
| variant | string | Required for some topics — lost_item: valuables|documents|belongings|animal|person; love_can / marriage: target_male|target_female (who is being asked about); illness: patient_self|patient_other; family: kin_parent|kin_child|kin_sibling |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"d": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Asker's local date YYYY-MM-DD (with t)"
},
"t": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Asker's local time HH:mm (with d)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "Asker's IANA time zone; alone = cast for this moment"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"mode": {
"enum": [
"coin",
"time",
"manual"
],
"type": "string",
"description": "coin (default): the server tosses three coins six times; time: derived from the moment; manual: pass `values`"
},
"topic": {
"enum": [
"wealth_seek",
"career_promo",
"job_seek",
"exam",
"love_can",
"marriage",
"partnership",
"property",
"waiting_news",
"waiting_person",
"travel",
"lost_item",
"lawsuit",
"illness",
"family",
"other"
],
"type": "string",
"description": "What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other. Also exam, property, family."
},
"values": {
"type": "string",
"pattern": "^[6-9]{6}$",
"description": "manual mode: six line values bottom to top, 6 old yin, 7 young yang, 8 young yin, 9 old yang"
},
"variant": {
"type": "string",
"maxLength": 24,
"description": "Required for some topics — lost_item: valuables|documents|belongings|animal|person; love_can / marriage: target_male|target_female (who is being asked about); illness: patient_self|patient_other; family: kin_parent|kin_child|kin_sibling"
}
}
}| variant | string |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"a": {
"type": "integer",
"maximum": 99999,
"minimum": 1,
"description": "way=number: first number"
},
"b": {
"type": "integer",
"maximum": 99999,
"minimum": 1,
"description": "way=number: second number"
},
"d": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Asker's local date YYYY-MM-DD (with t)"
},
"t": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Asker's local time HH:mm (with d)"
},
"tz": {
"type": "string",
"maxLength": 64,
"description": "Asker's IANA time zone; alone = cast for this moment"
},
"way": {
"enum": [
"now",
"number"
],
"type": "string",
"description": "now (default): from the moment; number: from two numbers the asker thought of"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"topic": {
"enum": [
"wealth_seek",
"career_promo",
"job_seek",
"love_can",
"marriage",
"partnership",
"waiting_news",
"waiting_person",
"travel",
"lost_item",
"lawsuit",
"illness",
"other"
],
"type": "string",
"description": "What the question is about: wealth_seek money, career_promo promotion, job_seek job hunt, love_can will this romance work, marriage, partnership business partner, waiting_news news, waiting_person someone's arrival, travel, lost_item, lawsuit, illness, other."
},
"variant": {
"type": "string",
"maxLength": 24
}
}
}{
"type": "object",
"required": [
"relation"
],
"properties": {
"a": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"b": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"genderA": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `a`"
},
"genderB": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Required with `b`"
},
"relation": {
"enum": [
"romance",
"partner",
"friend",
"family"
],
"type": "string",
"description": "romance = love / marriage, partner = business, friend, family"
},
"chart_id_a": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id instead of a"
},
"chart_id_b": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id instead of b"
}
}
}{
"type": "object",
"required": [
"event",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day YYYY-MM-DD (up to about a year)"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day YYYY-MM-DD"
},
"lang": {
"enum": [
"en",
"zh-CN",
"ja",
"ko"
],
"type": "string",
"description": "Names and links language"
},
"birth": {
"type": "object",
"required": [
"year",
"month",
"day",
"hour"
],
"properties": {
"tz": {
"type": "string"
},
"day": {
"type": "integer"
},
"hour": {
"type": "integer"
},
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"dstOff": {
"type": "boolean"
},
"minute": {
"type": "integer"
},
"cityName": {
"type": "string"
},
"longitude": {
"type": "number"
},
"standardMeridian": {
"type": "number"
}
},
"description": "Birth data in local clock time (year, month, day, hour, minute; longitude + tz for true solar time). Build it with birth_form."
},
"event": {
"enum": [
"jiaqu",
"dinghun",
"ruzhai",
"kaiye",
"jiaoyi",
"dongtu",
"chuxing",
"qiuyi"
],
"type": "string",
"description": "jiaqu wedding, dinghun engagement, ruzhai moving in, kaiye opening a business, jiaoyi signing a deal, dongtu groundbreaking or renovation, chuxing travel, qiuyi seeing a doctor"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"chart_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Saved chart id from my_charts, instead of birth (needs a MingGe account)"
}
}
}