qimen-oracle

奇门遁甲 (Qi Men Dun Jia) MCP server. Deterministic. No LLM drift.

Rule-based Chinese metaphysics calculation engine — same inputs, same outputs. Pay-per-call via x402 USDC on Base. First 3 calls free per UA.

This package is a thin shim over xuanxue-bazi-matching, pre-filtered to expose: qimen_timing ($0.05/call).

Install

Claude Desktop

{
  "mcpServers": {
    "qimen-oracle": {
      "command": "npx",
      "args": ["-y", "qimen-oracle"]
    }
  }
}

Sister packages

• four-pillars — 八字 BaZi
• purple-star-astrology — 紫微斗数
• plum-blossom-oracle — 梅花易数
• qimen-oracle — 奇门遁甲
• da-liuren — 大六壬
• iching-liuyao — 六爻纳甲
• chinese-astrology-mcp — all 7 tools

Why deterministic, not LLM-based?

Chinese divination is a date conversion + lookup table problem. LLMs hallucinate the day pillar when crossing midnight, invent shen-sha (神煞) names, and silently apply wrong solar-term cutoffs. We solve this with a real rule engine.

Web frontend (for humans)

Want a natural-language synthesis instead of raw chart data? decodeyourming.com offers a $1.99 destiny report combining all 6 systems.

License

MIT — calculation logic is open. Hosted endpoint, x402 settlement, and aggregation are paid.

Publisher: xuanxue.app · Contact: [email protected] · Source: github.com/jasonwagao-bit/m2m