Skip to main content
Glama

Mingpath

request_reading

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "email": "<email>"
    },
    "name": "request_reading"
  }
}

Input Schema

NameRequiredDescriptionDefault
skuNo
langNo
emailYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/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 burden of behavioral disclosure. It does much of this well: it says the tool returns a URL, that "nothing is charged from this tool", that subscriptions auto-renew, that cancellation is available in one click with access retained to the end of the period, that digital content is non-refundable, and that renewal reminders are emailed. Gaps remain, such as error behavior or whether the email must belong to an existing account.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The correct purpose sentence is front-loaded, but the text that follows is a wall of promotional copy that repeats the sku list twice and mixes in brand names in Chinese, plan benefit breakdowns, and legal terms. Much of this belongs on a pricing page, not in a tool definition, and it dilutes the few operational facts an agent needs.

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 checkout-link generator with no output schema, the definition covers the key points: the tool returns a URL, it charges nothing, and plans and terms are explained. It falls short on the meaning of `email` and `lang` and on error handling, but overall it is sufficient for correct 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 coverage is 0%, so the description must compensate for the undocumented schema. It compensates heavily for `sku`, describing what each of the six enum values is and what it costs. It says almost nothing about `email` (the only required param) beyond implying that the buyer receives the link, and it does not explain `lang` at all, except indirectly via "written in the reader's language".

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 opening sentence gives a specific verb and resource: "Create a checkout link for a Mingpath purchase." This clearly distinguishes it from the sibling tools (bazi_chart, daily_card, ziwei_chart), which all generate readings rather than payment links. The purpose is clear, though it is diluted by the marketing copy that follows.

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 text explains the sku options at length, which gives implicit guidance on choosing a plan; it also notes that GET /v1/pricing shows how many founding seats are left. However, it never says when an agent should call this tool instead of start_wenshi or another sibling, and it gives no prerequisites or exclusions beyond seat availability.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources