Skip to main content
Glama
ChesterRa

命盘 Mingpan

by ChesterRa

命盘 MCP Server

简体中文(主文档) | English | 日本語

Version License

命盘(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 客户端

添加 https://mingpan.bzwai.com/mcp

本地 stdio MCP

本地开发、离线使用或要求资料不离开设备

见下方可选配置

官方远程服务使用无状态纯计算:不建立命盘数据库,不缓存或记录出生参数与命盘结果。若要求资料完全不离开设备,可选择本地 stdio 形态。

本地运行(可选)

Claude Desktop

找到配置文件并添加以下内容:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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点

工具列表

命理排盘

命理学基于出生时间推算人生运势,属于「命」的范畴。

八字命理

工具

说明

bazi_basic

八字四柱排盘(干支纳音、天干/藏干十神、十二长生自坐、命宫/胎元、旬空、公农历对照;五行/格局/用神由 AI 分析)

bazi_dayun

大运列表(十年一运)

bazi_liunian

流年列表(指定年份范围)

bazi_liuyue

流月列表(节气月,立春起算)

bazi_liuri

流日列表(指定月份内每日)

紫微斗数

工具

说明

ziwei_basic

紫微命盘排盘(十二宫、主星、辅星、五行局/命主/身主、四化)

ziwei_daxian

大限列表(十年一限)

ziwei_xiaoxian

小限列表(每年一宫)

ziwei_liunian

流年列表(指定年份范围)

ziwei_liuyue

流月列表(农历月)

ziwei_liuri

流日列表(农历日)

历法原语

历法计算是所有术数的公共地基,也可独立使用。

工具

说明

jieqi_query

二十四节气精确时刻查询(精确到秒,北京时间)

calendar_convert

公历/农历互转(含闰月、干支年月日、生肖)

节气是天文事件(AI 无法推算,如 2025 年立春是 2 月 3 日 22:10 而非 2 月 4 日), 农历闰月分配无简单规律(AI 经常猜错)——两者是本产品确定性计算的核心价值。

占卜起卦

占卜术基于起卦时间或随机数推演卦象,属于「卜」的范畴。

六爻

工具

说明

liuyao_basic

六爻排盘(本卦/变卦、纳甲、六亲、六神、世应、旬空、伏神/飞神、进退神、旺衰)

六爻输入为六个爻值(自下而上):

  • 6 = 老阴(动爻,阴变阳)

  • 7 = 少阳(静爻)

  • 8 = 少阴(静爻)

  • 9 = 老阳(动爻,阳变阴)

梅花易数

工具

说明

meihua_basic

梅花易数排盘(本卦/变卦/互卦、体用分析)

支持两种起卦方式:

  • 时间起卦:根据农历年月日时计算

  • 数字起卦:根据两个数字计算

爻位统一自下而上编号 1–6;变卦反转指定动爻,互卦取本卦第 2、3、4 爻为下卦,第 3、4、5 爻为上卦。依据为《梅花易数》卷一的八卦象例、爻以六除与互卦起例。当前实现对乾、坤也按相同爻位取互;未采用原文另述的“乾坤无互,互其变卦”分支。

0.1.8 修复:Issue #2 指出的爻序映射错误会影响旧版的变卦和互卦。按上述取互规则,64 卦 × 6 动爻中有 256 个变卦结果、64 卦中有 60 个互卦结果需要纠正。时间与数字起卦均受影响;本卦、动爻编号与本卦体用关系不变,输入参数和文本结构兼容。升级后,依赖旧互变卦的解读需重新计算后复核。

大六壬

工具

说明

daliuren_basic

大六壬排盘(天地盘、四课、三传、十二天将、神煞)

大六壬为三式之首。推荐直接输入公历起课时间(year/month/day/hour), 节气、月将、日干支、时干支由系统自动推得(LLM 手推干支极易出错)。 也可显式指定 jieqi/dayGanZhi/hourGanZhi(专家模式,向后兼容)。

奇门遁甲

工具

说明

qimen_basic

奇门遁甲排盘(九宫布局、三奇六仪、八门九星八神、格局检测)

qimen_yongshen

奇门用神分析(按事类选取用神,含主客、旺衰、空亡、入墓等确定性信息)

奇门遁甲为三式之一,盘式与规则主要参考张志春《神奇之门》,支持:时盘/日盘/月盘/年盘、转盘/飞盘、拆补法/茅山法。

输出示例(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

✓

male / female

longitude

number

出生地经度,用于真太阳时校正

isLunar

boolean

是否为农历输入,默认 false

timezone

string

IANA 时区名(如 America/New_York),默认北京时间

时区说明(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

chaibu(拆补法)/ maoshan(茅山法),默认 chaibu

月份基准说明

系统

月份基准

日期基准

八字

节气月(立春起算)

公历日

紫微

农历月(初一起算)

农历日

开发

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  # 监听变化

依赖

库

用途

@modelcontextprotocol/server

MCP v2 服务端协议实现

@modelcontextprotocol/client

MCP v2 协议集成测试

lunar-javascript

农历/公历转换

iztro

紫微斗数计算引擎

zod

输入参数校验

路线图

  • 八字基础排盘与时运列表

  • 紫微基础排盘与时运列表

  • 六爻排盘

  • 梅花易数排盘

  • 大六壬排盘

  • 奇门遁甲排盘

  • 大六壬时间起课(自动推节气/干支)

  • 多时区支持(timezone 参数)

  • 奇门口径修正(拆补符头、地盘布局、转盘星门,参照《神奇之门》与 kinqimen 交叉验证)

  • 排盘完整性对称盘点(八字补纳音/藏干十神/十二长生/命宫胎元,紫微补五行局/命主/身主)

  • 输出契约测试全覆盖 + 权威用例金样本(历史人物记载、立春分钟级边界、iztro 适配保真)

版本历史

版本

说明

0.1.8

梅花正确性修复:统一八卦爻序与反向映射,纠正变卦和互卦;独立位运算穷举 384 种变卦与 64 种互卦,补齐 MCP、HTTP 与构建后 stdio 回归;感谢 @1270643866 的详细报告

0.1.7

官方托管服务:mingpan.bzwai.com 产品站与 /mcp 同仓、同版本、同一 Worker 发布;生产域名、无状态隐私边界、Host/Origin、请求体、限流与现代 MCP 协议烟雾测试完成收口;测试 300

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 tools
bazi_basic八字基礎排盤A

計算八字四柱(基礎排盤)。

輸入出生時間,返回由節氣與曆法精確推算的確定性結果:

  • 年柱、月柱、日柱、時柱干支(含節氣月邊界、晚子時處理)及六十甲子納音

  • 天干十神與藏干十神(各支藏干逐個標注,※為本氣)

  • 十二長生(自坐)

  • 命宮(三命通會子平起法)、胎元(月干進一支進三)

  • 日柱旬空

  • 公曆/農曆出生日期對照

時區說明:默認按北京時間排盤;海外出生者請提供 timezone 參數, 系統將換算為北京時間後計算;可提供 longitude 做真太陽時校正。

定位說明:本工具只負責確定性排盤(干支、藏干、十神)。 五行強弱、格局、用神、神煞等屬解讀層,無權威統一口徑, 請由 AI 依據四柱自行分析。

大運/流年/流月/流日請使用對應列表工具。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)

TDQS

A4.3/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines5/5

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

八字大運列表。

返回命主一生的大運週期(十年一運):

  • 大運干支

  • 起止虛歲

  • 對應公曆年份

  • 起運方向(順行/逆行)

  • 起運年齡

用於了解人生各階段的運勢大框架。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
countNoNumber of periods to display (default 10)
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)

TDQS

B3.3/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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

八字流年列表。

返回指定年份範圍內的流年信息:

  • 公曆年份

  • 干支年

  • 虛歲

  • 所屬大運

用於分析多年運勢趨勢。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
endYearYesEnd year for the range
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
startYearYesStart year for the range

TDQS

B3.4/5.0
Behavior3/5

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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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

八字流日列表。

返回指定月份內的每日運勢(含上下文):

  • 當前大運、流年、流月資訊

  • 公曆日期

  • 干支日

用於精細的日期選擇。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
ganzhiYearYesThe year of the month (GanZhi string or Gregorian year)
ganzhiMonthYesThe month to query (either GanZhi string or month number 1-12)

TDQS

A3.7/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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個月運勢:

  • 干支月

  • 節氣起止

  • 公曆日期範圍

用於規劃年度活動時機。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
ganzhiYearYesThe year to query (either GanZhi string like '乙巳' or Gregorian year like 2025)

TDQS

B3.4/5.0
Behavior3/5

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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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 標記閏月),返回公曆日期

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日期
yearYes年份
monthYes月份(1-12)
directionYes轉換方向
isLeapMonthNo農曆輸入時是否為閏月(lunar2solar 方向)

