# MingGe: full reference for AI agents > Deterministic Chinese metaphysics engine for AI agents: BaZi (Four Pillars), Zi Wei Dou Shu, Qi Zheng Si Yu, synastry, date selection, the Chinese almanac and six kinds of divination, pay per call over MCP or REST. $0.005 to $0.15 per call. Generated live from https://api.akifukaku.com (https://api.akifukaku.com/v1/pricing, https://api.akifukaku.com/openapi.json, https://api.akifukaku.com/mingge/skill.md). ## Endpoints - MCP (API key or x402): https://mingge.org/mcp - MCP (MingGe account, OAuth): https://mingge.org/mcp/account - REST: `POST https://api.akifukaku.com/v1/mingge/` with `Authorization: Bearer ` or an x402 `PAYMENT-SIGNATURE` - Page: https://mingge.org/agents ## Prices (USD, live) - `birth_form`: free (API key required) per call · `POST https://api.akifukaku.com/v1/mingge/birth_form` - `list_options`: free (API key required) per call · `POST https://api.akifukaku.com/v1/mingge/list_options` - `my_charts`: free (API key required) per call · `POST https://api.akifukaku.com/v1/mingge/my_charts` - `almanac_day`: $0.005 per day · `POST https://api.akifukaku.com/v1/mingge/almanac_day` - `bazi_pillars`: $0.01 per chart · `POST https://api.akifukaku.com/v1/mingge/bazi_pillars` - `calendar_convert`: $0.01 per date · `POST https://api.akifukaku.com/v1/mingge/calendar_convert` - `lexicon`: $0.01 per term · `POST https://api.akifukaku.com/v1/mingge/lexicon` - `ziwei_board`: $0.01 per chart · `POST https://api.akifukaku.com/v1/mingge/ziwei_board` - `cast_xiaoliuren`: $0.02 per cast · `POST https://api.akifukaku.com/v1/mingge/cast_xiaoliuren` - `draw_lingqian`: $0.02 per lot · `POST https://api.akifukaku.com/v1/mingge/draw_lingqian` - `bazi_chart`: $0.05 per chart · `POST https://api.akifukaku.com/v1/mingge/bazi_chart` - `bazi_period`: $0.05 per period · `POST https://api.akifukaku.com/v1/mingge/bazi_period` - `cast_liuren`: $0.05 per cast · `POST https://api.akifukaku.com/v1/mingge/cast_liuren` - `cast_liuyao`: $0.05 per cast · `POST https://api.akifukaku.com/v1/mingge/cast_liuyao` - `cast_meihua`: $0.05 per cast · `POST https://api.akifukaku.com/v1/mingge/cast_meihua` - `cast_qimen`: $0.05 per cast · `POST https://api.akifukaku.com/v1/mingge/cast_qimen` - `ziwei_chart`: $0.05 per chart · `POST https://api.akifukaku.com/v1/mingge/ziwei_chart` - `hepan`: $0.10 per pair · `POST https://api.akifukaku.com/v1/mingge/hepan` - `qizheng_transit`: $0.10 per moment · `POST https://api.akifukaku.com/v1/mingge/qizheng_transit` - `zeri_pick`: $0.10 per range · `POST https://api.akifukaku.com/v1/mingge/zeri_pick` - `ziwei_limits`: $0.10 per period · `POST https://api.akifukaku.com/v1/mingge/ziwei_limits` - `bazi_luck`: $0.15 per chart · `POST https://api.akifukaku.com/v1/mingge/bazi_luck` - `bazi_timing`: $0.15 per chart · `POST https://api.akifukaku.com/v1/mingge/bazi_timing` - `qizheng_chart`: $0.15 per chart · `POST https://api.akifukaku.com/v1/mingge/qizheng_chart` ## Payment - Prepaid credits (card or USDC): top-ups $5, $20, $100; new keys get $0.10 trial credit. Create a key with `POST https://api.akifukaku.com/v1/keys` (no signup). - x402 per call: USDC on Base; call without credentials, then retry with `PAYMENT-SIGNATURE` built from the 402's `PAYMENT-REQUIRED`. - MingGe account: connect over OAuth at https://mingge.org/mcp/account; a monthly allowance by plan is used first. - Failed calls are not charged. Identical input to the same tool from the same account is charged once per 30 days. ## Options Where traditions differ, every tool uses the same defaults as mingge.org. An `options` parameter for other schools opens in the next release. ## Privacy Birth data is computed in memory only: it is not stored and not written to logs. ## Agent skill # MingGe via Aki Agent API API: `https://api.akifukaku.com/v1/mingge/` (POST, JSON) · auth: `Authorization: Bearer $AKI_API_KEY` · schema: https://api.akifukaku.com/openapi.json · MCP: `https://api.akifukaku.com/mcp/mingge` ## Setup (once) If `AKI_API_KEY` is not set: `curl -s -X POST https://api.akifukaku.com/v1/keys -H 'Content-Type: application/json' -d '{"label":"my-agent"}'`. Save the returned `key` where the user keeps secrets (shown once; includes $0.10 trial credit). Out of credits (HTTP 402 `insufficient_credits`): `POST https://api.akifukaku.com/v1/credits/topup {"amount_usd": 5}` and give the user the returned `url` (card or USDC). Agents with a wallet can instead pay each call with x402 (USDC on Base): retry the request with the `PAYMENT-SIGNATURE` header built from the 402's `PAYMENT-REQUIRED`. ## Tools and prices - `birth_form` — free (API key required). 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). - `bazi_chart` — $0.05 per chart. 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. - `ziwei_chart` — $0.05 per chart. 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. - `hepan` — $0.10 per pair. 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. - `bazi_pillars` — $0.01 per chart. 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. - `ziwei_board` — $0.01 per chart. 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. - `calendar_convert` — $0.01 per date. 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. - `bazi_luck` — $0.15 per chart. 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. - `bazi_timing` — $0.15 per chart. 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. - `bazi_period` — $0.05 per period. 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. - `ziwei_limits` — $0.10 per period. Zi Wei Dou Shu limits for a year, month or day: decade, annual, monthly and daily palaces with flying four transformations and notes. - `qizheng_chart` — $0.15 per chart. 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. - `qizheng_transit` — $0.10 per moment. Qi Zheng Si Yu transits at a moment (default now) against the natal chart: where each luminary is and what it activates. - `zeri_pick` — $0.10 per range. 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. - `list_options` — free (API key required). The school / rule options each tool accepts (Qi Men centre palace and hidden stems, Liu Ren month general and noble person, day boundary, true solar time…): groups, ids, defaults and what each means. Free (API key required). - `my_charts` — free (API key required). 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. - `cast_liuyao` — $0.05 per cast. 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. - `cast_meihua` — $0.05 per cast. 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. - `cast_qimen` — $0.05 per cast. 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. - `cast_liuren` — $0.05 per cast. 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. - `cast_xiaoliuren` — $0.02 per cast. 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. - `draw_lingqian` — $0.02 per lot. 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. - `lexicon` — $0.01 per term. 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. - `almanac_day` — $0.005 per day. Chinese almanac (黄历) for a date: day pillars, do / avoid, day officer, solar term, clash. Failed calls (invalid input, engine cannot compute, service unavailable) are not charged. Repeat calls are free: the same API key calling the same tool with identical input is charged once per 30 days (response header `X-Replay: 1`). Calls whose result is random or depends on the current moment (coin casts, lot draws, casts without an explicit date and time) are charged every time. ## Charts 1. `birth_form` with what the user said → show the draft `form` (date, time, city, time zone) to the user and let them confirm or correct it. 2. `bazi_chart` / `ziwei_chart` with `{"birth":
, "gender": "male"|"female"}`; `hepan` with `a`, `genderA`, `b`, `genderB`, `relation`. Skeleton only (cheap, no judgement): `bazi_pillars`, `ziwei_board`. Deeper (MingGe members' content): `bazi_luck` (all luck decades), `bazi_timing` (life-event windows), `bazi_period` / `ziwei_limits` (a given year, month or day), `qizheng_chart` / `qizheng_transit`, `zeri_pick` (date selection). With a connected MingGe account (https://mingge.org/mcp/account), `my_charts` lists saved charts and every chart tool takes `chart_id` instead of `birth`. 3. Explain the result in the user's language. Quote scores with the scale given next to them. ## Divination One question per cast. Pick the `topic` that matches the question, and pass the asker's local date and time (`d`, `t`) or their IANA time zone (`tz`, casts for this moment). The result has the board and the engine's verdict (`verdict.headline`, `grounds`, `timing`). Verdict text is Chinese: translate, do not rewrite the judgement. ## Rules - Every judgement comes from the engine. Relay it; never recompute a chart, change a verdict or invent numbers. - Do not re-cast the same question to fish for a better answer. - This is cultural and reflective content, not medical, legal or financial advice. Say so when the question is about health, lawsuits or investments. - Nothing is stored server-side. Links in results open the full page on https://mingge.org. ## Tool reference ### birth_form `POST https://api.akifukaku.com/v1/mingge/birth_form` · MCP tool `birth_form` · free (API key required) per call 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). Input: - `text` (required): string (max 400 chars) — What the user said, e.g. "1990-05-01 14:30 Shanghai female" or "农历 1988 年十月十五 早上六点 北京 男" - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### list_options `POST https://api.akifukaku.com/v1/mingge/list_options` · MCP tool `list_options` · free (API key required) per call The school / rule options each tool accepts (Qi Men centre palace and hidden stems, Liu Ren month general and noble person, day boundary, true solar time…): groups, ids, defaults and what each means. Free (API key required). Input: - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### my_charts `POST https://api.akifukaku.com/v1/mingge/my_charts` · MCP tool `my_charts` · free (API key required) per call 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. Input: - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### almanac_day `POST https://api.akifukaku.com/v1/mingge/almanac_day` · MCP tool `almanac_day` · $0.005 per day Chinese almanac (黄历) for a date: day pillars, do / avoid, day officer, solar term, clash. Input: - `date`: string — YYYY-MM-DD; default today (UTC+8) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### bazi_pillars `POST https://api.akifukaku.com/v1/mingge/bazi_pillars` · MCP tool `bazi_pillars` · $0.01 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Optional (taken from the saved chart with chart_id); adds the luck-pillar skeleton - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### calendar_convert `POST https://api.akifukaku.com/v1/mingge/calendar_convert` · MCP tool `calendar_convert` · $0.01 per date 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. Input: - `date` (required): string — YYYY-MM-DD; with calendar=lunar this is the lunar year-month-day - `time`: string — HH:mm local clock time (for the hour pillar and true solar time) - `calendar`: "solar" | "lunar" — What `date` is in (default solar) - `leap`: boolean — calendar=lunar: the month is a leap month - `longitude`: number (-180–180) — For true solar time (east positive) - `tz`: string (max 64 chars) — IANA zone of the clock time - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### lexicon `POST https://api.akifukaku.com/v1/mingge/lexicon` · MCP tool `lexicon` · $0.01 per term 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. Input: - `term` (required): string (max 40 chars) — A term, star or pattern in Chinese, e.g. 天乙贵人, 七杀, 紫微, 伤官配印 - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### ziwei_board `POST https://api.akifukaku.com/v1/mingge/ziwei_board` · MCP tool `ziwei_board` · $0.01 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### cast_xiaoliuren `POST https://api.akifukaku.com/v1/mingge/cast_xiaoliuren` · MCP tool `cast_xiaoliuren` · $0.02 per cast 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `topic` (required): "wealth_seek" | "career_promo" | "job_seek" | "love_can" | "marriage" | "partnership" | "waiting_news" | "waiting_person" | "travel" | "lost_item" | "lawsuit" | "illness" | "other" — 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. - `d`: string — Asker's local date YYYY-MM-DD (with t) - `t`: string — Asker's local time HH:mm (with d) - `tz`: string (max 64 chars) — Asker's IANA time zone; alone = cast for this moment - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### draw_lingqian `POST https://api.akifukaku.com/v1/mingge/draw_lingqian` · MCP tool `draw_lingqian` · $0.02 per lot 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. Input: - `kind` (required): "guanyin" | "yuelao" | "guandi" — guanyin: Guanyin's 100 lots (general); yuelao: the Matchmaker's lots (love); guandi: Guan Di's 100 lots (general) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### bazi_chart `POST https://api.akifukaku.com/v1/mingge/bazi_chart` · MCP tool `bazi_chart` · $0.05 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Needed for luck decades (direction depends on gender); taken from the saved chart with chart_id - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### bazi_period `POST https://api.akifukaku.com/v1/mingge/bazi_period` · MCP tool `bazi_period` · $0.05 per period 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `year` (required): integer (1901–2099) — Year to read (Gregorian) - `month`: integer (1–12) — Gregorian month; read as the solar-term month containing the 15th - `day`: integer (1–31) — Day of that month (needs month) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### cast_liuren `POST https://api.akifukaku.com/v1/mingge/cast_liuren` · MCP tool `cast_liuren` · $0.05 per cast 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `topic` (required): "wealth_seek" | "career_promo" | "job_seek" | "love_can" | "marriage" | "partnership" | "waiting_news" | "waiting_person" | "travel" | "lost_item" | "lawsuit" | "illness" | "other" — 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`: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥" — Earthly branch of the asker's birth year (optional) - `d`: string — Asker's local date YYYY-MM-DD (with t) - `t`: string — Asker's local time HH:mm (with d) - `tz`: string (max 64 chars) — Asker's IANA time zone; alone = cast for this moment - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### cast_liuyao `POST https://api.akifukaku.com/v1/mingge/cast_liuyao` · MCP tool `cast_liuyao` · $0.05 per cast 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `topic` (required): "wealth_seek" | "career_promo" | "job_seek" | "exam" | "love_can" | "marriage" | "partnership" | "property" | "waiting_news" | "waiting_person" | "travel" | "lost_item" | "lawsuit" | "illness" | "family" | "other" — 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. - `variant`: string (max 24 chars) — 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 - `mode`: "coin" | "time" | "manual" — coin (default): the server tosses three coins six times; time: derived from the moment; manual: pass `values` - `values`: string — manual mode: six line values bottom to top, 6 old yin, 7 young yang, 8 young yin, 9 old yang - `d`: string — Asker's local date YYYY-MM-DD (with t) - `t`: string — Asker's local time HH:mm (with d) - `tz`: string (max 64 chars) — Asker's IANA time zone; alone = cast for this moment - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### cast_meihua `POST https://api.akifukaku.com/v1/mingge/cast_meihua` · MCP tool `cast_meihua` · $0.05 per cast 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `topic` (required): "wealth_seek" | "career_promo" | "job_seek" | "love_can" | "marriage" | "partnership" | "waiting_news" | "waiting_person" | "travel" | "lost_item" | "lawsuit" | "illness" | "other" — 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`: string (max 24 chars) - `way`: "now" | "number" — now (default): from the moment; number: from two numbers the asker thought of - `a`: integer (1–99999) — way=number: first number - `b`: integer (1–99999) — 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 (max 64 chars) — Asker's IANA time zone; alone = cast for this moment - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### cast_qimen `POST https://api.akifukaku.com/v1/mingge/cast_qimen` · MCP tool `cast_qimen` · $0.05 per cast 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `topic` (required): "wealth_seek" | "career_promo" | "job_seek" | "love_can" | "marriage" | "partnership" | "waiting_news" | "waiting_person" | "travel" | "lost_item" | "lawsuit" | "illness" | "other" — 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`: "zi23" | "midnight" — When the day changes: 23:00 (default) or midnight - `d`: string — Asker's local date YYYY-MM-DD (with t) - `t`: string — Asker's local time HH:mm (with d) - `tz`: string (max 64 chars) — Asker's IANA time zone; alone = cast for this moment - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### ziwei_chart `POST https://api.akifukaku.com/v1/mingge/ziwei_chart` · MCP tool `ziwei_chart` · $0.05 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth`; taken from the saved chart with chart_id - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### hepan `POST https://api.akifukaku.com/v1/mingge/hepan` · MCP tool `hepan` · $0.10 per pair 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `a`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id_a`: string (max 80 chars) — Instead of `a`: a saved chart id (needs a connected MingGe account) - `genderA`: "male" | "female" — Required with `a` - `b`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id_b`: string (max 80 chars) — Instead of `b`: a saved chart id (needs a connected MingGe account) - `genderB`: "male" | "female" — Required with `b` - `relation` (required): "romance" | "partner" | "friend" | "family" — romance = love / marriage, partner = business, friend, family - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### qizheng_transit `POST https://api.akifukaku.com/v1/mingge/qizheng_transit` · MCP tool `qizheng_transit` · $0.10 per moment Qi Zheng Si Yu transits at a moment (default now) against the natal chart: where each luminary is and what it activates. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `at`: string — Moment to read, local clock time YYYY-MM-DDTHH:mm (default: now) - `tz`: string (max 64 chars) — IANA zone of `at` - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### zeri_pick `POST https://api.akifukaku.com/v1/mingge/zeri_pick` · MCP tool `zeri_pick` · $0.10 per range 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `event` (required): "jiaqu" | "dinghun" | "ruzhai" | "kaiye" | "jiaoyi" | "dongtu" | "chuxing" | "qiuyi" — 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 - `from` (required): string — First day YYYY-MM-DD - `to` (required): string — Last day YYYY-MM-DD (up to about a year) - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### ziwei_limits `POST https://api.akifukaku.com/v1/mingge/ziwei_limits` · MCP tool `ziwei_limits` · $0.10 per period Zi Wei Dou Shu limits for a year, month or day: decade, annual, monthly and daily palaces with flying four transformations and notes. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `year` (required): integer (1901–2099) — Year to read (Gregorian) - `month`: integer (1–12) — Gregorian month; read as the solar-term month containing the 15th - `day`: integer (1–31) — Day of that month (needs month) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### bazi_luck `POST https://api.akifukaku.com/v1/mingge/bazi_luck` · MCP tool `bazi_luck` · $0.15 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### bazi_timing `POST https://api.akifukaku.com/v1/mingge/bazi_timing` · MCP tool `bazi_timing` · $0.15 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `domain`: "parents" | "peers" | "home" | "marriage" | "children" | "career" | "wealth" | "move" | "health" — Only this life area (default: all) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese. ### qizheng_chart `POST https://api.akifukaku.com/v1/mingge/qizheng_chart` · MCP tool `qizheng_chart` · $0.15 per chart 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. Input: - `options`: object — School / rule options as { group: id }; defaults match mingge.org. See list_options for groups and ids. - `birth`: object — Birth data in local clock time at the birthplace. Use birth_form to build it from a sentence. - `year` (required): integer (1900–2100) - `month` (required): integer (1–12) - `day` (required): integer (1–31) - `hour` (required): integer (0–23) - `minute`: integer (0–59) - `longitude`: number (-180–180) — Birthplace longitude (east positive); enables true solar time - `standardMeridian`: number — Standard meridian of the birthplace clock at that time (e.g. 120 for UTC+8) - `cityName`: string (max 80 chars) - `tz`: string (max 64 chars) — IANA zone of the birthplace, e.g. Asia/Shanghai - `dstOff`: boolean - `chart_id`: string (max 80 chars) — Instead of `birth`: the id of one of the user's saved charts (from my_charts). Needs a connected MingGe account. - `gender`: "male" | "female" — Required with `birth` (taken from the saved chart with chart_id) - `lang`: "en" | "zh-CN" | "ja" | "ko" — Language of names and links (default en). Classical terms stay in Chinese.