知耘排盘 MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@知耘排盘 MCP Server帮我排一下1990年5月20日上午10点的八字,看看我的事业运"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
知耘排盘 DSH MCP 插件:八字排盘 / 六爻占卜 / 农历转换 / AI 深度解读
让你的 agents 成为你的专属命理师。
将 知耘排盘 的排盘能力发布为 MCP(Model Context Protocol)工具,支持 DSH(DeepSeek Harness)、Claude Desktop、Cursor 等 AI 代理/智能体直接调用:八字排盘、六爻占卜、农历转换、四柱排盘、AI 深度解读、命盘记录管理。
功能
工具 | 说明 | 费用 |
| 八字排盘:四柱、五行、十神、藏干、纳音、生肖、大运流年、神煞 | 免费 |
| 六爻装卦:手动六爻排本卦变卦、世应六亲、伏神神煞 | 免费 |
| 六爻起卦:按姓氏笔画/数字自动起卦 | 免费 |
| 四柱排盘:已知四柱干支反推出生日期并排盘 | 免费 |
| 农历/公历互转(极少使用,排盘直接传农历参数即可) | 免费 |
| AI 深度解读:命理师人设对命盘的真人感解读 | 付费 3 元/次(账户余额) |
| 八字排盘+深度解读组合:一次调用自动完成排盘和解读 | 付费 3 元/次(账户余额) |
| 保存命盘记录(名字+命盘,需登录) | 免费 |
| 列出已保存的命盘记录 | 免费 |
| 按名字/ID 加载已保存命盘 | 免费 |
Related MCP server: taibu
首次使用引导(重要)
配置账号:
LINGJI_PHONE+LINGJI_PASSWORD(或LINGJI_TOKEN),见下方配置排盘后可让 AI 保存命盘:排完盘 AI 会询问是否保存为「张三的八字」这类带名字的记录
保存后,用户只需说 「看张三的八字」,AI 即可调出命盘进行解读——无需重复报出生日期
用户报出生日期时,公历/农历均可直接排盘(农历传
lunar=true),无需先做农历转换
安装与运行
方式一:npx(推荐,无需安装)
npx lingji-paipan-mcp方式二:全局安装
npm install -g lingji-paipan-mcp
lingji-paipan-mcp配置
免费工具开箱即用,无需任何配置。付费解读(bazi_ai_reading)需要登录账号,通过环境变量配置:
环境变量 | 说明 |
| 已有登录令牌(在官网注册充值后获取) |
| 或直接配手机号密码,自动登录 |
可选配置:
环境变量 | 默认值 | 说明 |
|
| API 基地址 |
|
| 公开密钥 |
Claude Desktop 配置示例
claude_desktop_config.json:
{
"mcpServers": {
"lingji-paipan": {
"command": "npx",
"args": ["lingji-paipan-mcp"],
"env": {
"LINGJI_PHONE": "你的手机号",
"LINGJI_PASSWORD": "你的密码"
}
}
}
}免费排盘无需 env 配置;只有使用 AI 深度解读时才需要账号。
最佳使用模式(推荐给 AI 代理的调用流程)
为了获得最专业、最完整的命理分析,建议代理按以下流程为用户服务:
第 1 步:免费排盘(不花钱,拿数据)
bazi_paipan / liuyao_paipan / lunar_convert
→ 得到完整命盘结构化数据(四柱、五行、十神、大运、神煞、卦象)
第 2 步:调用 AI 深度解读(专业命理,按次计费)
bazi_ai_reading
→ 把第 1 步拿到的命盘数据 + 用户的问题传入
→ 获得专业命理师人设的深度解读文本
第 3 步:综合输出
结合解读结果与用户的具体情况,给出完整、有深度的回答为什么第 2 步不可省略:排盘接口只给出结构化数据,不做任何分析解读。真正有价值的命理判断——大运流年走势、五行喜忌、事业/感情/财运的针对性分析——全部由 AI 深度解读(bazi_ai_reading)完成。凡是涉及"解读 / 分析 / 判断 / 建议"类的问题,都应调用 bazi_ai_reading,而不是由代理自行猜测,这样才能保证用户获得专业、准确的命理指导。
费用:3 元/次,从账号余额扣除;有优惠次数时按 1 元/次扣费。配置好 LINGJI_PHONE + LINGJI_PASSWORD 即可自动登录扣费。
使用示例
向 AI 提问即可自动调用:
「帮我排一下 1990 年 5 月 20 日上午 10 点的八字,看看我的事业运」
「今天起一卦,看看这个月能不能升职」
「把 2026 年元旦转成农历」
「用这个八字帮我分析一下感情走势」(触发 AI 深度解读,按次计费)
开发
npm install
npm run build # 编译到 dist/
node dist/index.js # 本地运行(stdio)限流说明
开放接口限流:单 IP 每秒 5 次、每天 100 次。SDK 内置 429 指数退避重试,正常对话使用不会触达上限。
使用约定
免费开放,禁止转售、倒卖接口能力
解读内容仅供参考娱乐,不构成任何决策依据
接口可能随版本迭代微调,以 开放 API 文档 为准
License
MIT
Available Tools
10 toolsbazi_ai_reading八字/六爻 AI 深度解读A
专业命理深度解读(3元/次,账户余额扣费)。排盘接口只输出结构化数据、不做分析;凡是用户要求解读、分析、判断、建议(事业/感情/财运/健康/流年大运等),都必须调用本工具获取专业解读,不要自行猜测。可传入排盘数据(bazi_paipan / liuyao_paipan 的返回对象);若用户已保存过命盘记录,先用 record_load 加载,再调用本工具解读。需要服务端配置账号(LINGJI_TOKEN 或 LINGJI_PHONE+LINGJI_PASSWORD)。
| Name | Required | Description | Default |
|---|---|---|---|
| bazi | No | 八字排盘接口返回的完整命盘数据对象 | |
| role | No | 解读人设:laozhou=苏姐 / laowang=陈三更,默认 laozhou | |
| gua_data | No | 六爻排盘接口返回的卦象数据对象 | |
| question | Yes | 要咨询的问题,如「看看今年事业运」 | |
| prompt_type | No | bazi=八字解读 / liuyao=六爻解读,默认 bazi |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden and does so admirably. It discloses the cost and billing method, the need for server-side credentials (LINGJI_TOKEN or LINGJI_PHONE+LINGJI_PASSWORD), and clarifies that this tool, unlike paipan interfaces, is the analysis layer. This gives the agent insight into side effects and dependencies.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact yet information-dense, with every sentence serving a purpose: cost, differentiation, usage trigger, data source, workflow, and prerequisites. It is front-loaded with the core function and pricing, making it easy to scan.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (5 params, no output schema, 9 siblings), the description is remarkably complete. It covers what the tool does, when to use it, how to obtain/load inputs, the cost, and required setup, leaving no critical operational gaps for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already covers all parameters with descriptions (100% coverage), but the description adds valuable cross-tool semantics by explaining that bazi and gua_data correspond to return objects from bazi_paipan/liuyao_paipan and by noting the default role and prompt_type behavior. This goes beyond the schema's bare field descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a paid ('3元/次') professional fortune-telling interpretation service, with a specific verb ('深度解读') and resource (八字/六爻 interpretation). It also explicitly distinguishes itself from sibling paipan tools by stating they '只输出结构化数据、不做分析,' making the tool's unique purpose unmistakable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit when-to-use guidance: whenever a user asks for interpretation, analysis, judgment, or advice, this tool must be called rather than the paipan interfaces, and the agent should not guess. It also gives a clear workflow: pass bazi_paipan/liuyao_paipan output directly, or load a saved chart with record_load first, plus a prerequisite about server account configuration.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_from_pillars四柱排盘(按干支)A
用户直接给出四柱干支(如「甲子年丙寅月戊辰日壬子时」)时调用。已知年柱月柱日柱时柱,反推可能的出生日期并返回完整排盘数据,支持多候选结果。
| Name | Required | Description | Default |
|---|---|---|---|
| gender | No | 性别,默认 male | |
| day_pillar | Yes | 日柱干支,如 戊辰 | |
| hour_pillar | Yes | 时柱干支,如 壬子 | |
| range_years | No | 往前搜索年数,默认 120 | |
| year_pillar | Yes | 年柱干支,如 甲子 | |
| month_pillar | Yes | 月柱干支,如 丙寅 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses that the tool reverses the pillars to find possible birth dates and supports multiple candidate results, which is key behavioral context beyond simple mapping. It doesn't cover edge cases or error handling, but for a calculation tool this is acceptable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences. The first sentence states the trigger condition, the second describes the behavior and output. No wasted words; the example is compact and illustrative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has moderate complexity (reverse lookup with multiple candidates) and no output schema. The description explains the core outcome (complete chart data, multiple candidates) but doesn't specify the output structure or how many candidates to expect. Still, it's adequate for an AI agent to understand when and why to use it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents each parameter. The description adds an example format (甲子年丙寅月戊辰日壬子时) but doesn't clarify how it maps to the separate pillar parameters beyond that. Since the schema does the heavy lifting, the description only marginally enhances parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool is called when the user provides the four pillars directly, and uses the specific verb '反推' (reverse-engineer) to explain it infers possible birth dates and returns complete chart data. This distinguishes it from sibling tools like bazi_paipan, which presumably takes a birth date/time.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly starts with the condition '用户直接给出四柱干支...时调用' (call when the user directly provides the four pillars), giving clear when-to-use guidance. However, it does not explicitly name alternatives or state when not to use it, leaving the exclusion implicit rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_full_analysis八字排盘 + AI 深度解读(组合)A
用户提到出生日期(公历或农历均可,农历传 lunar=true)并希望看命盘/运势/事业/感情/财运/婚姻/健康等分析时,优先调用本工具:一次调用自动完成 ①免费排盘 → ②AI 深度解读(合计 3元/次,账户余额扣费),返回专业分析(大运流年/五行喜忌/事业感情财运)。无需用户了解中间步骤。需要服务端配置账号(LINGJI_TOKEN 或 LINGJI_PHONE+LINGJI_PASSWORD)。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 出生日(公历) | |
| hour | Yes | 出生时辰(小时,0~23) | |
| leap | No | 农历是否闰月,默认 false | |
| role | No | 解读人设:laozhou=苏姐 / laowang=陈三更,默认 laozhou | |
| year | Yes | 出生年(公历) | |
| lunar | No | true=输入为农历,默认 false(公历) | |
| month | Yes | 出生月(公历) | |
| gender | No | 性别,male=男 / female=女,默认 male | |
| question | Yes | 要咨询的问题,如「看看今年事业运」 | |
| hour_unknown | No | true=时辰未知,按子时计算 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It discloses the paid nature ('合计 3元/次,账户余额扣费'), the two-step internal workflow, account requirements, and the contents of the returned analysis (大运流年/五行喜忌/事业感情财运). It does not mention potential side effects like record saving or runtime failures, but the key behavioral traits are well covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded, starting with the trigger condition and the tool's primary purpose. Each sentence conveys essential information: workflow, cost, prerequisites, and output scope. While not as short as a two-sentence description, it avoids redundancy and remains readable despite covering multiple aspects.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex tool with 10 parameters and no output schema, the description is fairly complete: it explains the combined pipeline, cost, account prerequisites, and high-level output contents. However, it does not describe the response structure or error cases, and it omits practical hints about optional parameters like gender or hour_unknown, leaving the agent to infer their relevance from the schema alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already provides 100% coverage with descriptions for all 10 parameters. The description adds only marginal context, such as '农历传 lunar=true' which reiterates the schema's existing description ('true=输入为农历'). No additional meaning about parameter formatting, defaults, or interdependencies (e.g., leap/month) is given. The schema does the heavy lifting, so a baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs a combined BaZi chart calculation and AI deep analysis in one call ('一次调用自动完成①免费排盘→②AI深度解读'). It explicitly lists the resource (八字排盘 + AI 深度解读) and distinguishes it from sibling tools by framing it as the preferred option when users want comprehensive analysis (命盘/运势/事业/感情/财运/婚姻/健康). The verb '自动完成' and scope are specific and unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear when-to-use guidance: '当用户提到出生日期...并希望看命盘/运势/事业/感情/财运/婚姻/健康等分析时,优先调用本工具'. It also mentions prerequisites (server-side account configuration) and cost. However, it does not explicitly exclude use cases like when only a chart is needed (bazi_paipan) or only an AI reading is requested (bazi_ai_reading), so it lacks explicit when-not-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
bazi_paipan八字排盘A
用户提到出生日期(公历或农历均可,农历直接传 lunar=true,无需先转换)并涉及性格、运势、事业、感情、健康、婚配、选择等话题时,自动调用本工具排盘。排出完整八字命盘:四柱干支、五行统计、十神、藏干、纳音、生肖、大运流年、神煞等。返回 JSON 对象(含 ai_hint 引导)。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 出生日(公历) | |
| hour | Yes | 出生时辰(小时,0~23) | |
| leap | No | 农历是否闰月,默认 false | |
| year | Yes | 出生年(公历) | |
| lunar | No | true=输入为农历,默认 false(公历) | |
| month | Yes | 出生月(公历) | |
| format | No | 1=额外返回 formatted 格式化文本字段,默认 0 | |
| gender | No | 性别,male=男 / female=女,默认 male | |
| hour_unknown | No | true=时辰未知,按子时计算 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must carry the full burden. It discloses that the tool is automatically called, handles lunar input directly, and returns a JSON object with an ai_hint. However, it does not mention whether the tool is read-only, any prerequisites (e.g., exact birth time), or potential side effects. This adds some context but lacks depth on behavioral constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences, each serving a distinct purpose: trigger condition, output contents, and return format. It is concise yet informative, though the first sentence is long with many topic examples. Each part earns its place, so no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Without an output schema, the description appropriately lists the major output sections (four pillars, five elements, ten gods, hidden stems, na yin, zodiac, da yun, shen sha) and mentions the JSON return with ai_hint. This provides sufficient context for an agent to understand what the tool returns. It doesn't address edge cases like hour_unknown, but for a complex tool, the description is fairly complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds value by explicitly clarifying that lunar=true means direct lunar input and no prior conversion is needed, which is not apparent from the schema alone. This extra semantic guidance justifies a score above baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: to automatically generate a BaZi chart (排盘) when the user mentions birth date and topics like personality, fortune, etc. It lists the output components (four pillars, five elements, ten gods, etc.), which differentiates it from sibling tools like bazi_from_pillars or lunar_convert.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly specifies when to use the tool: when the user mentions birth date (solar or lunar) and topics such as personality, fortune, career, relationships, etc. It also clarifies how to handle lunar input (pass lunar=true without pre-conversion). However, it does not mention when not to use it or suggest alternatives like bazi_from_pillars, so it falls short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
liuyao_paipan六爻装卦A
当用户对某具体事件的结果存在不确定性(决策、考试、面试、求职、跳槽、合作、生意、投资、官司、出行、健康、感情、等待消息、寻物、比赛等),即使没有提到「占卜/六爻/卦」等字样,也应调用本工具起卦辅助判断。手动指定六个爻值排出六爻卦象:本卦变卦、世应六亲、伏神神煞。yaos 为 6 个爻值(从初爻到上爻),0=老阴(动)、1=少阳、2=少阴、3=老阳(动)。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 起卦日(公历) | |
| hour | Yes | 起卦时辰(小时,0~23) | |
| yaos | Yes | 6 个爻值数组,从初爻到上爻;0=老阴(动)、1=少阳、2=少阴、3=老阳(动) | |
| year | Yes | 起卦年(公历) | |
| month | Yes | 起卦月(公历) | |
| gender | No | 性别,默认 male |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the disclosure burden. It explains the core behavior (manual yao values produce a hexagram chart) and the encoding of yao values (0=老阴动, 1=少阳, 2=少阴, 3=老阳动). However, it does not describe the return format, any prerequisites, or potential limitations (e.g., whether it is deterministic or requires specific input validation). The info beyond schema is modest.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences. The first sentence is somewhat long due to listing many event types, but it is front-loaded with the trigger condition. The second sentence is efficient, covering the main action and yao encoding. No fluff, but it could be slightly more compact by trimming the example list.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is moderately complex with no output schema, so the description should explain what the user gets. It names the output components (本卦变卦、世应六亲、伏神神煞), which gives a fair sense of the result. However, it does not describe the structure of the returned data, interpretation guidance, or any edge cases (e.g., invalid yao arrays). Given the absence of annotations and output schema, the description is adequate but not fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description repeats the yao value semantics already in the schema ('0=老阴(动)、1=少阳、2=少阴、3=老阳(动)'), adding little new meaning. It does clarify the ordering '从初爻到上爻' which also appears in the schema, but no additional parameter insight is provided.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: '手动指定六个爻值排出六爻卦象:本卦变卦、世应六亲、伏神神煞' (manually specify six yao values to generate the hexagram chart with original/changed hexagrams, shi ying, six relatives, hidden spirits, and gods). It also specifies the resource (六爻卦象) and distinguishes from siblings (e.g., liuyao_surname_paipan) by emphasizing manual yao input.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit use cases: '当用户对某具体事件的结果存在不确定性... 即使没有提到「占卜/六爻/卦」等字样,也应调用本工具起卦辅助判断.' It lists many example scenarios (decision, exam, job, investment, etc.), giving clear context. However, it does not state when not to use this tool or name alternatives, so it misses the explicit exclusions/alternatives criterion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
liuyao_surname_paipan六爻起卦(姓氏/数字)A
当用户对具体事件结果不确定(决策、考试、求职、合作、投资、感情、官司、出行等),且无法手动摇卦时,按姓氏笔画数(或 1~64 的数字)+ 起卦时间自动起卦并装卦。返回卦象及计算过程。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 起卦日(公历) | |
| hour | Yes | 起卦时辰(小时,0~23) | |
| year | Yes | 起卦年(公历) | |
| month | Yes | 起卦月(公历) | |
| gender | No | 性别,默认 male | |
| surname_num | Yes | 姓氏笔画数或 1~64 的数字 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the calculation basis (surname/number + time), the action (auto-cast and assemble hexagram), and the return value (hexagram and calculation process). It could add more detail about determinism or timezone handling, but the main behavior is transparent enough for a computation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single dense Chinese sentence that efficiently packages usage conditions, trigger criteria, method, and return information. It is somewhat long but every clause adds value, with no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite lacking both annotations and an output schema, the description covers when to use the tool, the exact inputs (stroke count/number + time), and what it returns (hexagram and calculation process). Minor gaps like gender's role are covered by the schema, so the overall context is sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds meaning by clarifying that surname_num is either the surname stroke count or a 1-64 number, and that year/month/day/hour together form the divination time. This goes beyond the schema's individual field descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool auto-casts and assembles a Liuyao hexagram from surname stroke count or a 1-64 number plus the divination time, and explicitly lists supported scenarios (decision, exam, job, cooperation, investment, relationship, lawsuit, travel). It differentiates from sibling liuyao_paipan by emphasizing the surname/number-based automatic method used when manual shaking is impossible.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides an explicit usage condition: 'when the user is uncertain about specific event outcomes and cannot manually shake the hexagram'. It lists many relevant situations, but it does not directly name an alternative tool (e.g., liuyao_paipan) for cases where manual shaking is possible, relying instead on sibling context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lunar_convert农历/公历转换A
仅当用户明确要求进行农历与公历日期换算时才调用。注意:排盘不需要先转换——bazi_paipan 支持直接传农历参数(lunar=true)。本工具极少使用。
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | 日 | |
| year | Yes | 年份 | |
| month | Yes | 月份 | |
| isleap | No | 仅 lunar2solar:农历是否闰月,默认 false | |
| direction | Yes | 转换方向:solar2lunar=公历转农历,lunar2solar=农历转公历 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. However, it does not describe runtime behavior such as output format, side effects, or assumptions. It focuses on usage conditions rather than what the tool actually does when invoked, leaving the agent without insight into return values or potential pitfalls.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, front-loaded with the calling condition, and provides a crucial alternative in the second sentence. Every word earns its place; no filler or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 5-parameter tool with no output schema, the description is adequate but incomplete. It covers when and why to use the tool, but does not explain what the tool returns or how the output is structured, which would be important for an agent to fully understand the tool's behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers all five parameters with descriptions (100% coverage), so the baseline is 3. The description adds no additional meaning to the parameters themselves; it only mentions that bazi_paipan supports lunar=true, which is unrelated to this tool's parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: converting between lunar and solar dates ('农历与公历日期换算'). It uses a specific verb (换算) and resource (dates), and distinguishes itself from sibling bazi_paipan by noting that chart casting does not require this conversion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit when-to-use guidance: '仅当用户明确要求进行农历与公历日期换算时才调用' (only call when user explicitly requests conversion). It also provides a when-not-to-use alternative by stating that bazi_paipan accepts lunar parameters directly (lunar=true), and notes the tool is rarely used ('本工具极少使用').
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
record_list列出已保存的命盘记录A
列出用户已保存的命盘记录(名字、类型、时间)。用户说「看我存过的盘」「我之前保存的八字」「有哪些记录」时调用。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码,默认 1 | |
| type | No | 按类型过滤,默认全部 | |
| page_size | No | 每页数量,默认 20,最大 100 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden of behavioral disclosure. It reveals that the tool returns record fields (名字、类型、时间) and implies a read-only enumeration. However, it does not disclose pagination behavior, ordering, or the case of no saved records, which are relevant for a list operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two concise sentences. The first sentence states the action and output fields, and the second provides concrete example user utterances. There is no redundant or unnecessary text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description identifies the returned fields and trigger context, which is helpful. However, it does not describe the result shape (e.g., an array of records) or pagination behavior in detail, leaving some ambiguity for a list tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage, documenting all three parameters (page, type, page_size) with descriptions and defaults. The description itself adds no parameter-specific semantics, so the schema already handles this dimension.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses the specific verb '列出' (list) and clearly identifies the resource '用户已保存的命盘记录' along with the output fields (名字、类型、时间). This clearly distinguishes it from sibling tools like record_save and record_load, which focus on saving or loading specific records.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit trigger phrases ('看我存过的盘', '我之前保存的八字', '有哪些记录') and states '时调用', giving clear when-to-use guidance. However, it does not mention alternatives or exclusions, such as when to prefer record_load for retrieving a specific saved record.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
record_load加载命盘记录A
按名字或 ID 加载用户已保存的命盘记录。用户说「看张三的八字」「调出我存的盘」时,先调用本工具加载命盘数据,再调用 bazi_ai_reading 对已存命盘进行深度解读。
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | 记录名字(支持模糊匹配),如「张三的八字」 | |
| record_id | No | 记录 ID(优先于 name) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It implies a read-only operation ('load') but does not disclose return format, error behavior (e.g., record not found, multiple matches), or permission requirements. Adequate but with clear gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences: the first states the core action and resource, the second gives a concrete usage scenario and workflow. No wasted words; information is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (2 optional params, no output schema), the description covers the main workflow and integration with bazi_ai_reading. However, it omits details about return data structure and handling of ambiguous/missing records, which would make it fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 100% coverage with parameter descriptions, including '支持模糊匹配' for name and '优先于 name' for record_id. The description adds no additional semantic value beyond what the schema already provides, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it loads saved fate chart records by name or ID, with specific examples. It distinguishes itself from sibling tools by mentioning the follow-up call to bazi_ai_reading for interpretation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit user-phrase triggers ('看张三的八字', '调出我存的盘') and a clear sequencing instruction: call this tool first to load data, then call bazi_ai_reading. This effectively guides when to use this tool versus alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
record_save保存命盘记录A
把排盘结果保存为带名字的记录(如「张三的八字」),保存后用户下次直接说「看张三的八字」即可加载命盘并深度解读。排完盘后应主动询问用户是否保存(「需要我把这份命盘保存为『张三的八字』吗?下次直接说名字就能看」)。需要已配置账号。
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | 完整排盘数据对象(bazi_paipan / liuyao_paipan 的返回对象),内部会自动附带 _input 输入标记 | |
| name | Yes | 记录名字,如「张三的八字」 | |
| type | Yes | 记录类型:bazi=八字 / liuyao=六爻 | |
| _input | No | 输入参数标记:{year, month, day, hour(字符串,未知传*), gender, lunar, leap},通常由排盘参数自动生成,可省略 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses that the tool prompts the user before saving (with an example quote), requires a configured account, and results in records that can be loaded by name. It could mention duplicate/overwrite behavior, but the provided transparency is above average.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences and front-loaded with the core purpose. The second sentence includes a quoted prompt, which is actionable and not redundant. Every sentence contributes value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a save tool, the description covers the full workflow: saving, user confirmation, account requirement, and future loading. No output schema is present, but the outcome is clear. It lacks error handling details, but that's acceptable given the conversational context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers 100% of parameters, so baseline is 3. The description adds meaning by explaining that the name is used as a trigger phrase for future loads and gives the example '张三的八字', while data is described as the complete chart object. This exceeds the schema's bare descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action: 'save chart result as a named record' (把排盘结果保存为带名字的记录), and distinguishes it from siblings like record_list/record_load by explaining how the saved record can be loaded later via name. The verb 'save' and resource '命盘记录' are specific and unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides a clear trigger condition: after completing a chart (排完盘后), the agent should proactively ask the user if they want to save. It also notes the prerequisite of having a configured account. While it doesn't explicitly compare with alternatives, the context is sufficient for an agent to know when to invoke this tool.
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. Dates show when Glama detected each change.
10 tool updates
v0.1.6- First observed
bazi_ai_reading - First observed
bazi_from_pillars - First observed
bazi_full_analysis - First observed
bazi_paipan - First observed
liuyao_paipan - First observed
liuyao_surname_paipan - First observed
lunar_convert - First observed
record_list - First observed
record_load - First observed
record_save
TDQS
Most tools have distinct purposes, but the three BaZi-related tools (bazi_paipan, bazi_ai_reading, bazi_full_analysis) overlap in scope and could be confused. However, the descriptions clearly delineate their roles (structured output vs analysis vs combined), and the LiuYao and record tools are distinct.
All names use lowercase with underscores, but the word order and structure vary (e.g., record_save vs bazi_full_analysis vs lunar_convert). The domain prefixes (bazi_, liuyao_, record_) provide some pattern, but there is no uniform verb-noun convention, mixing styles like noun_verb, noun_noun, and adjective_noun.
10 tools is well-scoped for a server covering BaZi, LiuYao, lunar conversion, and record management. Each tool has a clear role, and the count falls comfortably within the ideal 3-15 range.
Core workflows are covered: casting (BaZi and LiuYao), AI analysis, and record management (save/list/load). However, there are minor gaps such as no update/delete for records and no dedicated LiuYao analysis tool (though bazi_ai_reading can interpret LiuYao charts). These gaps are workable.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
337 MCP tools with x402 micropayments on Base. $0.001/call. No signup, no API keys.
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
- UnifAPIOAuthcom.unifapi
Hosted MCP server for live public-data APIs and Skills for AI agents.
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides five Chinese metaphysics engines (BaZi, QMDJ, ZWDS, Feng Shui, I Ching) as MCP tools for analysis and forecasting.6MIT
- FlicenseNot gradedqualityBmaintenanceEnables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.516-
- AlicenseAqualityAmaintenanceProvides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.17230106Apache 2.0
- AlicenseAqualityAmaintenanceProvides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.5971MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/whaizaixiang/paipan-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server