TDQS

A4/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayNo起課日期(1-31)
hourNo起課時辰(0-23)
yearNo起課年份(公曆,推薦用法)
jieqiNo【專家模式】節氣(如:立春、驚蟄,簡繁均可)
monthNo起課月份(1-12)
minuteNo分鐘(0-59),默認 0
isLunarNo輸入是否為農曆,默認 false
timezoneNoIANA 時區名(默認北京時間)
dayGanZhiNo【專家模式】日干支(如:甲子、乙丑)
hourGanZhiNo【專家模式】時干支(如:甲子、乙丑)
lunarMonthNo【專家模式】農曆月份(1-12)

TDQS

A4.3/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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 日)。 本工具返回權威曆表的精確數據。

輸出:二十四節氣按時間排序,含名稱、精確時刻、對應公曆日期。 用於排盤驗證、擇時分析、曆法考證。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYes查詢年份(1900-2100)

TDQS

A4.1/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
yearYes公曆年 1900-2100
monthYes月 1-12
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
yaoValuesYes六個爻值(自下而上,初爻到上爻)。6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動)

TDQS

A3.9/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

梅花易數排盤(基礎排盤)。

支持兩種起卦方式:

  1. 時間起卦(method='time'):根據農曆年月日時起卦

  2. 數字起卦(method='number'):根據兩個數字起卦

