{
  "title": "MingGe API changelog",
  "lead": [
    "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](https://mingge.org/agents/changelog.json)."
  ],
  "policy": [
    "Price changes are announced here at least 14 days before they take effect. Live prices are always at [api.akifukaku.com/v1/pricing](https://api.akifukaku.com/v1/pricing).",
    "A change in the engine that alters results changes `engine_version` and 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."
  ],
  "entries": [
    {
      "date": "2026-11-17",
      "kind": "options",
      "title": "BaZi day_boundary and Zi Wei leap_month options",
      "body": "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.",
      "zh": "八字类工具开放 `options.day_boundary`（`zi23` 缺省 23:00 换日 / `midnight` 0:00 换日，晚子时时干按次日日干起），紫微类工具开放 `options.leap_month`（`split15` 缺省十五日分界 / `self` 闰月整月按本月）；上线前与外部排盘对拍（八字 24/24、紫微 16/16），缺省不变。",
      "tools": [
        "bazi_chart",
        "bazi_pillars",
        "bazi_luck",
        "bazi_timing",
        "bazi_period",
        "zeri_pick",
        "hepan",
        "ziwei_chart",
        "ziwei_board",
        "ziwei_limits"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "docs",
      "title": "Accuracy page, verify_vectors and this changelog",
      "body": "[/agents/accuracy](https://mingge.org/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.",
      "zh": "公开对拍页 /agents/accuracy：每一门和哪些外部排盘对拍、多少例、对上多少。新增免费工具 `verify_vectors`：取公开样例（可直接调用的入参 + 期望结果），agent 自己核对。",
      "tools": [
        "verify_vectors"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "engine",
      "title": "cast_qimen: yuan_rule option; the default now matches mingge.org",
      "body": "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.",
      "zh": "奇门起课加口径组 `yuan_rule`（置闰 zhirun 为缺省 / 拆补 chaibu / 茅山 maoshan）。此前不带参数时按茅山法定元，现在与网站一致按置闰法。",
      "tools": [
        "cast_qimen",
        "list_options"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "engine",
      "title": "engine_version in every response",
      "body": "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.",
      "zh": "每个回包带 `engine_version`，取引擎自己的版本常量；只有引擎改了才变，现行值见本页顶部。"
    },
    {
      "date": "2026-11-17",
      "kind": "billing",
      "title": "x402 payments inside MCP; wallet repeats are free",
      "body": "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.",
      "zh": "MCP 通道内可直接 x402 现付（`_meta[\"x402/payment\"]`），只有钱包、没有 key 也能调用。钱包现付按付款地址认收据：同一钱包同一工具同一入参 30 天内只收一次。"
    },
    {
      "date": "2026-11-17",
      "kind": "tools",
      "title": "reading_pack bundle",
      "body": "`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).",
      "zh": "套餐 `reading_pack`：一次给齐 bazi_chart + bazi_luck + bazi_timing，首发价 $0.30（单买合计 $0.35）。",
      "tools": [
        "reading_pack"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "options",
      "title": "School options: options, list_options, options_used",
      "body": "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.",
      "zh": "流派口径参数：起课与排盘类工具收 `options`，缺省与网站一致；免费的 `list_options` 列出各组、选项、缺省与依据；回包带 `options_used`。起课五门开放已登记的全部组（奇门只开转盘），排盘类开真太阳时开关。",
      "tools": [
        "list_options"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "pricing",
      "title": "Catalog in tiers and ten new tools",
      "body": "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).",
      "zh": "目录分层并新增十个工具：骨架 $0.01（bazi_pillars / ziwei_board / calendar_convert）；判断层 bazi_period $0.05，ziwei_limits / qizheng_transit / zeri_pick $0.10，bazi_luck / bazi_timing / qizheng_chart $0.15（首发价）。",
      "tools": [
        "bazi_pillars",
        "ziwei_board",
        "calendar_convert",
        "bazi_period",
        "ziwei_limits",
        "qizheng_transit",
        "zeri_pick",
        "bazi_luck",
        "bazi_timing",
        "qizheng_chart"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "account",
      "title": "Sign in with a MingGe account; monthly allowance",
      "body": "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`.",
      "zh": "命格账号接入 `/mcp/account`（OAuth 登录）；会员每月送接口额度（免费 $0.20 / 会员 $1.50 / 专业版 $4.00，首发口径），先用送的、不结转；`my_charts` 与 `chart_id` 读自己的存档。",
      "tools": [
        "my_charts"
      ]
    },
    {
      "date": "2026-11-17",
      "kind": "billing",
      "title": "Repeat calls are free for 30 days",
      "body": "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.",
      "zh": "重查免费：同一账户、同一工具、同一入参 30 天内只收一次；随机或跟着「此刻」走的结果每次都收。"
    },
    {
      "date": "2026-11-17",
      "kind": "launch",
      "title": "Paid MCP server reopens with 16 tools",
      "body": "`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.",
      "zh": "付费版 MCP 重开（mingge.org/mcp，按次收费：预充值或 x402 USDC），首批 16 个工具：12 个命格工具 + 4 个账户工具。首发价：排盘与四门起课 $0.05、合盘 $0.10、小六壬与灵签 $0.02、词条 $0.01、黄历 $0.005、生辰解析免费。",
      "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"
      ]
    }
  ],
  "engine_version": "te-e248fd2794",
  "page": "https://mingge.org/agents/changelog"
}