MCP server for managing company information, employee resignation processes, and company history
Critical gaps across all dimensions. Tool names lack action verbs (process_quit_company, get_company_history, find_company_info are acceptable but descriptions are in Vietnamese, limiting LLM understanding). Descriptions are present but minimal (10-30 chars in English translation), and parameter descriptions are absent. No output schemas documented. No error handling guidance. Tools appear to load from hardcoded JSON files with no validation or recovery paths.
Tìm kiếm thông tin công ty theo từ khóa
Lấy lịch sử công ty theo tên công ty
Quy trinh nghi viec của nhân viên
Two of three tools have empty input schemas ({}).
Descriptions are in Vietnamese (e.g., 'Quy trinh nghi viec của nhân viên', 'Lấy lịch sử công ty theo tên công ty'). LLMs trained primarily on English will struggle to understand when/why to invoke these tools. Descriptions also lack WHAT, WHEN, and RETURN details required by pattern:tool-description.
No output schemas documented. LLMs cannot plan downstream calls or extract fields. Docstrings mention return types (dict, list) but no field structure is specified. Violates pattern:tool requirement for documented return types.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 29 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tools load JSON files with try/except that prints to stdout but returns empty lists on failure. LLMs receive no actionable error messages and cannot distinguish between 'file not found' and 'no results'.
Parameter 'keyword' in find_company_info has a description but no type constraint, range, or format guidance. Description is generic ('The search term to look for in company information'). No guidance on case sensitivity, partial matches, or max length.