返回完整的梅花盤面:

  • 本卦/變卦/互卦

  • 上卦/下卦(含卦象、五行)

  • 動爻位置

  • 體用分析(體卦、用卦、五行生剋關係)

  • 起卦數據詳情

時間起卦算法(農曆):

  • 上卦 = (年支序數 + 月 + 日) % 8

  • 下卦 = (年支序數 + 月 + 日 + 時辰序數) % 8

  • 動爻 = (年支序數 + 月 + 日 + 時辰序數) % 6

輸出為 Markdown 格式,便於 AI 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayNo起卦日期(1-31,time 模式必填)
hourNo起卦時辰(0-23,time 模式必填)
yearNo起卦年份(公曆,time 模式必填)
monthNo起卦月份(1-12,time 模式必填)
methodYes起卦方式:time=時間起卦,number=數字起卦
isLunarNo輸入是否為農曆,默認 false
timezoneNoIANA 時區名(time 模式,默認北京時間)
yaoNumberNo動爻數(可選,默認用上下卦數之和)
lowerNumberNo下卦數(number 模式必填)
upperNumberNo上卦數(number 模式必填)

TDQS

A3.7/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
yearYes公曆年 1900-2100
monthYes月 1-12
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
panTypeNo盤類型:时盘(默認)、日盘、月盘、年盘时盘
panStyleNo盤式:转盘(默認,遵循《神奇之門》)或飞盘转盘
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
zhiRunMethodNo置閏方法:chaibu=拆補法(默認),maoshan=茅山法chaibu

TDQS

A4.2/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness5/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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 斷卦分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
yearYes公曆年 1900-2100
monthYes月 1-12
minuteNo分 0-59,默認 0
shiLeiYes事類(用於確定用神)
isLunarNo輸入日期是否為農曆,默認公曆
nianGanNo年干(用於年命分析,可選)
panTypeNo盤類型:时盘(默認)、日盘、月盘、年盘时盘
panStyleNo盤式:转盘(默認,遵循《神奇之門》)或飞盘转盘
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
zhiRunMethodNo置閏方法:chaibu=拆補法(默認),maoshan=茅山法chaibu
includeShenShaNo是否包含神煞分析

TDQS

