MCP server for Chinese worker rights case management, compensation calculation, document assembly, and legal source retrieval
Critical gaps across all 13 tools. While tool names follow verb_noun convention (validate_intake, calculate_compensation, search_sources), descriptions are generic and lack LLM-optimized guidance on WHEN to use each tool vs. alternatives. Input schemas are present but severely underdeveloped: the 'case' parameter is typed as generic 'object' with minimal constraint; no enums for termination_type or source_types; no min/max bounds on numeric fields. Audit parameters (audit, audit_session_id, audit_db_path, db_path) are repeated across all tools, suggesting poor abstraction. Output schemas are completely undocumented, no indication of what fields are returned or how to chain tools. Error handling is absent from descriptions. No evidence of parameter validation rules, format constraints, or recovery guidance in any tool description.
Assemble a complete case package export with all case materials and analysis
Query audit event status and history from the local database
Build an evidence collection plan based on case facts and legal requirements
Calculate compensation amounts based on case facts and applicable legal rules
Export case bundle as a downloadable archive
Map termination type to applicable legal rules and compensation frameworks
Plan AI-assisted legal source recall with configuration for external AI providers
Output schemas completely undocumented. No tool describes what fields it returns, making it impossible for LLMs to plan downstream tool calls or extract required data for chaining.
Generic 'case' parameter typed as bare object with no constraints, enums, or field documentation. LLMs cannot infer required fields, structure, or valid values. Violates constrained-input pattern.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 42 | 2025-06-18+ | v2 |
Prepare embedding index for legal sources to enable semantic search
Render case documents from templates and case data
Review and validate consultation output for completeness and accuracy
Search legal sources and case law for relevant articles and precedents
Validate and sanitize AI-generated legal source recall responses
Validate user intake case data and check for missing required fields
Audit parameters (audit, audit_session_id, audit_db_path, db_path) repeated across all 13 tools. Should be abstracted to server-level configuration or middleware, not exposed as tool parameters. Violates composition pattern.
No enums for constrained parameters: termination_type, source_types, export_profile, document_types, format, provider, model. Free-form strings invite hallucinated values.
Descriptions are generic and lack LLM-optimized guidance. Most are 30 - 35 characters, below the 50-character minimum for actionable context. No descriptions explain WHEN to use a tool vs. alternatives, dependencies, or recovery paths.