命盘 Mingpan
命盘 Mingpan is a Chinese traditional metaphysics (术数) MCP computation engine that provides deterministic chart-casting and divination for AI clients, usable remotely at https://mingpan.bzwai.com/mcp or locally via npx mingpan.
Bazi (八字) charts:
bazi_basicfour-pillar chart with hidden stems, ten gods, nayin, twelve stages, ming gong/tai yuan, void branches; plusbazi_dayun,bazi_liunian,bazi_liuyue(solar-term months),bazi_liuri.Ziwei Doushu (紫微斗数) charts:
ziwei_basictwelve palaces, main/auxiliary stars, brightness, five-element bureau, four transformations; plusziwei_daxian,ziwei_xiaoxian,ziwei_liunian,ziwei_liuyue,ziwei_liuri.Divination:
liuyao_basic(six-yao with najia, six relatives, six spirits, shi/ying),meihua_basic(Plum Blossom by time or numbers, ben/bian/hu gua, ti-yong),daliuren_basic(Da Liu Ren with heaven-earth plates, four lessons, three transmissions, twelve generals).Qimen Dunjia (奇门遁甲):
qimen_basicnine-palace layout with three wonders/six instruments, eight gates, nine stars, eight gods, pattern detection;qimen_yongshendeity-useful-god analysis for 14 topic types with 0–100 scoring;qimen_zeriauspicious date/time selection over a date range.Calendar primitives:
jieqi_queryfor second-precise 24 solar terms andcalendar_convertfor solar/lunar conversion with leap months and ganzhi.Broad input support: 1900–2100 dates, lunar or solar input, IANA
timezoneconversion to Beijing time, longitude-based true solar time, and options for pan type/style and leap-placement method.Note: the server schema advertises extra options (e.g.
detail,includeDaYun/includeAnalysis, strength/pattern analysis inbazi_basic) andqimen_zerithat are not all listed in the README, while the README states only deterministic casting data is output and interpretation is left to the AI.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@命盘 Mingpan排八字命盘,1992年4月12日7点30分,男性"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
命盘 MCP Server
命盘(Mingpan) 是一个开源的中华传统术数 MCP 计算引擎,为 AI 应用提供命理排盘与占卜起卦能力。BaziWei 同时维护可直接使用的官方远程服务。
立即使用官方 MCP
将下面的端点添加到支持 Remote MCP / Streamable HTTP 的 AI 客户端:
https://mingpan.bzwai.com/mcp无需安装 Node.js,也无需自行部署服务器。添加后可以直接尝试:
请帮我排一个八字命盘,1992年4月12日7点30分,男性
请帮我起一个奇门遁甲时盘,2024年6月21日10点
先访问 Mingpan 开源项目网站 可查看能力范围与连接说明。官方服务由 BaziWei 维护;源代码与计算口径继续在本仓库公开,方便审阅、复现与共同改进。
Related MCP server: taibu
特性
MCP 原生:无缝集成 Claude Desktop 及 Claude Code
🌏 中文输出:以简体为主,术语保持传统
📊 结构化文本:便于 AI 理解与分析的格式
🕐 多时区支持:海外出生/起卦时间自动换算为北京时间排盘
使用方式
形态 | 适用 | 用法 |
官方远程 MCP(推荐) | 支持 Remote MCP / Streamable HTTP 的 AI 客户端 | 添加 |
本地 stdio MCP | 本地开发、离线使用或要求资料不离开设备 | 见下方可选配置 |
官方远程服务使用无状态纯计算:不建立命盘数据库,不缓存或记录出生参数与命盘结果。若要求资料完全不离开设备,可选择本地 stdio 形态。
本地运行(可选)
Claude Desktop
找到配置文件并添加以下内容:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"mingpan": {
"command": "npx",
"args": ["-y", "mingpan"]
}
}
}Claude Code
claude mcp add mingpan -- npx -y mingpan验证
配置完成后重启客户端,然后尝试:
请帮我排一个八字命盘,1992年4月12日7点30分,男性
请帮我起一个奇门遁甲时盘,2024年6月21日10点
工具列表
命理排盘
命理学基于出生时间推算人生运势,属于「命」的范畴。
八字命理
工具 | 说明 |
| 八字四柱排盘(干支纳音、天干/藏干十神、十二长生自坐、命宫/胎元、旬空、公农历对照;五行/格局/用神由 AI 分析) |
| 大运列表(十年一运) |
| 流年列表(指定年份范围) |
| 流月列表(节气月,立春起算) |
| 流日列表(指定月份内每日) |
紫微斗数
工具 | 说明 |
| 紫微命盘排盘(十二宫、主星、辅星、五行局/命主/身主、四化) |
| 大限列表(十年一限) |
| 小限列表(每年一宫) |
| 流年列表(指定年份范围) |
| 流月列表(农历月) |
| 流日列表(农历日) |
历法原语
历法计算是所有术数的公共地基,也可独立使用。
工具 | 说明 |
| 二十四节气精确时刻查询(精确到秒,北京时间) |
| 公历/农历互转(含闰月、干支年月日、生肖) |
节气是天文事件(AI 无法推算,如 2025 年立春是 2 月 3 日 22:10 而非 2 月 4 日), 农历闰月分配无简单规律(AI 经常猜错)——两者是本产品确定性计算的核心价值。
占卜起卦
占卜术基于起卦时间或随机数推演卦象,属于「卜」的范畴。
六爻
工具 | 说明 |
| 六爻排盘(本卦/变卦、纳甲、六亲、六神、世应、旬空、伏神/飞神、进退神、旺衰) |
六爻输入为六个爻值(自下而上):
6 = 老阴(动爻,阴变阳)
7 = 少阳(静爻)
8 = 少阴(静爻)
9 = 老阳(动爻,阳变阴)
梅花易数
工具 | 说明 |
| 梅花易数排盘(本卦/变卦/互卦、体用分析) |
支持两种起卦方式:
时间起卦:根据农历年月日时计算
数字起卦:根据两个数字计算
爻位统一自下而上编号 1–6;变卦反转指定动爻,互卦取本卦第 2、3、4 爻为下卦,第 3、4、5 爻为上卦。依据为《梅花易数》卷一的八卦象例、爻以六除与互卦起例。当前实现对乾、坤也按相同爻位取互;未采用原文另述的“乾坤无互,互其变卦”分支。
0.1.8 修复:Issue #2 指出的爻序映射错误会影响旧版的变卦和互卦。按上述取互规则,64 卦 × 6 动爻中有 256 个变卦结果、64 卦中有 60 个互卦结果需要纠正。时间与数字起卦均受影响;本卦、动爻编号与本卦体用关系不变,输入参数和文本结构兼容。升级后,依赖旧互变卦的解读需重新计算后复核。
大六壬
工具 | 说明 |
| 大六壬排盘(天地盘、四课、三传、十二天将、神煞) |
大六壬为三式之首。推荐直接输入公历起课时间(year/month/day/hour),
节气、月将、日干支、时干支由系统自动推得(LLM 手推干支极易出错)。
也可显式指定 jieqi/dayGanZhi/hourGanZhi(专家模式,向后兼容)。
奇门遁甲
工具 | 说明 |
| 奇门遁甲排盘(九宫布局、三奇六仪、八门九星八神、格局检测) |
| 奇门用神分析(按事类选取用神,含主客、旺衰、空亡、入墓等确定性信息) |
奇门遁甲为三式之一,盘式与规则主要参考张志春《神奇之门》,支持:时盘/日盘/月盘/年盘、转盘/飞盘、拆补法/茅山法。
输出示例(bazi_basic)
=== 命主資料 ===
性別:男
公曆:1992-04-12 07:30:00
農曆:壬申年三月初十辰時
=== 八字命盤 ===
年柱:壬申(剑锋金) 月柱:甲辰(覆灯火) 日柱:戊午(天上火) 時柱:丙辰(沙中土)
日柱旬空:子丑
命宮:己酉 胎元:乙未
天干十神:年干水=偏財 月干木=七殺 時干火=偏印
藏干十神(※本氣):年申[庚食神※ 壬偏財 戊比肩] 月辰[戊比肩※ 乙正官 癸正財] 日午[丁正印※ 己劫財] 時辰[戊比肩※ 乙正官 癸正財]
十二長生(自坐):年长生 月衰 日帝旺 時冠带只包含确定性排盘信息;五行强弱、格局、用神等解读由 AI 依据盘面自行分析。
输入参数
命理工具(八字/紫微)
参数 | 类型 | 必填 | 说明 |
year | number | ✓ | 出生年份(1900-2100) |
month | number | ✓ | 出生月份(1-12) |
day | number | ✓ | 出生日期(1-31) |
hour | number | ✓ | 出生时辰(0-23) |
minute | number | 出生分钟(0-59),默认 0 | |
gender | string | ✓ |
|
longitude | number | 出生地经度,用于真太阳时校正 | |
isLunar | boolean | 是否为农历输入,默认 false | |
timezone | string | IANA 时区名(如 |
时区说明(v0.1.4+)
输入时间默认按北京时间排盘
海外出生/起卦时提供
timezone参数,系统将当地墙钟时间换算为北京时间后计算输入侧使用 IANA 时区数据库(正确处理各国历史夏令时,如 1986-1991 年中国夏令时)
内部规范表示为 UTC+8 平太阳时,与历法换算口径一致
占卜工具(六爻/梅花/大六壬)
六爻/梅花:输入起卦时间(支持
timezone),爻值/卦数由调用方提供大六壬:推荐直接输入公历时间,节气与干支自动推得;也可显式指定(专家模式)
奇门遁甲工具
参数 | 类型 | 必填 | 说明 |
year | number | ✓ | 起盘年份(1900-2100) |
month | number | ✓ | 起盘月份(1-12) |
day | number | ✓ | 起盘日期(1-31) |
hour | number | ✓ | 起盘时辰(0-23) |
minute | number | 分钟(0-59),默认 0 | |
isLunar | boolean | 是否为农历输入,默认 false | |
timezone | string | IANA 时区名,默认北京时间 | |
panType | string |
| |
panStyle | string |
| |
zhiRunMethod | string |
|
月份基准说明
系统 | 月份基准 | 日期基准 |
八字 | 节气月(立春起算) | 公历日 |
紫微 | 农历月(初一起算) | 农历日 |
开发
git clone https://github.com/ChesterRa/mingpan.git
cd mingpan
npm ci
npm run check # 构建 + 完整测试
npm run deploy:worker:dry-run # 只验证 Worker 打包,不部署
npm run dev # 监听变化依赖
库 | 用途 |
| MCP v2 服务端协议实现 |
| MCP v2 协议集成测试 |
| 农历/公历转换 |
| 紫微斗数计算引擎 |
| 输入参数校验 |
路线图
八字基础排盘与时运列表
紫微基础排盘与时运列表
六爻排盘
梅花易数排盘
大六壬排盘
奇门遁甲排盘
大六壬时间起课(自动推节气/干支)
多时区支持(timezone 参数)
奇门口径修正(拆补符头、地盘布局、转盘星门,参照《神奇之门》与 kinqimen 交叉验证)
排盘完整性对称盘点(八字补纳音/藏干十神/十二长生/命宫胎元,紫微补五行局/命主/身主)
输出契约测试全覆盖 + 权威用例金样本(历史人物记载、立春分钟级边界、iztro 适配保真)
版本历史
版本 | 说明 |
梅花正确性修复:统一八卦爻序与反向映射,纠正变卦和互卦;独立位运算穷举 384 种变卦与 64 种互卦,补齐 MCP、HTTP 与构建后 stdio 回归;感谢 @1270643866 的详细报告 | |
0.1.7 | 官方托管服务: |
0.1.6 | MCP SDK v2 迁移(2026-07-28 无状态协议,原生支持 Cloudflare Workers,向后兼容旧客户端);远程 HTTP 入口从 50 行简化为 20 行(createMcpHandler);Workers 打包 gzip 638→606KB;测试 288 |
0.1.5 | 口径裁决:子初换日(23:00 起日柱时柱同属次日,全五系统统一);起运权威化(lunar 节气表 + 交运日历定位);奇门年盘按《遁甲演义》典籍修正;真太阳时四柱全量生效;新能力:历法原语层(jieqi_query + calendar_convert);测试 218→288 |
0.1.4 | 正确性修复:八字立春换年、奇门四类口径修正、stdio 日志修复;输出定位确立:只输出确定性排盘量;大六壬时间起课、多时区;测试 117→218 |
0.1.3 | 奇门用神分析与择日 |
0.1.2 | 六爻、梅花易数、大六壬 |
0.1.0 | 首个发布:八字、紫微 |
许可证
Apache License 2.0
Available Tools
18 toolsbazi_basic八字基礎排盤A
計算八字四柱(基礎排盤)。
輸入出生時間,返回由節氣與曆法精確推算的確定性結果:
年柱、月柱、日柱、時柱干支(含節氣月邊界、晚子時處理)及六十甲子納音
天干十神與藏干十神(各支藏干逐個標注,※為本氣)
十二長生(自坐)
命宮(三命通會子平起法)、胎元(月干進一支進三)
日柱旬空
公曆/農曆出生日期對照
時區說明:默認按北京時間排盤;海外出生者請提供 timezone 參數, 系統將換算為北京時間後計算;可提供 longitude 做真太陽時校正。
定位說明:本工具只負責確定性排盤(干支、藏干、十神)。 五行強弱、格局、用神、神煞等屬解讀層,無權威統一口徑, 請由 AI 依據四柱自行分析。
大運/流年/流月/流日請使用對應列表工具。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses that results are deterministic, that timezone conversion to Beijing time occurs, that lunar input ignores timezone, and that the tool does not perform interpretation. It doesn't explicitly state read-only nature or absence of side effects, but for a排盤 calculation this is largely inferable from the description's scope.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with purpose and organized with bullet points for outputs, timezone, positioning, and alternatives. It is appropriately detailed for a complex deterministic tool, though the output list is somewhat lengthy; every section still serves a clear purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description must explain return values, which it does comprehensively (pillars, ten gods, etc.). It also covers timezone handling and scope boundaries. It is nearly complete for a 10-parameter tool, lacking only minor details like error behavior or input validation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters. The description adds guidance that overseas users should provide timezone and that longitude enables true solar time correction, but this largely echoes the schema descriptions rather than adding new meaning beyond the structured fields.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: 計算八字四柱(基礎排盤). It clearly distinguishes this tool from siblings by stating that 大運/流年/流月/流日 use separate list tools, and that interpretation-layer analysis is not its job. An agent can identify it as the deterministic charting tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit when-to-use is given: input birth time to get deterministic results. It names alternatives for 大運/流年 etc. and explicitly excludes interpretation (五行強弱, 格局, 用神, 神煞), telling the agent to handle those itself. This fully covers when and when-not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_dayun八字大運列表B
八字大運列表。
返回命主一生的大運週期(十年一運):
大運干支
起止虛歲
對應公曆年份
起運方向(順行/逆行)
起運年齡
用於了解人生各階段的運勢大框架。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| count | No | Number of periods to display (default 10) | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It describes the returned fields (a form of output transparency) but does not state that the operation is read-only, non-destructive, or mention any other behavioral traits like authentication or rate limits. This is a significant gap for a tool with zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and front-loaded: it starts with the tool name, then lists the returned fields, and ends with a usage sentence. The only minor redundancy is the first sentence restating the title, but otherwise every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of an output schema, the description usefully lists the return fields (大運干支, 起止虛歲, etc.), which is essential. It also provides a usage context. However, it omits any behavioral safety information, which would be expected without annotations, leaving a small gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all parameters are well documented in the input schema. The description adds no additional parameter meaning beyond what the schema provides, which is the baseline expectation when schema coverage is high.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: it returns the DaYun cycles (十年一運) with listed fields. It is clear that this tool is for the major ten-year luck periods, distinguishing it implicitly from siblings like bazi_liunian (annual) or bazi_basic (basic chart), though no sibling is named explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides an implied usage context: '用於了解人生各階段的運勢大框架' (used to understand the overall framework of fortune in each life stage). However, it does not explicitly state when to use this tool versus alternatives like bazi_basic or bazi_liunian, leaving comparisons to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_liunian八字流年列表B
八字流年列表。
返回指定年份範圍內的流年信息:
公曆年份
干支年
虛歲
所屬大運
用於分析多年運勢趨勢。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| endYear | Yes | End year for the range | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| startYear | Yes | Start year for the range |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does disclose the main output fields (公曆年份, 干支年, 虛歲, 所屬大運), which is useful given there is no output schema, but it says nothing about side effects, authentication, statelessness, or error behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short, front-loaded, and uses a bulleted list for the returned fields followed by a usage statement. The opening line lightly repeats the title, but the overall structure is efficient and readable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 12-parameter tool with no output schema and no annotations, the description gives a useful summary of returned fields and purpose. However, it does not explain how optional parameters like timezone, isLunar, or longitude interact, nor does it clarify relationships to sibling tools, leaving some contextual gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all 12 parameters are already documented in the input schema. The description only alludes to the year range via 指定年份範圍 and adds no meaningful parameter semantics beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific resource (八字流年) and scope (指定年份範圍), and enumerates the returned fields. It is clear this is a yearly fortune-list tool, though it does not explicitly differentiate itself from bazi_dayun, bazi_liuyue, or bazi_liuri beyond the name and returned fields.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The closing line gives an implied use case: analyzing multi-year fortune trends. However, it does not state when to choose this over sibling tools such as bazi_liuyue or bazi_liuri, nor does it mention any exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_liuri八字流日列表A
八字流日列表。
返回指定月份內的每日運勢(含上下文):
當前大運、流年、流月資訊
公曆日期
干支日
用於精細的日期選擇。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| ganzhiYear | Yes | The year of the month (GanZhi string or Gregorian year) | |
| ganzhiMonth | Yes | The month to query (either GanZhi string or month number 1-12) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
未提供 annotations,描述披露會回傳大運、流年、流月、公曆日期與干支日等內容,對讀取型工具而言提供部分透明度;但未說明是否為唯讀、是否需要完整出生資料、有無副作用或限制。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
開頭先點明工具用途,接著用條列列出回傳上下文,最後補一句使用情境;沒有冗餘鋪陳,結構前重後輕。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
工具參數多(12 個、7 個必填)且無 output schema,描述雖列出部分回傳欄位,但未交代必填出生資料與 ganzhiYear/ganzhiMonth 查詢月份之間的整體輸入邏輯;靠 schema 補足,但描述本身仍有缺口。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
schema 描述覆蓋率 100%,參數意義已由 schema 完整承載;描述僅提到「指定月份」,未對 12 個參數(尤其出生資料 vs 查詢月份)增加額外語意。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述以具體動詞「返回」與資源「每日運勢」界定工具,並說明以指定月份為範圍;與 bazi_liunian/bazi_liuyue 的年度/月度粒度有別。但未點名任何兄弟工具,故未達 5。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
「用於精細的日期選擇」給出明確使用情境,但沒有說明何時不該用、或與 bazi_liuyue/calendar_convert 等替代工具的取捨。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_liuyue八字流月列表B
八字流月列表。
重要:八字流月使用【節氣月】,非農曆月!
以節氣為邊界(立春起算)
寅月(正月)從立春開始,約2月4日
丑月(臘月)跨越公曆年界
返回指定年份的12個月運勢:
干支月
節氣起止
公曆日期範圍
用於規劃年度活動時機。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| ganzhiYear | Yes | The year to query (either GanZhi string like '乙巳' or Gregorian year like 2025) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does add real domain behavior: solar-term months, exact boundaries (立春/寅月), and that 丑月 crosses the Gregorian year line. However it says nothing about whether natal birth data is required, permissions, rate limits, or result size, so transparency is partial.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the important 節氣月 caveat, then the return shape, then use case – a sound ordering. It repeats the title phrase '八字流月列表' at the start, which is minor waste, but overall it is tight.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
11 parameters (6 required) and no output schema, so the description's enumeration of return fields is genuinely helpful. But it leaves the critical ambiguity between year/ganzhiYear and the required birth-data inputs unresolved, which an agent needs in order to call it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description mentions '指定年份' but does not disambiguate the two year inputs (year vs ganzhiYear) or explain how a query year relates to the required birth date fields, adding little beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: returns the 12 monthly fortunes for a given year, enumerating the returned fields (干支月, 節氣起止, 公曆日期範圍). It is largely distinguishable from bazi_liunian/bazi_liuri by the '12 months' scope, though it never names those siblings directly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'用於規劃年度活動時機' gives an implied use context (annual planning), but there is no explicit when-not or routing to siblings such as bazi_liunian for yearly or bazi_liuri for daily granularity. Usage is inferred rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
calendar_convert農曆公曆互轉A
農曆與公曆日期互轉(含閏月處理、干支年月日、生肖)。
農曆閏月分配無簡單規律(哪年閏幾月由天文計算決定),AI 經常猜錯。 本工具返回權威曆表數據。
支持兩個方向:
solar → lunar:輸入公曆日期,返回農曆日期(含是否閏月)
lunar → solar:輸入農曆日期(isLeapMonth 標記閏月),返回公曆日期
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日期 | |
| year | Yes | 年份 | |
| month | Yes | 月份(1-12) | |
| direction | Yes | 轉換方向 | |
| isLeapMonth | No | 農曆輸入時是否為閏月(lunar2solar 方向) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It discloses that leap-month allocation is astronomically determined and that outputs are authoritative, which is genuinely useful, but says nothing about error handling for out-of-range dates, return shape, or performance. Adequate but incomplete for a zero-annotation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loads the purpose, then the rationale, then the two directions as a compact bulleted list. Every sentence earns its place with no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description needs to stand alone, and it does cover both directions, leap-month input marking, and the returned components (lunar date, ganzhi, zodiac). It omits error/range behavior for invalid combos, keeping it just short of fully self-contained.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description reinforces that direction selects the input interpretation and that isLeapMonth marks a leap month only on the lunar→solar path, adding modest meaning, but introduces no new format or constraint detail beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('農曆與公曆日期互轉') and enumerates scope beyond the name: 閏月處理, 干支年月日, 生肖. An agent can distinguish this from siblings like jieqi_query or the bazi_* family without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives a clear reason to use it (AI commonly mis-guesses leap-month assignment, this returns authoritative data) and spells out the two supported directions. It does not explicitly name which sibling to prefer when, so it stops short of 5, but the usage context is well established.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
daliuren_basic大六壬排盤A
大六壬排盤(基礎排盤)。
大六壬是中國古老三大占卜術之一,與奇門遁甲、太乙神數並稱三式。
【推薦用法】直接輸入公曆起課時間,系統自動推得節氣、月將、日干支、時干支:
year/month/day/hour(+ 可選 minute、timezone、isLunar)
【專家模式】也可顯式指定曆法量(一般無需使用):
jieqi:節氣(如:立春、驚蟄,簡繁均可)
dayGanZhi / hourGanZhi:完整干支(如:甲子、乙丑)
返回完整的六壬盤面:
天地盤(月將加時辰起盤)
四課(日干支推演)
三傳(九宗門推演:賊尅、比用、涉害、遙尅、昴星、別責、八專、伏吟、返吟)
十二天將(貴人、螣蛇、朱雀、六合、勾陳、青龍、天空、白虎、太常、玄武、太陰、天后)
格局判斷
神煞(日馬、月馬、丁馬、華蓋、閃電)
本工具只負責排盤,斷課解讀交給 Agent。
輸出為 Markdown 格式,便於 AI 分析解讀。
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | 起課日期(1-31) | |
| hour | No | 起課時辰(0-23) | |
| year | No | 起課年份(公曆,推薦用法) | |
| jieqi | No | 【專家模式】節氣(如:立春、驚蟄,簡繁均可) | |
| month | No | 起課月份(1-12) | |
| minute | No | 分鐘(0-59),默認 0 | |
| isLunar | No | 輸入是否為農曆,默認 false | |
| timezone | No | IANA 時區名(默認北京時間) | |
| dayGanZhi | No | 【專家模式】日干支(如:甲子、乙丑) | |
| hourGanZhi | No | 【專家模式】時干支(如:甲子、乙丑) | |
| lunarMonth | No | 【專家模式】農曆月份(1-12) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does well: it discloses that this is a pure computation/chart-casting tool with no interpretation ('只負責排盤') and specifies the output is Markdown for AI consumption. It does not mention permissions or error behavior, but for a side-effect-free calculation that gap is minor.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Headings and bullet lists front-load the recommended usage, and every section maps to something actionable. It is somewhat long, and the brief 三式 background sentence is ornamental, but the size is defensible for an 11-parameter tool with two input modes and no output schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description compensates by enumerating the returned chart components and the Markdown format, which is exactly what the agent needs to plan interpretation. The absence of any tool-selection guidance relative to its many siblings is the one remaining gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds real value by grouping the 11 flat parameters into two coherent modes (recommended Gregorian year/month/day/hour vs expert jieqi/dayGanZhi/hourGanZhi) and noting simpl./trad. character acceptance for jieqi, semantics the schema alone does not convey.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb+resource (排盤 for 大六壬) and explicitly bounds scope: '本工具只負責排盤,斷課解讀交給 Agent'. It also situates the tool within the 三式 tradition and enumerates exactly what the chart contains (天地盤、四課、三傳、十二天將、格局、神煞), so an agent can distinguish it from qimen/bazi/ziwei siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It clearly separates a 推薦用法 (input Gregorian time, system derives the rest) from a 專家模式 (explicit calendar quantities, '一般無需使用'), which tells the agent which parameters to reach for. What it does not do is explain when to choose this tool over the other 17 divination siblings for a given question, leaving tool-selection to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jieqi_query節氣精確時刻查詢A
查詢指定年份二十四節氣的精確時刻(精確到秒,北京時間)。
節氣是天文事件,每年時刻不同且無簡單規律——AI 無法可靠推算 (如 2025 年立春是 2 月 3 日 22:10:13,而非 2 月 4 日)。 本工具返回權威曆表的精確數據。
輸出:二十四節氣按時間排序,含名稱、精確時刻、對應公曆日期。 用於排盤驗證、擇時分析、曆法考證。
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | 查詢年份(1900-2100) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does well: it discloses the data source ('權威曆表'), the precision, and the return structure. The read-only nature is implied by '查詢' rather than stated, and there is no explicit note on permissions or limits, keeping it short of a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with purpose, then rationale, then output and use cases; the concrete 立春 example earns its place by justifying why the tool is needed. Slightly verbose in the rationale line but no real waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter read tool with no output schema, the description supplies the output shape (sorted 24 terms with name, precise time, Gregorian date), which compensates for the missing schema. Behavior and return content are adequately covered, with only minor gaps like error handling for out-of-range years.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single 'year' parameter is fully documented with its 1900-2100 range in the schema. The description only restates '指定年份' and adds no format or edge-case detail beyond the schema, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('查詢...二十四節氣的精確時刻') with explicit scope (per-year, second precision, Beijing time). It is clearly distinguishable from abstract siblings like calendar_convert. An agent can tell what this does without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives clear usage context by explaining that solar-term times cannot be reliably computed by the model and must come from this authoritative table, and names use cases (排盤驗證, 擇時分析, 曆法考證). However, it never explicitly routes to or away from siblings such as calendar_convert, so the when-not guidance is implicit rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
liuyao_basic六爻排盤A
六爻排盤(基礎排盤)。
輸入六個爻值和起卦時間,返回完整的六爻盤面:
本卦/變卦(含卦名、卦宮、五行)
六爻納甲(每爻地支及五行)
六親(父母/兄弟/子孫/妻財/官鬼)
六神(青龍/朱雀/勾陳/螣蛇/白虎/玄武)
世應位置
動爻標註
日干支、月建、旬空
爻值說明:
6 = 老陰(動爻,陰變陽)
7 = 少陽(靜爻,陽)
8 = 少陰(靜爻,陰)
9 = 老陽(動爻,陽變陰)
輸入順序:自下而上(初爻到上爻) 起卦時間默認北京時間,可提供 timezone 换算。
輸出為 Markdown 格式,便於 AI 分析解讀。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| yaoValues | Yes | 六個爻值(自下而上,初爻到上爻)。6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does so well: it discloses the default Beijing time, timezone conversion behavior, lunar/gregorian handling, and that output is Markdown. It omits any permission/rate/error behavior, but for a pure computation tool the defaults and output format are the material traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loads the purpose, then uses structured bullets for the return contents and a clear '爻值說明' block for the input encoding. Efficient overall, though the long enumerated return list is more than strictly needed for argument selection.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description usefully enumerates the returned chart components (本卦/變卦, 納甲, 六親, 六神, 世應, 動爻, 日干支/月建/旬空) and covers time defaults, making it sufficient for correct invocation of a complex 8-parameter tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all 8 parameters are already documented, including the yaoValues enumeration and timezone/lunar semantics. The description restates the 6/7/8/9 meanings and input order rather than adding new meaning, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource (六爻排盤 基礎排盤) and the divination method itself cleanly distinguishes it from the sibling divination tools (meihua_basic, daliuren_basic, qimen_basic, bazi_basic). An agent can tell exactly which system produces the chart without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains the mechanics of the input (yao value meanings, bottom-to-top order, time defaults) but offers no guidance on when to choose this tool over the other divination siblings. Usage is implied by the method name only, not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
meihua_basic梅花易數排盤A
梅花易數排盤(基礎排盤)。
支持兩種起卦方式:
時間起卦(method='time'):根據農曆年月日時起卦
數字起卦(method='number'):根據兩個數字起卦
返回完整的梅花盤面:
本卦/變卦/互卦
上卦/下卦(含卦象、五行)
動爻位置
體用分析(體卦、用卦、五行生剋關係)
起卦數據詳情
時間起卦算法(農曆):
上卦 = (年支序數 + 月 + 日) % 8
下卦 = (年支序數 + 月 + 日 + 時辰序數) % 8
動爻 = (年支序數 + 月 + 日 + 時辰序數) % 6
輸出為 Markdown 格式,便於 AI 分析解讀。
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | 起卦日期(1-31,time 模式必填) | |
| hour | No | 起卦時辰(0-23,time 模式必填) | |
| year | No | 起卦年份(公曆,time 模式必填) | |
| month | No | 起卦月份(1-12,time 模式必填) | |
| method | Yes | 起卦方式:time=時間起卦,number=數字起卦 | |
| isLunar | No | 輸入是否為農曆,默認 false | |
| timezone | No | IANA 時區名(time 模式,默認北京時間) | |
| yaoNumber | No | 動爻數(可選,默認用上下卦數之和) | |
| lowerNumber | No | 下卦數(number 模式必填) | |
| upperNumber | No | 上卦數(number 模式必填) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does so well: it discloses the complete return contents (本卦/變卦/互卦, 體用分析, 動爻) and the output format (Markdown). It omits error/validation behavior and timezone-default nuances, keeping it below 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded summary followed by tightly bulleted modes and return fields; the embedded 農曆 algorithm formulas are arguably load-bearing since they explain the resulting 卦. Slightly long, but every section contributes.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 10-parameter tool with no annotations and no output schema, the description compensates by enumerating return values, mode selection and output format. Remaining gaps are minor edge-case behaviors rather than core task information.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description reinforces the method enum and the lunar/time-based casting logic, but adds little syntax beyond what the schema already documents for each parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource (梅花易數排盤/起卦) and enumerates its two casting modes and full output structure. An agent can tell what the tool does without opening the schema, though it never names how it differs from sibling systems like qimen_basic or liuyao_basic.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explains the conditions for the two modes (time vs number), which is implied guidance for choosing method. However, there is no explicit when-to-use/when-not or routing versus the many sibling divination tools, so usage is only partially addressed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
qimen_basic奇門遁甲排盤A
奇門遁甲排盤(基礎排盤)。
奇門遁甲是中國古代三式之一,與大六壬、太乙神數並稱,用於預測和決策。
輸入時間信息,返回完整的奇門盤面:
陰陽遁和局數(根據節氣判定)
九宮布局(地盤干、天盤干)
八門飛布(休、生、傷、杜、景、死、驚、開)
九星飛布(天蓬、天芮、天沖、天輔、天禽、天心、天柱、天任、天英)
八神排布(值符、螣蛇、太陰、六合、白虎、玄武、九地、九天)
旬首信息(符頭、值符星、值使門、空亡)
日干/時干落宮
格局判斷(吉格/凶格約20-30種)
支持選項:
盤類型:時盤(默認)、日盤、月盤、年盤
盤式:轉盤(默認,遵循《神奇之門》)或飛盤
置閏法:拆補法(默認)或茅山法
盤類型說明:
時盤:以時辰為主導,適用於即時預測
日盤:以日干支為主導,適用於當日吉凶
月盤:以月干支為主導,適用於月度運勢
年盤:以年干支為主導,適用於年度規劃
盤式說明:
轉盤:天盤、八門、九星按物理方向旋轉(《神奇之門》派)
飛盤:天盤、八門、九星按宮位數字飛布(傳統飛宮法)
輸出為 Markdown 格式,含 ASCII 九宮格,便於 AI 分析解讀。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| panType | No | 盤類型:时盘(默認)、日盘、月盘、年盘 | 时盘 |
| panStyle | No | 盤式:转盘(默認,遵循《神奇之門》)或飞盘 | 转盘 |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| zhiRunMethod | No | 置閏方法:chaibu=拆補法(默認),maoshan=茅山法 | chaibu |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It thoroughly describes the output contents (e.g., 陰陽遁, 九宮, 八門, 九星, 八神) and the output format (Markdown with ASCII 九宮格), which helps set expectations. It does not explicitly state that the operation is read-only or mention side effects, but for a pure calculation tool this is largely implied and the output disclosure is strong.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a clear introduction, bullet-pointed output details, and parameter options. It is front-loaded with the core purpose. The background sentence about Qimen being one of the three styles is somewhat extraneous for an agent, and the description is lengthy, but the length is justified by the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (10 parameters, 3 enums, no output schema) and the absence of annotations, the description is complete enough. It details the output format and contents, explains parameter options, and covers special cases like timezone handling and lunar input. An agent has sufficient information to invoke the tool correctly and understand what it will receive.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 10 parameters. However, the description adds meaningful context beyond the schema for several parameters: it explains what each pan type is used for (e.g., 時盤 for immediate prediction) and clarifies the difference between 轉盤 and 飛盤. It does not elaborate on parameters like isLunar or timezone beyond what the schema provides, so it improves semantics without being exhaustive.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: '奇門遁甲排盤(基礎排盤)' – it constructs a basic Qimen Dunjia chart. The parenthetical '基礎' distinguishes it from the sibling tool qimen_yongshen, which likely handles specialized applications. An agent can immediately tell what this tool does and how it differs from related tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage by stating '輸入時間信息,返回完整的奇門盤面', but it offers no explicit guidance on when to choose this tool over alternatives like qimen_yongshen or other divination tools. The detailed explanations of pan types and styles describe parameter choices rather than tool selection, leaving the when-to-use decision to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
qimen_yongshen奇門用神分析A
奇門遁甲用神分析。
在基礎排盤基礎上,根據事類選取用神並分析:
支持 14 種事類: 求財、婚姻、疾病、出行、訴訟、考試、工作、失物、置業、求官、孕產、尋人、合作、其他
分析內容(僅確定性事實):
主用神/輔用神識別及落宮(依《神奇之門》通行用神表)
用神旺相休囚死狀態(依月令)
用神空亡、入墓、擊刑檢測
與日干生克關係
主客落宮與生克關係(涉及雙方的事類)
年命落宮(可選)
定位說明:用神吉凶、格局利弊等判斷無權威統一口徑, 請由 AI 結合盤面(含格局檢測)自行分析。
輸出為結構化 Markdown,便於 AI 斷卦分析。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| minute | No | 分 0-59,默認 0 | |
| shiLei | Yes | 事類(用於確定用神) | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| nianGan | No | 年干(用於年命分析,可選) | |
| panType | No | 盤類型:时盘(默認)、日盘、月盘、年盘 | 时盘 |
| panStyle | No | 盤式:转盘(默認,遵循《神奇之門》)或飞盘 | 转盘 |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| zhiRunMethod | No | 置閏方法:chaibu=拆補法(默認),maoshan=茅山法 | chaibu |
| includeShenSha | No | 是否包含神煞分析 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It usefully delimits scope by declaring analysis is "僅確定性事實" and explicitly declining to judge auspiciousness (leaving that to the AI), and it states the output is structured Markdown — meaningful behavioral disclosure for a pure-computation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the one-line purpose, then organized under bolded sub-headers and a bulleted analysis list. Appropriately sized for a complex 13-parameter tool, though a few lines are near-redundant with the schema enums.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, but the description enumerates the analysis components and describes the return format (structured Markdown), which is what an agent needs here. Given the tool's complexity, this is close to complete, with only the prerequisite on qimen_basic left implicit.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 13 parameters including the 14-value shiLei enum. The description restates the matter categories and mentions nianGan-driven 年命落宮, but adds no syntax or format detail beyond what the schema provides; baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: selects the yongshen (用神) by matter category and analyzes it. It also anchors itself as extending qimen_basic ("在基礎排盤基礎上"), so an agent can distinguish it from the sibling without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implies the usage context clearly: run it after a basic chart, driven by a matter category (14 enumerated). It establishes its relationship to qimen_basic but never names an explicit alternative or states when NOT to use it, so it stops short of a full when/when-not routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_basic紫微基礎排盤A
計算紫微斗數命盤(基礎排盤)。
輸入出生時間,返回完整的紫微命盤信息:
十二宮位排布及干支
各宮主星及亮度(廟/旺/得/利/平/不/陷)
各宮輔星配置
命宮與身宮位置
五行局、命主、身主
本命四化(化祿/權/科/忌)
時區說明:默認按北京時間排盤;海外出生者請提供 timezone 參數。
輸出為結構化文本,便於 AI 分析解讀。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| detail | No | Output detail level | standard |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| targetYear | No | Calculate yearly fortune for this specific year | |
| includeDecades | No | Include decade fortune (大限) | |
| includeMutagen | No | Include four mutagens (四化) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden and covers the two behaviors that matter for a computation tool: timezone handling (defaults to Beijing time, overridden by the timezone param) and output form (structured text for AI interpretation). It omits any note about the advanced params (targetYear/includeDecades/includeMutagen) that the schema exposes, so it is strong but not exhaustive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Purpose is front-loaded, followed by a scannable bulleted output inventory, then the timezone caveat and output format note. Every element earns its place; the only minor cost is the header/consumption note at the end that slightly delays the key timezone rule.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 14-param tool with no output schema and no annotations, the description compensates by enumerating the return payload (palaces, stars, brightness, life/body palaces, five-element bureau, four transformations) and the timezone rule. The advanced parameters (targetYear, includeDecades, includeMutagen) are left unexplained, which is a modest gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 14 parameters (including the timezone and gender semantics). The description restates the timezone rule but adds no syntax or meaning beyond what the schema provides; baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (計算/calculate) and resource (紫微斗數命盤) with the scope qualifier 基礎排盤, then enumerates the returned chart components. This clearly distinguishes it from the ziwei_daxian/liunian/liuyue siblings by implication of 'basic natal chart', though it never names an alternative explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Conveys the trigger condition (input birth time to get a natal chart) and one important usage rule – provide timezone for overseas births. However it offers no when-not-to-use guidance and does not route the agent to ziwei_daxian/liunian for advanced or time-based analysis, so usage is only implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_daxian紫微大限列表A
紫微大限列表。
返回命主一生的大限週期(十年一限):
起止虛歲
對應公曆年份
大限宮位名稱
宮內主星配置
大限四化
用於了解人生各階段的運勢大框架。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| count | No | Number of decade periods to display (default 10) | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It lists return fields, implying a read-only query, but it does not state that the tool is side-effect-free, does not mention any authentication or rate-limit behavior, and does not clarify that it merely computes data. Minimum viable but with clear gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short, front-loaded, and uses a bullet list to enumerate return fields efficiently. Every sentence earns its place; no redundant or vague filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, so the description correctly enumerates the returned fields. It also supplies a usage context. It does not, however, explain how it relates to sibling tools or disclose any behavioral traits, leaving minor gaps for a complex astrology tool with 11 parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the description adds no meaning for any of the 11 input parameters (year, month, day, hour, gender, etc.). Baseline 3 is appropriate when the schema fully documents parameters and the description does not supplement them.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names the specific resource (紫微大限), states it returns decade cycles, and enumerates the returned fields (起止虛歲, 公曆年份, 宮位名稱, 主星配置, 四化). This clearly distinguishes it from siblings like ziwei_liunian or ziwei_xiaoxian, but it never explicitly contrasts those alternatives, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides a clear use context: '用於了解人生各階段的運勢大框架' (to understand the broad framework of life-stage fortunes). However, it gives no explicit when-not conditions or named alternatives for other Zi Wei tools, so it lacks the exclusion guidance needed for a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_liunian紫微流年列表A
紫微流年列表。
返回指定年份範圍內的流年信息:
公曆年份
干支年
虛歲
流年宮位
宮內主星
所屬大限
流年四化
用於分析多年運勢趨勢。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| endYear | Yes | End year for the range | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| startYear | Yes | Start year for the range |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry behavioral disclosure. It implies a read-only list/return operation and lists the output fields, but it does not state permissions, side effects, or determinism. With no annotations, this is only partially complete.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and front-loaded, with the return fields presented as a scannable list. Each part—purpose, output fields, and usage note—earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 12 parameters, 100% schema coverage, no annotations, and no output schema, the description helpfully lists the returned fields and usage context. It still omits behavioral guarantees and sibling routing, but is reasonably complete for invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the description adds no parameter-level detail beyond the schema. The schema already documents all 12 inputs, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it returns 流年 information across a specified year range and enumerates the returned fields (公曆年份, 干支年, 虛歲, etc.). This clearly identifies the annual-scope ziwei tool, though it does not explicitly name sibling alternatives such as ziwei_liuyue or ziwei_liuri.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It says it is used for analyzing multi-year fortune trends (用於分析多年運勢趨勢), giving clear context for when to use it. However, it does not state when not to use it or name alternative sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_liuri紫微流日列表A
紫微流日列表。
返回指定農曆月內的每日運勢(含上下文):
當前大限、流年、流月資訊
農曆日期與公曆日期對照
干支日及流日宮位
完整四化系統(本命/大限/小限/流年/流月/流日)
閏月使用負數表示(如 -6 表示閏六月)。
用於精細的日期選擇。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| lunarYear | Yes | The lunar year (Gregorian year) | |
| lunarMonth | Yes | Lunar month (1-12, use negative for leap month, e.g. -6 for leap 6th month) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full burden; it discloses in detail what the return contains (multi-layer context and the complete 四化 system) and explains the negative-number leap-month convention. It does not state read-only nature or failure/edge behavior, but for a deterministic fortune calculation it is fairly transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the tool name, followed by a clean bulleted output inventory and a short note on leap months and use case. Well organized with little waste, though the summary line is slightly under-informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 12 parameters, no output schema, and no annotations, the description does the necessary work by enumerating the returned fields and the leap-month encoding. Minor ambiguity remains about whether a specific 'day' input is required to scope the month's list, but overall an agent has enough to invoke it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and all 12 parameters are documented, so the baseline is 3. The description's note that leap months use negative numbers (e.g. -6) restates what lunarMonth already documents in the schema, adding no new semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource ('紫微流日列表', returns 每日運勢 within a lunar month) and enumerates exactly what it computes (大限/流年/流月 context, lunar↔Gregorian mapping, 干支日及宮位, full 四化 system). This clearly separates it from ziwei_liunian/liuyue/daxian siblings by its daily granularity, though no sibling is named explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'用於精細的日期選擇' gives only a one-line intent with no explicit when-not-to-use or alternative tool (e.g. ziwei_liuri vs bazi_liuri). Usage is implied but left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_liuyue紫微流月列表A
紫微流月列表。
重要:紫微流月使用【農曆月】,非節氣月!
以農曆初一為邊界
正月從春節開始
閏月單獨顯示(如"閏六月")
返回指定年份的流月運勢(含上下文):
當前大限、小限、流年資訊
農曆月份及公曆日期範圍
流月宮位及宮內主星
完整四化系統(本命/大限/小限/流年/流月)
用於規劃年度活動時機。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) | |
| lunarYear | Yes | The lunar year (Gregorian year) to query |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears the full burden. It discloses a critical behavioral rule about using lunar months (not solar terms) with detailed boundary logic, and enumerates the returned data. However, it does not state whether the operation is read-only or mention any side effects, leaving some behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with front-loaded purpose, a prominent important note, and clear bullet points. Every sentence contributes useful information without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description sufficiently explains the return contents (context info, lunar months, palaces, four transformations). It covers the essential complexity for an 11-parameter tool, though it omits details like return format or error handling.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents all parameters. The description only adds that the year specifies the query target ('指定年份'), which is marginal beyond what the schema already provides. Baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it returns monthly fortune for a specified year, with a specific verb-resource combination ('返回指定年份的流月運勢'). It distinguishes itself from siblings by emphasizing '流月' (monthly) and detailing output content, though it does not explicitly name alternatives like ziwei_liunian.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides a when-to-use hint ('用於規劃年度活動時機') but lacks explicit guidance on when to choose this over monthly or annual alternatives, and no exclusions are stated. The usage context is implied rather than fully specified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ziwei_xiaoxian紫微小限列表A
紫微小限列表。
小限是紫微斗數中的年度運限單位,每年一宮:
虛歲(1歲起)
對應公曆年份
小限宮位(根據出生年支起宮,男順女逆)
宮內主星
所屬大限
小限四化
小限與流年並列但計算方式不同:
小限:以出生年支定起宮,逐年移宮
流年:以該年地支定宮位
層級順序:大限 > 小限 > 流年 > 流月 > 流日
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 1-31 | |
| hour | Yes | 時 0-23 | |
| name | No | 命主姓名(可選) | |
| year | Yes | 公曆年 1900-2100 | |
| month | Yes | 月 1-12 | |
| endAge | Yes | End age (nominal age) for the range | |
| gender | Yes | 性別(影響大運順逆) | |
| minute | No | 分 0-59,默認 0 | |
| isLunar | No | 輸入日期是否為農曆,默認公曆 | |
| startAge | Yes | Start age (nominal age) for the range | |
| timezone | No | IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略 | |
| longitude | No | 出生地經度(真太陽時校正,可選) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden and discloses returned fields (虛歲, 公曆年份, 宮位, 主星, 大限, 四化) and calculation rules (出生年支起宮, 男順女逆). It omits side-effect/safety statements, but for a calculation tool this is largely inferable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded, uses bullet points for returned fields, and separates the 小限 vs 流年 comparison and hierarchy clearly. Each section earns its place for a complex 12-parameter tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description usefully lists the fields returned and the conceptual level of 小限. It could more explicitly state the return structure and how startAge/endAge bound the output, but it is otherwise complete for this domain calculator.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 12 parameters. The description adds conceptual context about 小限 but no additional parameter-specific semantics or input format details.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names the resource (紫微小限列表) and explains what 小限 is, including returned fields. It also distinguishes conceptually from 流年 via a comparison and hierarchy. However, it lacks an explicit action verb and does not name sibling tool IDs like ziwei_liunian.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides clear context for when the concept applies, contrasting 小限 with 流年 and stating the hierarchy 大限 > 小限 > 流年 > 流月 > 流日. It does not give explicit when-not guidance or name alternative sibling tools directly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
19 tool updates
v0.1.8- Changed
bazi_basic18 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - removed
Input schema / properties / detailRemoved value: -{ - "default": "standard", - "description": "Output detail level", - "enum": [ - "simple", - "standard", - "detailed" - ], - "type": "string" -} - removed
Input schema / properties / gender / defaultRemoved value: -"male" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for DaYun calculation direction"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - removed
Input schema / properties / includeAnalysisRemoved value: -{ - "default": true, - "description": "Include strength and pattern analysis", - "type": "boolean" -} - removed
Input schema / properties / includeDaYunRemoved value: -{ - "default": true, - "description": "Include decade fortune (大運)", - "type": "boolean" -} - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - added
Input schema / properties / nameAdded value: +{ + "description": "命主姓名(可選)", + "type": "string" +} - removed
Input schema / properties / targetYearRemoved value: -{ - "description": "Calculate LiuNian (流年) for this specific year", - "type": "integer" -} - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100" - changed
Input schema / requiredPrevious value: -[ - "year", - "month", - "day", - "hour" -]New value: +[ + "year", + "month", + "day", + "hour", + "gender" +]
- Changed
bazi_dayun13 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / count / descriptionPrevious value: -"Number of DaYun periods to display (default 10)"New value: +"Number of periods to display (default 10)" - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
bazi_liunian12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
bazi_liuri13 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / ganzhiYear / descriptionPrevious value: -"The year of the month"New value: +"The year of the month (GanZhi string or Gregorian year)" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
bazi_liuyue13 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / ganzhiYear / descriptionPrevious value: -"The year to query (either GanZhi string or Gregorian year)"New value: +"The year to query (either GanZhi string like '乙巳' or Gregorian year like 2025)" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Added
calendar_convert - Changed
daliuren_basic15 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - added
Input schema / properties / dayAdded value: +{ + "description": "起課日期(1-31)", + "maximum": 31, + "minimum": 1, + "type": "integer" +} - changed
Input schema / properties / dayGanZhi / descriptionPrevious value: -"日干支(如:甲子、乙丑等)"New value: +"【專家模式】日干支(如:甲子、乙丑)" - removed
Input schema / properties / guirenMethodRemoved value: -{ - "default": 0, - "description": "貴人起法:0=標準, 1=另一種", - "enum": [ - 0, - 1 - ], - "type": "number" -} - added
Input schema / properties / hourAdded value: +{ + "description": "起課時辰(0-23)", + "maximum": 23, + "minimum": 0, + "type": "integer" +} - changed
Input schema / properties / hourGanZhi / descriptionPrevious value: -"時干支(如:甲子、乙丑等)"New value: +"【專家模式】時干支(如:甲子、乙丑)" - added
Input schema / properties / isLunarAdded value: +{ + "default": false, + "description": "輸入是否為農曆,默認 false", + "type": "boolean" +} - changed
Input schema / properties / jieqi / descriptionPrevious value: -"節氣(如:立春、雨水、驚蟄等)"New value: +"【專家模式】節氣(如:立春、驚蟄,簡繁均可)" - changed
Input schema / properties / lunarMonth / descriptionPrevious value: -"農曆月份(1-12)"New value: +"【專家模式】農曆月份(1-12)" - added
Input schema / properties / minuteAdded value: +{ + "description": "分鐘(0-59),默認 0", + "maximum": 59, + "minimum": 0, + "type": "integer" +} - added
Input schema / properties / monthAdded value: +{ + "description": "起課月份(1-12)", + "maximum": 12, + "minimum": 1, + "type": "integer" +} - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(默認北京時間)", + "type": "string" +} - added
Input schema / properties / yearAdded value: +{ + "description": "起課年份(公曆,推薦用法)", + "maximum": 2100, + "minimum": 1900, + "type": "integer" +} - removed
Input schema / requiredRemoved value: -[ - "jieqi", - "lunarMonth", - "dayGanZhi", - "hourGanZhi" -]
- Added
jieqi_query - Changed
liuyao_basic11 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"起卦日期(1-31)"New value: +"日 1-31" - changed
Input schema / properties / hour / descriptionPrevious value: -"起卦時辰(0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - added
Input schema / properties / minuteAdded value: +{ + "default": 0, + "description": "分 0-59,默認 0", + "maximum": 59, + "minimum": 0, + "type": "integer" +} - changed
Input schema / properties / month / descriptionPrevious value: -"起卦月份(1-12)"New value: +"月 1-12" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / yaoValues / itemsPrevious value: -[ - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - }, - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - }, - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - }, - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - }, - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - }, - { - "enum": [ - 6, - 7, - 8, - 9 - ], - "type": "number" - } -]New value: +false - added
Input schema / properties / yaoValues / prefixItemsAdded value: +[ + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + }, + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + }, + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + }, + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + }, + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + }, + { + "anyOf": [ + { + "const": 6, + "type": "number" + }, + { + "const": 7, + "type": "number" + }, + { + "const": 8, + "type": "number" + }, + { + "const": 9, + "type": "number" + } + ] + } +] - changed
Input schema / properties / year / descriptionPrevious value: -"起卦年份(公曆)"New value: +"公曆年 1900-2100"
- Changed
meihua_basic7 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入是否為農曆,默認 false" - added
Input schema / properties / lowerNumber / maximumAdded value: +9007199254740991 - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(time 模式,默認北京時間)", + "type": "string" +} - added
Input schema / properties / upperNumber / maximumAdded value: +9007199254740991 - added
Input schema / properties / yaoNumber / maximumAdded value: +9007199254740991
- Changed
qimen_basic9 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"日期(1-31)"New value: +"日 1-31" - changed
Input schema / properties / hour / descriptionPrevious value: -"時辰(0-23,24小時制)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / minute / descriptionPrevious value: -"分鐘(0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"月份(1-12)"New value: +"月 1-12" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"年份(公曆,1900-2100)"New value: +"公曆年 1900-2100"
- Changed
qimen_yongshen11 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"日期(1-31)"New value: +"日 1-31" - changed
Input schema / properties / hour / descriptionPrevious value: -"時辰(0-23,24小時制)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / minute / descriptionPrevious value: -"分鐘(0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"月份(1-12)"New value: +"月 1-12" - changed
Input schema / properties / panStyle / descriptionPrevious value: -"盤式:转盘(默認)或飞盘"New value: +"盤式:转盘(默認,遵循《神奇之門》)或飞盘" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"年份(公曆,1900-2100)"New value: +"公曆年 1900-2100" - changed
Input schema / properties / zhiRunMethod / descriptionPrevious value: -"置閏方法"New value: +"置閏方法:chaibu=拆補法(默認),maoshan=茅山法"
- Removed
qimen_zeri - Changed
ziwei_basic14 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender (required for ZiWei calculation)"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - added
Input schema / properties / longitudeAdded value: +{ + "description": "出生地經度(真太陽時校正,可選)", + "maximum": 180, + "minimum": -180, + "type": "number" +} - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - added
Input schema / properties / nameAdded value: +{ + "description": "命主姓名(可選)", + "type": "string" +} - added
Input schema / properties / targetYear / maximumAdded value: +9007199254740991 - added
Input schema / properties / targetYear / minimumAdded value: +-9007199254740991 - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
ziwei_daxian12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
ziwei_liunian12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
ziwei_liuri12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
ziwei_liuyue12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
- Changed
ziwei_xiaoxian12 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false - changed
Input schema / properties / day / descriptionPrevious value: -"Birth day (1-31)"New value: +"日 1-31" - changed
Input schema / properties / gender / descriptionPrevious value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)" - changed
Input schema / properties / hour / descriptionPrevious value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23" - changed
Input schema / properties / isLunar / descriptionPrevious value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆" - changed
Input schema / properties / longitude / descriptionPrevious value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)" - changed
Input schema / properties / minute / descriptionPrevious value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0" - changed
Input schema / properties / month / descriptionPrevious value: -"Birth month (1-12)"New value: +"月 1-12" - changed
Input schema / properties / name / descriptionPrevious value: -"Subject name (optional)"New value: +"命主姓名(可選)" - added
Input schema / properties / timezoneAdded value: +{ + "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略", + "type": "string" +} - changed
Input schema / properties / year / descriptionPrevious value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
17 tool updates
v0.1.3- First observed
bazi_basic - First observed
bazi_dayun - First observed
bazi_liunian - First observed
bazi_liuri - First observed
bazi_liuyue - First observed
daliuren_basic - First observed
liuyao_basic - First observed
meihua_basic - First observed
qimen_basic - First observed
qimen_yongshen - First observed
qimen_zeri - First observed
ziwei_basic - First observed
ziwei_daxian - First observed
ziwei_liunian - First observed
ziwei_liuri - First observed
ziwei_liuyue - First observed
ziwei_xiaoxian
TDQS
Scored across 18 tools
Each tool targets a distinct divination system or lifecycle layer, with prefixes such as bazi_, ziwei_, qimen_, liuyao_ making the target explicit. Potential overlaps like liunian/liuyue/liuri across Bazi and Ziwei are distinguished by prefix, and descriptions even specify different calendar bases.
All names use a predictable snake_case domain_action or domain_scope pattern: bazi_basic, bazi_dayun, ziwei_liunian, qimen_yongshen, calendar_convert. There is no mixed casing or vague verb style that would disrupt predictability.
18 tools are slightly above the typical 3–15 range but are justified by six divination systems plus shared calendar utilities. Each tool has a clear role, though the set is on the heavy side for an agent to scan.
Core deterministic charting coverage is strong: Bazi and Ziwei include basic charts plus dayun/daxian and liunian/liuyue/liuri, Qimen includes basic and yongshen, and calendar/节气 utilities fill key gaps. Minor gaps remain, such as no hourly liushi tools and limited standalone analysis for Liuyao/Meihua/Daliuren, though those may be intentionally left to the AI interpreter.
Maintenance
Related MCP Connectors
BaZi (八字) MCP gateway + 玄学社区. 12 tools (4 fortune + 5 forum + 3 meta). x-api-key required.
BaZi four pillars, Chinese zodiac, lunisolar calendar and almanac days for AI agents.
Professional Vedic astrology tools for AI agents via MCP.
Chinese metaphysics (bazi, qimen, 5-element) as decision-support tools for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides five Chinese metaphysics engines (BaZi, QMDJ, ZWDS, Feng Shui, I Ching) as MCP tools for analysis and forecasting.6MIT
- FlicenseNot gradedqualityBmaintenanceEnables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.599-
- AlicenseAqualityCmaintenanceProvides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.590 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides 35 MCP tools for Chinese metaphysical divination, including BaZi, ZiWei, QiMen, and daily fortune subscriptions, enabling AI agents to perform complex fortune-telling and calendar predictions.MIT