A4.1/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
detailNoOutput detail levelstandard
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
targetYearNoCalculate yearly fortune for this specific year
includeDecadesNoInclude decade fortune (大限)
includeMutagenNoInclude four mutagens (四化)

TDQS

A3.7/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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

紫微大限列表。

返回命主一生的大限週期(十年一限):

  • 起止虛歲

  • 對應公曆年份

  • 大限宮位名稱

  • 宮內主星配置

  • 大限四化

用於了解人生各階段的運勢大框架。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
countNoNumber of decade periods to display (default 10)
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)

TDQS

A3.8/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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

紫微流年列表。

返回指定年份範圍內的流年信息:

  • 公曆年份

  • 干支年

  • 虛歲

  • 流年宮位

  • 宮內主星

  • 所屬大限

  • 流年四化

用於分析多年運勢趨勢。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
endYearYesEnd year for the range
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
startYearYesStart year for the range

TDQS

A3.6/5.0
Behavior3/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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 表示閏六月)。

用於精細的日期選擇。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
lunarYearYesThe lunar year (Gregorian year)
lunarMonthYesLunar month (1-12, use negative for leap month, e.g. -6 for leap 6th month)

TDQS

A3.7/5.0
Behavior4/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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

紫微流月列表。

重要:紫微流月使用【農曆月】,非節氣月!

  • 以農曆初一為邊界

  • 正月從春節開始

  • 閏月單獨顯示(如"閏六月")

返回指定年份的流月運勢(含上下文):

  • 當前大限、小限、流年資訊

  • 農曆月份及公曆日期範圍

  • 流月宮位及宮內主星

  • 完整四化系統(本命/大限/小限/流年/流月)

用於規劃年度活動時機。

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)
lunarYearYesThe lunar year (Gregorian year) to query

TDQS

A3.8/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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歲起)

  • 對應公曆年份

  • 小限宮位(根據出生年支起宮,男順女逆)

  • 宮內主星

  • 所屬大限

  • 小限四化

小限與流年並列但計算方式不同:

  • 小限:以出生年支定起宮,逐年移宮

  • 流年:以該年地支定宮位

層級順序:大限 > 小限 > 流年 > 流月 > 流日

ParametersJSON Schema
NameRequiredDescriptionDefault
dayYes日 1-31
hourYes時 0-23
nameNo命主姓名(可選)
yearYes公曆年 1900-2100
monthYes月 1-12
endAgeYesEnd age (nominal age) for the range
genderYes性別(影響大運順逆)
minuteNo分 0-59,默認 0
isLunarNo輸入日期是否為農曆,默認公曆
startAgeYesStart age (nominal age) for the range
timezoneNoIANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略
longitudeNo出生地經度(真太陽時校正,可選)

TDQS

