io.github.jasonwagao-bit/xuanxue-bazi-matching

Official

by jasonwagao-bit · Python

Deterministic Chinese divination APIs (BaZi/QiMen/ZiWei/MeiHua/LiuYao/LiuRen) x402 on Base.

Deterministic Chinese divination APIs (BaZi/QiMen/ZiWei/MeiHua/LiuYao/LiuRen) x402 on Base. This MCP server provides deterministic results across multiple BaZi-style calculations, framed for integration and testing.

🛠️ Key Features

Deterministic Chinese divination API suite
Supports BaZi, QiMen, ZiWei, MeiHua, LiuYao, LiuRen
402 variants on a Base model

🚀 Use Cases

Integrate multiple divination calculations into apps
Build deterministic testing for astrology-related logic
Explore layered BaZi-style insights across tools

⚡ Developer Benefits

Clear naming and modular API surface for multi-tool calculations
Grounded in a single, base model with variant count
Lightweight for cataloging and discovery

⚠️ Limitations

Description limited to existing fields: slug, name, description, and toolCount
No external readme excerpt provided to expand features further

Install

Configuration

Environment variables

XUANXUE_PAYMENT_TOKENsecret

x402 payment token for pay-per-call billing (USDC on Base). Omit to receive 402 Payment Required challenges with payment instructions.

XUANXUE_API_BASE

Override API base URL. Defaults to https://api.decodeyourming.com

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "xuanxue-bazi-matching": {
      "command": "npx",
      "args": [
        "-y",
        "xuanxue-bazi-matching@0.2.0"
      ],
      "env": {
        "XUANXUE_PAYMENT_TOKEN": "<YOUR_XUANXUE_PAYMENT_TOKEN>",
        "XUANXUE_API_BASE": "<YOUR_XUANXUE_API_BASE>"
      }
    }
  }
}