Qimena Qi Men Dun Jia & BaZi

Qimena MCP Server · 天衍奇门 MCP 服务

Free, hosted Model Context Protocol server for Qi Men Dun Jia (奇门遁甲) and BaZi Four Pillars (八字) calculations, from Qimena.

• Endpoint: https://qimena.com/mcp
• Transport: Streamable HTTP (stateless)
• Auth: none, no API key
• Data: nothing you send is stored
• Cost: free

The tools are deterministic: the same engine as the qimena.com website, with no AI model behind them. Your assistant does the interpreting; the server does the calendar and chart maths.

This repository holds documentation only. The server runs at qimena.com.

中文说明

---

Tools

Parameters

qimen_chart

• datetime: local time "YYYY-MM-DDTHH:mm" in timezone. Omit for now.
• timezone: IANA zone such as "Asia/Shanghai" or "America/New_York". Default Asia/Shanghai.
• longitude: degrees, east positive. Default: the zone's standard meridian.
• focus: general, career, wealth or love. Default general.

bazi_pillars

• birth_datetime (required): "YYYY-MM-DDTHH:mm", as on the birth certificate.
• timezone (required): IANA zone of the birthplace.
• longitude: birthplace longitude, east positive.

best_times

• birth_date (required): "YYYY-MM-DD".
• focus: general, career, wealth or love.
• longitude: where the person is now. Default 120.
• days: 1 to 7. Default 7.
• top: 1 to 10. Default 5.

solar_terms

• year (required): 1900 to 2100.

Connect

Claude Code

claude mcp add --transport http qimena https://qimena.com/mcp

Claude Desktop (claude_desktop_config.json, through mcp-remote)

{

"mcpServers": { "qimena": { "command": "npx", "args": ["-y", "mcp-remote", "https://qimena.com/mcp"] } } }

Cursor (~/.cursor/mcp.json)

{

"mcpServers": { "qimena": { "url": "https://qimena.com/mcp" } } }

VS Code (.vscode/mcp.json)

{

"servers": { "qimena": { "type": "http", "url": "https://qimena.com/mcp" } } }

Any other client that speaks Streamable HTTP can use the URL directly.

Try it

Ask your assistant things like:

• "Cast a Qi Men chart for now in New York and tell me the best direction for a business meeting."
• "What are my BaZi pillars? I was born 1990-05-17 08:30 in Shanghai."
• "Born 1985-11-02. Which double-hours in the next three days are best for signing a contract?"
• "When is Li Chun in 2027?"

Or call it directly:

curl -s https://qimena.com/mcp \

-H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"solar_terms","arguments":{"year":2027}}}'

Limits and notes

• About 60 requests a minute per IP address.
• Calculation rules and how they were checked: Qi Men calculation rules.
• More about the server: Qimena MCP Server.
• Results are for cultural and reference use, not professional advice.

Contact

support@qimena.com · qimena.com

---

中文说明

天衍奇门（qimena.com）提供的免费 MCP 服务，让 AI 助手可以直接调用奇门遁甲和八字排盘。

• 地址： https://qimena.com/mcp
• 连接方式： Streamable HTTP（无状态）
• 不需要密钥，免费使用，不保存您发送的任何内容。

工具都是确定性计算，和 qimena.com 网站用的是同一套排盘引擎，背后没有 AI 模型：排盘和历法由服务器算，解读由您的 AI 助手完成。本仓库只放说明文档，服务运行在 qimena.com。

四个工具

连接

Claude Code：

claude mcp add --transport http qimena https://qimena.com/mcp

其他客户端的配置见上面英文部分的 Connect（Claude Desktop、Cursor、VS Code）。

可以这样问

• “用纽约现在的时间起一盘奇门，看看商务见面往哪个方向好。”
• “我 1990-05-17 08:30 生于上海，八字是什么？”
• “我生于 1985-11-02，未来三天哪个时辰适合签合同？”
• “2027 年立春是哪天几点？”

说明

• 每个 IP 每分钟约 60 次请求。
• 排盘规则与验证：奇门排盘规则
• 服务介绍：天衍奇门 MCP 服务
• 结果仅供文化研究与参考，不构成专业建议。

联系：support@qimena.com