A4/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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.

  1. 19 tool updatesv0.1.8
    • Changedbazi_basic18 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • removedInput schema / properties / detail
        Removed value: -{
        -  "default": "standard",
        -  "description": "Output detail level",
        -  "enum": [
        -    "simple",
        -    "standard",
        -    "detailed"
        -  ],
        -  "type": "string"
        -}
      • removedInput schema / properties / gender / default
        Removed value: -"male"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for DaYun calculation direction"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • removedInput schema / properties / includeAnalysis
        Removed value: -{
        -  "default": true,
        -  "description": "Include strength and pattern analysis",
        -  "type": "boolean"
        -}
      • removedInput schema / properties / includeDaYun
        Removed value: -{
        -  "default": true,
        -  "description": "Include decade fortune (大運)",
        -  "type": "boolean"
        -}
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • addedInput schema / properties / name
        Added value: +{
        +  "description": "命主姓名(可選)",
        +  "type": "string"
        +}
      • removedInput schema / properties / targetYear
        Removed value: -{
        -  "description": "Calculate LiuNian (流年) for this specific year",
        -  "type": "integer"
        -}
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
      • changedInput schema / required
        Previous value: -[
        -  "year",
        -  "month",
        -  "day",
        -  "hour"
        -]New value: +[
        +  "year",
        +  "month",
        +  "day",
        +  "hour",
        +  "gender"
        +]
    • Changedbazi_dayun13 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / count / description
        Previous value: -"Number of DaYun periods to display (default 10)"New value: +"Number of periods to display (default 10)"
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedbazi_liunian12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedbazi_liuri13 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / ganzhiYear / description
        Previous value: -"The year of the month"New value: +"The year of the month (GanZhi string or Gregorian year)"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedbazi_liuyue13 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / ganzhiYear / description
        Previous 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)"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Addedcalendar_convert
    • Changeddaliuren_basic15 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • addedInput schema / properties / day
        Added value: +{
        +  "description": "起課日期(1-31)",
        +  "maximum": 31,
        +  "minimum": 1,
        +  "type": "integer"
        +}
      • changedInput schema / properties / dayGanZhi / description
        Previous value: -"日干支(如:甲子、乙丑等)"New value: +"【專家模式】日干支(如:甲子、乙丑)"
      • removedInput schema / properties / guirenMethod
        Removed value: -{
        -  "default": 0,
        -  "description": "貴人起法:0=標準, 1=另一種",
        -  "enum": [
        -    0,
        -    1
        -  ],
        -  "type": "number"
        -}
      • addedInput schema / properties / hour
        Added value: +{
        +  "description": "起課時辰(0-23)",
        +  "maximum": 23,
        +  "minimum": 0,
        +  "type": "integer"
        +}
      • changedInput schema / properties / hourGanZhi / description
        Previous value: -"時干支(如:甲子、乙丑等)"New value: +"【專家模式】時干支(如:甲子、乙丑)"
      • addedInput schema / properties / isLunar
        Added value: +{
        +  "default": false,
        +  "description": "輸入是否為農曆,默認 false",
        +  "type": "boolean"
        +}
      • changedInput schema / properties / jieqi / description
        Previous value: -"節氣(如:立春、雨水、驚蟄等)"New value: +"【專家模式】節氣(如:立春、驚蟄,簡繁均可)"
      • changedInput schema / properties / lunarMonth / description
        Previous value: -"農曆月份(1-12)"New value: +"【專家模式】農曆月份(1-12)"
      • addedInput schema / properties / minute
        Added value: +{
        +  "description": "分鐘(0-59),默認 0",
        +  "maximum": 59,
        +  "minimum": 0,
        +  "type": "integer"
        +}
      • addedInput schema / properties / month
        Added value: +{
        +  "description": "起課月份(1-12)",
        +  "maximum": 12,
        +  "minimum": 1,
        +  "type": "integer"
        +}
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(默認北京時間)",
        +  "type": "string"
        +}
      • addedInput schema / properties / year
        Added value: +{
        +  "description": "起課年份(公曆,推薦用法)",
        +  "maximum": 2100,
        +  "minimum": 1900,
        +  "type": "integer"
        +}
      • removedInput schema / required
        Removed value: -[
        -  "jieqi",
        -  "lunarMonth",
        -  "dayGanZhi",
        -  "hourGanZhi"
        -]
    • Addedjieqi_query
    • Changedliuyao_basic11 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"起卦日期(1-31)"New value: +"日 1-31"
      • changedInput schema / properties / hour / description
        Previous value: -"起卦時辰(0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • addedInput schema / properties / minute
        Added value: +{
        +  "default": 0,
        +  "description": "分 0-59,默認 0",
        +  "maximum": 59,
        +  "minimum": 0,
        +  "type": "integer"
        +}
      • changedInput schema / properties / month / description
        Previous value: -"起卦月份(1-12)"New value: +"月 1-12"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / yaoValues / items
        Previous 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
      • addedInput schema / properties / yaoValues / prefixItems
        Added 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"
        +      }
        +    ]
        +  }
        +]
      • changedInput schema / properties / year / description
        Previous value: -"起卦年份(公曆)"New value: +"公曆年 1900-2100"
    • Changedmeihua_basic7 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入是否為農曆,默認 false"
      • addedInput schema / properties / lowerNumber / maximum
        Added value: +9007199254740991
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(time 模式,默認北京時間)",
        +  "type": "string"
        +}
      • addedInput schema / properties / upperNumber / maximum
        Added value: +9007199254740991
      • addedInput schema / properties / yaoNumber / maximum
        Added value: +9007199254740991
    • Changedqimen_basic9 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"日期(1-31)"New value: +"日 1-31"
      • changedInput schema / properties / hour / description
        Previous value: -"時辰(0-23,24小時制)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / minute / description
        Previous value: -"分鐘(0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"月份(1-12)"New value: +"月 1-12"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"年份(公曆,1900-2100)"New value: +"公曆年 1900-2100"
    • Changedqimen_yongshen11 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"日期(1-31)"New value: +"日 1-31"
      • changedInput schema / properties / hour / description
        Previous value: -"時辰(0-23,24小時制)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / minute / description
        Previous value: -"分鐘(0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"月份(1-12)"New value: +"月 1-12"
      • changedInput schema / properties / panStyle / description
        Previous value: -"盤式:转盘(默認)或飞盘"New value: +"盤式:转盘(默認,遵循《神奇之門》)或飞盘"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"年份(公曆,1900-2100)"New value: +"公曆年 1900-2100"
      • changedInput schema / properties / zhiRunMethod / description
        Previous value: -"置閏方法"New value: +"置閏方法:chaibu=拆補法(默認),maoshan=茅山法"
    • Removedqimen_zeri
    • Changedziwei_basic14 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender (required for ZiWei calculation)"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • addedInput schema / properties / longitude
        Added value: +{
        +  "description": "出生地經度(真太陽時校正,可選)",
        +  "maximum": 180,
        +  "minimum": -180,
        +  "type": "number"
        +}
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • addedInput schema / properties / name
        Added value: +{
        +  "description": "命主姓名(可選)",
        +  "type": "string"
        +}
      • addedInput schema / properties / targetYear / maximum
        Added value: +9007199254740991
      • addedInput schema / properties / targetYear / minimum
        Added value: +-9007199254740991
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedziwei_daxian12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedziwei_liunian12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedziwei_liuri12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedziwei_liuyue12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
    • Changedziwei_xiaoxian12 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / day / description
        Previous value: -"Birth day (1-31)"New value: +"日 1-31"
      • changedInput schema / properties / gender / description
        Previous value: -"Gender for fortune direction calculation"New value: +"性別(影響大運順逆)"
      • changedInput schema / properties / hour / description
        Previous value: -"Birth hour in 24-hour format (0-23)"New value: +"時 0-23"
      • changedInput schema / properties / isLunar / description
        Previous value: -"Whether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally."New value: +"輸入日期是否為農曆,默認公曆"
      • changedInput schema / properties / longitude / description
        Previous value: -"Birth location longitude for true solar time adjustment"New value: +"出生地經度(真太陽時校正,可選)"
      • changedInput schema / properties / minute / description
        Previous value: -"Birth minute (0-59)"New value: +"分 0-59,默認 0"
      • changedInput schema / properties / month / description
        Previous value: -"Birth month (1-12)"New value: +"月 1-12"
      • changedInput schema / properties / name / description
        Previous value: -"Subject name (optional)"New value: +"命主姓名(可選)"
      • addedInput schema / properties / timezone
        Added value: +{
        +  "description": "IANA 時區名(如 America/New_York)。默認北京時間;設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略",
        +  "type": "string"
        +}
      • changedInput schema / properties / year / description
        Previous value: -"Birth year (e.g., 1990)"New value: +"公曆年 1900-2100"
  2. 17 tool updatesv0.1.3
    • First observedbazi_basic
    • First observedbazi_dayun
    • First observedbazi_liunian
    • First observedbazi_liuri
    • First observedbazi_liuyue
    • First observeddaliuren_basic
    • First observedliuyao_basic
    • First observedmeihua_basic
    • First observedqimen_basic
    • First observedqimen_yongshen
    • First observedqimen_zeri
    • First observedziwei_basic
    • First observedziwei_daxian
    • First observedziwei_liunian
    • First observedziwei_liuri
    • First observedziwei_liuyue
    • First observedziwei_xiaoxian

TDQS

A3.9/5.0

Scored across 18 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessResponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides five Chinese metaphysics engines (BaZi, QMDJ, ZWDS, Feng Shui, I Ching) as MCP tools for analysis and forecasting.
    6
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.
    599
    -
  • A
    license
    A
    quality
    C
    maintenance
    Provides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.
    5
    90 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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