MCP server for Chanjet T+Cloud, HYC/ZPlus, HSY, YDZ/Finance, and HKJ/Accounting OpenAPI documentation and API calls
23 tools with explicit @mcp.tool() registration and visible schemas. Naming is verb-first and clear (list_, get_, search_, call_). However, descriptions are inconsistent: many are terse (10-30 chars) and lack actionable context for LLM selection. Parameter descriptions exist but are minimal. No output schemas documented. Error handling and recovery guidance absent. Composition is problematic: 5 near-identical product-specific tools (list_tcloud_modules, list_hyc_modules, etc.) violate single-responsibility; call_natural, call_api_smart, call_api_template, call_tplus_api_smart are overlapping routing tools that confuse intent. No pagination guidance despite tools returning lists. No security annotations or permission gates visible.
Call any supported product API from the official template. User-facing Chinese field names in fields are resolved to real API request fields before the request is sent. T+ calls also support voucher/business type and voucher list field resolution.
Find an official API template and route the call to the right product tool. Chinese field labels in body/query and field-selection arrays are resolved through the matched official template before the request is sent. For T+ calls, if the request needs a voucher bizCode or BusinessType and the exact code is unknown, call get_tplus_reference_codes first.
Route a natural-language request to the safest matching Chanjet tool. This deterministic router parses product, action, business object, fields, filters, and display columns. Only T+ voucher document list requests use voucher_name/bizCode routing; non-voucher APIs are resolved through official API templates. It calls only high-confidence routes; otherwise it returns ranked candidates for the LLM/client to inspect.
Call a T+ API after consulting the official request example. Use this for more automatic T+ calls. It first loads the matching official API template, then resolves voucher_name, business_type_name, natural language filter names, and display_fields before sending the request.
Five product-specific list tools (list_tcloud_modules, list_hyc_modules, list_hsy_modules, list_ydz_modules, list_hkj_modules) violate single-responsibility principle. Should consolidate into one list_modules(product: str) tool or use resources instead.
Four overlapping routing/call tools (call_natural, call_api_smart, call_api_template, call_tplus_api_smart) create ambiguity about which to invoke. Descriptions do not clearly distinguish when to use each. LLM will struggle with selection.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields. Descriptions like 'Return official document/API details' do not specify structure (fields, types, pagination).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Return a safe readiness report for MCP client configuration.
Build ready-to-edit call templates from official API documentation.
Return official document/API details for a HKJ/Accounting module path.
Return official document/API details for a HSY module path.
Return official document/API details for a HYC/ZPlus module path.
Return official document/API details for a T+Cloud module path.
Return T+ voucher bizCode and BusinessType reference rows. Call this first when a T+ request needs a voucher bizCode or BusinessType and the exact code is unknown. Search by code or name, for example SA04, 销货单, 02, or 采购退货.
Return official document/API details for a YDZ/Finance module path.
Return the official Chanjet HKJ/Accounting API document module tree.
Return the official Chanjet HSY API document module tree.
Return the official Chanjet HYC/ZPlus API document module tree.
Return the official Chanjet T+Cloud API document module tree.
Return the official Chanjet YDZ/Finance API document module tree.
Search official docs and return ready-to-edit API call templates.
Search HKJ/Accounting document modules by code or display name.
Search HSY document modules by code or display name.
Search HYC/ZPlus document modules by code or display name.
Search T+Cloud document modules by code or display name.
Search YDZ/Finance document modules by code or display name.
Descriptions are terse (10-50 chars) and lack actionable context. E.g., 'Return the official Chanjet T+Cloud API document module tree' does not explain WHEN to call it, WHAT structure it returns, or HOW to use the result. Baseline is 194 chars.
No error handling or recovery guidance. Tools accept complex parameters (filters, body_overrides, headers) but provide no validation feedback or actionable error messages if calls fail.