QiyueAstro MCP Server 🎴☯️

MCP (Model Context Protocol) server for Eastern & Western divination — tarot, Lenormand, I Ching, Meihua, Qi Men, BaZi, Zi Wei Dou Shu, Xiao Liu Ren and Da Liu Ren.

Works with Claude Desktop, Cursor, OpenClaw, Zed and any MCP client. No API key, no signup — data comes from the free QiyueAstro public API.

✨ Tools

Tool	Description
draw_tarot	Draw tarot cards — 13 spreads (single, three-card, celtic-cross, yes-or-no, love…) or N cards
browse_tarot	Browse the 78-card Rider-Waite deck, card details by id
list_tarot_spreads	List all available tarot spreads
draw_lenormand	Draw Lenormand cards — 8 spreads (three, relationship, decision, nine-card grid, grand-tableau…)
browse_lenormand	Browse the 36-card Lenormand deck
cast_iching	I Ching hexagram casting (coins / time / numbers), moving lines + changed hexagram
get_hexagram	Look up any of the 64 hexagrams (id or binary)
cast_meihua	Meihua Yishu casting (time / numbers) with Ti/Yong analysis
cast_qimen	Qi Men Dun Jia chart layout
bazi_chart	BaZi (Four Pillars) chart — pillars, WuXing counts, DaYun
ziwei_chart	Zi Wei Dou Shu chart — 12 palaces, major stars, brightness
cast_xiaoliuren	Xiao Liu Ren quick divination (Da An, Liu Lian, Su Xi…)
cast_liuren	Da Liu Ren lesson casting — four lessons, three transmissions

🚀 Install

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "qiyue": {
      "command": "npx",
      "args": ["-y", "github:BloodymaryGG/qiyue-mcp"]
    }
  }
}

Cursor

Settings → MCP → Add new server:

Name: qiyue
Type: command
Command: npx -y github:BloodymaryGG/qiyue-mcp

OpenClaw

openclaw mcp add qiyue -- npx -y github:BloodymaryGG/qiyue-mcp

Manual (from source)

git clone https://github.com/BloodymaryGG/qiyue-mcp
cd qiyue-mcp
npm install
node index.mjs   # stdio MCP server

Test without a client

npm install
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node index.mjs

🧩 Example prompts

• "Draw a three-card tarot spread about my career"
• "Cast the I Ching — should I accept the job offer?"
• "What does The Tower card mean?"
• "Give me my BaZi chart for 1998-06-15 12:00, male"
• "小六壬看一下今天运势"

🌙 About QiyueAstro

QiyueAstro (栖月) — a full divination platform with 14 modules, AI-powered readings in 9 languages, free daily credits, and shareable reading cards. The MCP server above is a thin wrapper over its free public API.

📄 License

MIT. Card art is public-domain Rider-Waite-Smith line art.

---

Built with ❤️ by BloodymaryGG · qiyueastro.com