MingGe API changelog
Every change to the MingGe agent interface: new tools, engine changes that alter results, billing and price changes. Responses carry engine_version; it matches the version shown here. Machine-readable: changelog.json.
Current engine version: te-e248fd2794.
Policy
- Price changes are announced here at least 14 days before they take effect. Live prices are always at api.akifukaku.com/v1/pricing.
- A change in the engine that alters results changes
engine_versionand gets an entry here. Same input and same engine version give byte-identical results. - Response fields are only added, never renamed or removed without an entry here.
BaZi day_boundary and Zi Wei leap_month options
BaZi tools (bazi_chart, bazi_pillars, bazi_luck, bazi_timing, bazi_period, zeri_pick, hepan) accept options.day_boundary: zi23 (default, 23:00 starts the new day) or midnight (the day pillar changes at 0:00; the late Zi hour stem follows the next day, as the external charts we checked do). Zi Wei tools (ziwei_chart, ziwei_board, ziwei_limits) accept options.leap_month: split15 (default, the leap month is split at the 15th) or self (the whole leap month counts as its own month). Both were cross-checked against external charting sites before opening (24/24 BaZi pillars, 16/16 Zi Wei charts). Defaults are unchanged.
Tools: bazi_chart, bazi_pillars, bazi_luck, bazi_timing, bazi_period, zeri_pick, hepan, ziwei_chart, ziwei_board, ziwei_limits
Accuracy page, verify_vectors and this changelog
/agents/accuracy lists every external charting site we cross-check against, how many cases and how many match. The free tool verify_vectors returns those cases as ready-to-send tool inputs with the expected results, so an agent can check us itself.
Tools: verify_vectors
cast_qimen: yuan_rule option; the default now matches mingge.org
New option group yuan_rule for cast_qimen: zhirun (intercalation, default), chaibu (split-and-patch) or maoshan. Without it, casts used to fix the round with the Maoshan method; they now use intercalation, the same default as mingge.org. Casts that pass options.yuan_rule explicitly are unaffected by any future default.
Tools: cast_qimen, list_options
engine_version in every response
Every response carries engine_version, read from the engine's own version constant. It changes only when the engine changes; the current value is shown at the top of this page.
x402 payments inside MCP; wallet repeats are free
An MCP client holding only a wallet can pay per call with x402 inside the MCP session (_meta["x402/payment"]), without an API key. Receipts are kept per paying wallet: the same wallet sending identical input to the same tool within 30 days is verified but not charged again.
reading_pack bundle
reading_pack returns bazi_chart, bazi_luck and bazi_timing for one chart in one call, at $0.30 at launch (the three bought separately: $0.35).
Tools: reading_pack
School options: options, list_options, options_used
Casting and chart tools accept options: { "<group>": "<id>" } where traditions differ; omitted groups use the same defaults as mingge.org. The free tool list_options lists every group, its choices, default and reasoning; every response reports options_used. Casts: all registered groups of the five doors (Qi Men rotating plate only). Charts: true_solar_time. Different options count as different input for billing.
Tools: list_options
Catalog in tiers and ten new tools
The catalog is split into tiers. Chart skeleton at $0.01: bazi_pillars, ziwei_board, calendar_convert. Judgement tools: bazi_period $0.05; ziwei_limits, qizheng_transit, zeri_pick $0.10; bazi_luck, bazi_timing, qizheng_chart $0.15 (launch prices).
Tools: bazi_pillars, ziwei_board, calendar_convert, bazi_period, ziwei_limits, qizheng_transit, zeri_pick, bazi_luck, bazi_timing, qizheng_chart
Sign in with a MingGe account; monthly allowance
Connect at https://mingge.org/mcp/account with MingGe OAuth. Accounts get a monthly API allowance by plan (free account $0.20, member $1.50, Pro $4.00 at launch), used before prepaid credits and not carried over. my_charts lists saved charts and chart tools accept chart_id in place of birth.
Tools: my_charts
Repeat calls are free for 30 days
The same account calling the same tool with identical input is charged once per 30 days (key order and lang do not count as differences). A repeat returns X-Replay: 1 over REST and _meta.billing over MCP. Casts whose result is random or follows the moment of asking are charged every time.
Paid MCP server reopens with 16 tools
https://mingge.org/mcp reopens as a pay-per-call MCP server and REST API (prepaid credits or x402 USDC). First 16 tools: 12 MingGe tools (birth_form, bazi_chart, ziwei_chart, hepan, almanac_day, lexicon, cast_liuyao, cast_meihua, cast_qimen, cast_liuren, cast_xiaoliuren, draw_lingqian) and 4 account tools (create_api_key, get_balance, topup_link, get_pricing). Launch prices: charts and four-door casts $0.05, hepan $0.10, cast_xiaoliuren and draw_lingqian $0.02, lexicon $0.01, almanac_day $0.005, birth_form free.
Tools: birth_form, bazi_chart, ziwei_chart, hepan, almanac_day, lexicon, cast_liuyao, cast_meihua, cast_qimen, cast_liuren, cast_xiaoliuren, draw_lingqian, create_api_key, get_balance, topup_link, get_pricing