Qimena Qi Men Dun Jia & BaZi

Official registry Other

Qi Men Dun Jia charts, BaZi Four Pillars, best-time ranking and solar terms. Free, no key.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http qimena-qi-men-dun-jia-bazi 'https://qimena.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "qimena-qi-men-dun-jia-bazi": {
            "type": "http",
            "url": "https://qimena.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Qimena MCP Server · 天衍奇门 MCP 服务
  2. Tools
  3. Connect
  4. Try it
  5. Limits and notes
  6. Contact
  7. 中文说明

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

ToolWhat it returns
qimen_chartAn hour-based Qi Men Dun Jia chart for a moment and place: four pillars, ju, Chief Star and Door, and for each of the nine palaces the deity, star, door, heaven/earth/hidden stems, void, horse star, punishment and door pressure, plus patterns, palace scores and lucky directions.
bazi_pillarsFour Pillars for a birth moment. Converts clock time to true solar time using that date's zone rules (daylight saving included) and the longitude. The year follows Li Chun; the day changes at 23:00 true solar time. Returns the pillars, Day Master and five-element counts.
best_timesCasts a chart for every double-hour of the next 1 to 7 days and ranks them for a goal (general, career, wealth, love), using the person's Day Master. Returns the top windows with time range, score and lucky direction.
solar_termsThe 24 solar terms of any year from 1900 to 2100, with UTC and Beijing-time instants (within about a minute of the Hong Kong Observatory).
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。

四个工具
工具作用
qimen_chart按时间和地点起时家奇门盘:四柱、局数、值符值使,九宫的八神、九星、八门、天盘地盘暗干、空亡、驿马、击刑、门迫,以及格局、宫位评分和吉方。
bazi_pillars按出生时间排八字:用出生当天的时区规则(含夏令时)和经度换算真太阳时;年柱以立春为界,23:00(真太阳时)换日。返回四柱、日主和五行数量。
best_times把未来 1–7 天的每个时辰都起一盘,按目标(综合、事业、财运、感情)和本人日主排序,返回最好的几个时段、评分和当时的吉方。
solar_terms1900–2100 年任一年的二十四节气时刻(UTC 和北京时间,与香港天文台相差约一分钟以内)。
连接

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 年立春是哪天几点?”
说明

联系:support@qimena.com

Frequently asked questions

What is Qimena Qi Men Dun Jia & BaZi?

Qi Men Dun Jia charts, BaZi Four Pillars, best-time ranking and solar terms. Free, no key.

How do I install Qimena Qi Men Dun Jia & BaZi?

It runs as a remote server. In Claude Code: claude mcp add --transport http qimena-qi-men-dun-jia-bazi 'https://qimena.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Qimena Qi Men Dun Jia & BaZi need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Qimena Qi Men Dun Jia & BaZi open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Qimena Qi Men Dun Jia & BaZi?

It is published by David-rider. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.