Seven read-and-compute tools for Chinese metaphysics: BaZi and Zi Wei charts, a date-selection almanac and a daily card, each computed with published conventions.
Scored across 7 tools
The chart tools (bazi_chart, ziwei_chart, auspicious_dates, daily_card, wenshi_templates) are cleanly separated by domain, but request_reading and start_wenshi both hand back a link to mingpath.app and both repeat the identical SKU/price/plan boilerplate, so an agent can struggle to know which to call first — one creates checkout, the other prepares the question book, but the boundary is buried in long text.
Everything is snake_case, which is good, but conventions are mixed: noun-first names (bazi_chart, ziwei_chart, auspicious_dates, daily_card, wenshi_templates) sit alongside verb-first ones (request_reading, start_wenshi), and two different verbs (request vs start) describe closely related purchase flows. Readable, but not a predictable pattern.
Seven tools is well within the sweet spot for a chart-computation-plus-commerce server, and each entry covers a distinct step (compute a chart, find dates, get a daily card, browse templates, open a checkout, start a question book). Nothing feels padded.
Core reading generation is covered (BaZi, Zi Wei, almanac, templates, checkout), but there are visible dead ends: no tool to retrieve, poll, or follow up on a delivered reading or order status, and 合盘/synastry is sold as a SKU with no corresponding compute tool. The v1 template-only restriction on questions also caps what the surface can do.
Traditional Chinese almanac for a month: day stems/branches, 建除 twelve officers, Yellow/Black Path spirits, 28 mansions, suitable/unsuitable activities, solar terms. Use it to suggest when to begin something; it is not a guarantee of outcome. Free.
Inputs: year (required), month (required), purpose.
Compute a BaZi four-pillars chart from birth data (Gregorian). Returns pillars, Day Master, Ten Gods, hidden stems, element tally, luck pillars and the conventions used (true solar time, Zi-hour rule, solar-term boundaries). The year pillar changes at 立春 and the month pillar at each 节 by comparing the birth instant (converted to UTC+8) with the 节 instant, so a birth abroad switches at the same moment as in China; day and hour pillars use apparent solar time at the birthplace. When the birth is within two hours of a 节, chart.jieBoundary names it and gives the year/month pillars on the other side. Free.
Inputs: day (required), year (required), month (required), tz, +6 more.
Today's Mingpath card for a Day Master: one line on today's stem-branch relation, one classical quotation with source, one three-minute practice. Free.
Inputs: day_master (required), lang.
Create a checkout link for a Mingpath purchase. sku: wenshi_single (one 问事书, US$9.90, default), standard_annual, standard_monthly, deep_annual, deep_monthly, synastry (合盘 US$29). 明路会员 Mingpath Member (sku standard_*) US$69/yr founding price (list US$99) or US$9.90/mo — the price of one book, for the whole month: 2 books a month + a daily card + your life reading; 明路·同行 Mingpath Companion (sku deep_*) US$299/yr founding (list US$399) or US$29.99/mo — the whole family’s charts, updated monthly; 单本 a single 问事书 (question book) without membership US$9.90 with 3 follow-ups — see the answer to one question first; 合盘 (synastry: how two people match) US$29. Plans: 明路会员 = 2 charts, a 命书 (life reading: the full book about who you are) for each chart, 2 问事书/month, 30 follow-ups/month, a 流年书 (year book) for the primary chart before each 立春, 合盘 once a year (more at US$29 each); 明路·同行 = 5 charts, a 命书 (life reading: the full book about who you are) for each chart, 10 问事书/month, 100 follow-ups/month, a 流年书 (year book) for every chart before each 立春, monthly 流月 updates, 合盘 3 a month, priority writing. 问事书 are written in the reader's language (Simplified Chinese, Traditional Chinese or English). Follow-ups (追问) are asked on the book page with 「问这一段 / Ask about this section」 beside each section, or 「还想问什么？ / What else would you like to ask?」 at the end. Auto-renews; cancel any time in one click and keep access to the end of the period. Digital content is delivered as soon as it is generated and is non-refundable. Renewal reminders are emailed before each renewal. By clicking the buy / subscribe button (「购买这一本 · US$9.90」, 「订阅明路会员 · US$69/年」…) the buyer agrees to the terms and refund policy, and the merchant of record collects its own consents at checkout. Founding prices (annual plans, 50 seats in total) are locked for life while the membership continues; GET /v1/pricing shows seats left. Returns a URL the person opens to pay; nothing is charged from this tool.
Inputs: email (required), sku, lang.
Prepare a 问事书 (a book answering one question, with timing windows from BaZi cross-checked by Zi Wei, a month-by-month table and good dates). Returns a link to mingpath.app with the birth data and question filled in; the person reviews it there and chooses membership or a single book. Never charges. 明路会员 Mingpath Member (sku standard_*) US$69/yr founding price (list US$99) or US$9.90/mo — the price of one book, for the whole month: 2 books a month + a daily card + your life reading; 明路·同行 Mingpath Companion (sku deep_*) US$299/yr founding (list US$399) or US$29.99/mo — the whole family’s charts, updated monthly; 单本 a single 问事书 (question book) without membership US$9.90 with 3 follow-ups — see the answer to one question first; 合盘 (synastry: how two people match) US$29. Plans: 明路会员 = 2 charts, a 命书 (life reading: the full book about who you are) for each chart, 2 问事书/month, 30 follow-ups/month, a 流年书 (year book) for the primary chart before each 立春, 合盘 once a year (more at US$29 each); 明路·同行 = 5 charts, a 命书 (life reading: the full book about who you are) for each chart, 10 问事书/month, 100 follow-ups/month, a 流年书 (year book) for every chart before each 立春, monthly 流月 updates, 合盘 3 a month, priority writing. 问事书 are written in the reader's language (Simplified Chinese, Traditional Chinese or English). Follow-ups (追问) are asked on the book page with 「问这一段 / Ask about this section」 beside each section, or 「还想问什么？ / What else would you like to ask?」 at the end. Auto-renews; cancel any time in one click and keep access to the end of the period. Digital content is delivered as soon as it is generated and is non-refundable. Renewal reminders are emailed before each renewal. By clicking the buy / subscribe button (「购买这一本 · US$9.90」, 「订阅明路会员 · US$69/年」…) the buyer agrees to the terms and refund policy, and the merchant of record collects its own consents at checkout. Founding prices (annual plans, 50 seats in total) are locked for life while the membership continues; GET /v1/pricing shows seats left.
Inputs: day (required), year (required), month (required), template_id (required), +9 more.
List the 问事书 question templates (love timing, changing jobs, money rhythm, next year month by month, whether to do X on a date, …) with the extra inputs each needs. v1 accepts templates only, not free text. Free.
Inputs: lang.
Compute a Zi Wei Dou Shu (紫微斗数) chart: twelve palaces with major/minor stars, brightness and birth-year transformations (四化), five-element bureau, soul/body stars. Uses the same 子时 convention as bazi_chart. Needs the birth hour. Free.
Inputs: day (required), hour (required), year (required), month (required), +6 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Add one secure layer between your agents and this server.