MCP Server using the Dịch Vụ Công - Việt Nam API!
Single tool with minimal definition quality. Tool name 'get_briefcase_status' follows verb_noun convention (+), but description is only 24 characters in Vietnamese, below the 50-200 char LLM-optimized baseline. Input schema is present and properly typed (briefcase_id: string), but lacks parameter description entirely. No output schema documented. Error handling is generic ('Lỗi khi gọi công cụ') with no recovery guidance. Tool makes external API calls but exposes no rate limiting, timeout, or retry logic to the LLM. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite being a read-only operation.
Lấy trạng thái của hồ sơ
Parameter 'briefcase_id' lacks description. LLMs cannot infer whether to pass a numeric ID, UUID, or human-readable code without explicit guidance.
Tool description is only 24 characters ('Lấy trạng thái của hồ sơ'). Below 50-char minimum for LLM clarity. Should explain WHAT it does, WHEN to use it, and what it returns.
No output schema documented. LLMs cannot plan downstream operations or extract required fields. Response structure is inferred only from code inspection.
Error handling is generic and non-actionable. 'Lỗi khi gọi công cụ' (Tool call error) gives LLM no recovery path. Should categorize errors (retryable vs fatal) and suggest next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Tool makes external API calls (dichVuCong API) but no timeout, rate limit, or retry logic is exposed to the LLM. Runaway agents could overwhelm the service.