格局 GrandScheme

Agents

An agent can cast a free 紫微斗數 or 八字 chart, then open a Stripe Checkout link for a paid 格局命書. No API key and no login. The human must open or approve the link, or the agent may pay it if its owner has granted payment permission.

Flow

Call get_pricing to see products, currencies, and timing.
Call cast_free_chart with date, time, gender, and optional longitude. The chart is free.
Call create_order. Give the returned checkout_url to the human, or pay it yourself if you are allowed to.
Poll get_order_status about every 5 minutes. When status is ready, open the HTML or PDF link.

Timing

A full book takes about 30–40 minutes and is written one at a time. A combo is two books in sequence, so allow about 60–80 minutes plus anyone already waiting. The 2026 year guide is shorter, and it still waits in the same queue. The status response includes queue position and minutes remaining. Do not promise a faster delivery.

Currencies

Pass currency on create_order: HKD, SGD, TWD, CNY, USD, EUR, or GBP. Singapore and Taiwan have their own amounts. Malaysia can use SGD or USD. Any other code is charged in HKD. Prices are the live amounts, not a separate agent price.

Tools and REST

get_pricing — GET /api/agent/v1/pricing
cast_free_chart — POST /api/agent/v1/charts
create_order — POST /api/agent/v1/orders. Optional header Idempotency-Key.
get_order_status — GET /api/agent/v1/orders/{order_id}

Every JSON body has a summary field. OpenAPI: /openapi.json. MCP: /mcp (POST JSON-RPC, stateless).

curl -s https://www.grandscheme.life/api/agent/v1/charts \
  -H 'content-type: application/json' \
  -d '{"system":"bazi","date":"1990-01-01","time":"08:30","gender":"female","longitude":114.17,"tzOffset":8}'

Callbacks

If create_order includes callback_url, GrandScheme POSTs JSON when the order is paid, when writing starts, when every book is ready, and if writing fails. The URL must be public https. The response includes callback_secret. Verify header X-GrandScheme-Signature: t=<unix>,v1=<hex hmac sha256 of timestamp.body>. The buyer also gets one email when the book is ready.

MCP config

{
  "mcpServers": {
    "grandscheme": {
      "url": "https://www.grandscheme.life/mcp"
    }
  }
}

中文

代理可以免費排紫微或八字，再取得 Stripe 付款連結去買格局命書。不需要 API key，也不用登入。付款連結要由人打開或批准；如果主人已經授權付款，代理也可以自己付。

完整命書大約 30–40 分鐘，一次只寫一本。雙系統是兩本先後寫，所以大約 60–80 分鐘，還要加上前面排隊的人。2026 羊年指南較短，但同樣要排隊。請大約每 5 分鐘查一次狀態，不要答應更快。

貨幣可以是 HKD、SGD、TWD、CNY、USD、EUR、GBP。新加坡和台灣有自己的價錢。馬來西亞可以用 SGD 或 USD。寫好之後，結帳電郵會收到連結，狀態頁也會顯示閱讀和 PDF。