MCP API & EXTENSION

Let every AI model cast charts for you

The same engines behind this site — Bazi casting and the classical TCM knowledge base — are open as MCP tools. Claude, GPT, Kimi, Cursor and our Chrome extension all bill through one wallet.

MCP SERVER

Eleven tools, one API key

JSON-RPC over stdio or HTTP. Every call is metered per tool; free daily quotas keep experimentation at zero cost.

ToolWhat it doesPriceFree quota/day
bazi_castCast a full Four-Pillars chart: pillars, ten-gods, hidden stems, na-yin, luck cycles$0.00250
bazi_five_elementsFive-element strength distribution$0.00150
tcm_searchSearch 234 formulas & 50 patterns by symptom$0.00520
tcm_formula_detailFormula detail: composition, indication, contraindication$0.00510
bazi_interpretationAI prose interpretation (personality / love / career / wealth)$0.10—
report_quoteReport prices & order links — your conversion hookfreeunlimited
account_usagePlan, usage & pricing lookupfreeunlimited
developer_dashboardBalance, ledger, call logs, inviteesfreeunlimited
developer_rechargeRecharge wallet (Stripe in production)freeunlimited
developer_create_keyCreate key, optionally bound to inviterfreeunlimited
developer_reset_keyRotate key — old key revoked instantlyfreeunlimited
QUICKSTART

Running in two lines

claude_desktop_config.json
// 1. 挂进 Claude / Kimi / Cursor — stdio
{
  "mcpServers": {
    "veilchart": { "command": "node", "args": ["/path/mcp-server/server.js"] }
  }
}
HTTP / JSON-RPC — tools/call
// 2. 或走 HTTP 端点(生产)
curl https://api.veilchart.com/mcp \
  -H "Authorization: Bearer gy_xxx" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"bazi_cast",
        "arguments":{"apiKey":"gy_xxx","year":1990,"month":5,"day":20,
                     "hour":14,"gender":"female"}}}'
CHROME EXTENSION

Bazi & TCM, on any webpage

Popup + side panel + right-click menu. When the API is unreachable it casts charts locally — free and unmetered — so the extension always works.

EXT·01

Popup casting

Birth data in, chart out — metered via your key, 50 free casts daily.

EXT·02

Right-click lookup

Select any text on any page → search the TCM knowledge base instantly.

EXT·03

Offline fallback

Built-in calendar engine casts charts without network — a free acquisition hook.

EXT·04

Usage panel

Plan, balance and spend, one click away.

Install (developer mode)

01

Open chrome://extensions and enable Developer mode

02

“Load unpacked” → choose the chrome-extension/ folder

03

Click the toolbar icon and paste your gy_… API key

04

Pin it — select text anywhere, right-click, look it up

Every key can carry an inviter. 3% of an invited user\'s paid spend is credited to the inviter\'s balance in real time — forever.