MCP Server for inspecting and computing differences between runtime variable state snapshots in namespaces
Single tool 'diff_namespaces' has critical definition gaps. Tool name lacks action verb (should be 'compute_diff' or 'get_namespace_diff'). Description is minimal (8 words, well below 20-char threshold). Input schema present but parameters lack descriptions, 'before' and 'after' are ambiguous without context. No output schema documented. No error handling guidance. Tool appears functional but fails multiple baseline quality checks from the 549-tool production dataset.
Calculate difference between two state snapshots.
Tool name lacks action verb. 'diff_namespaces' is a noun phrase; should start with verb like 'compute_', 'get_', or 'calculate_' to signal intent to LLM.
Tool description is 8 words (well below 20-char minimum). 'Calculate difference between two state snapshots.' lacks context on WHEN to use, WHAT it returns, and prerequisites. LLM cannot determine selection criteria.
Input parameters 'before' and 'after' have no descriptions in schema. LLM cannot infer that these are namespace dictionaries with {var_name: {type, repr}} structure. Ambiguous parameter names invite misuse.
No output schema documented. Response structure (has_changes, added_count, modified_count, removed_count, added, modified, removed) is inferred from code only. LLM cannot plan downstream operations without knowing return fields.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 35 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tool returns raw JSON or exception messages. LLM receives no actionable error classification (retryable vs fatal) or suggestions for next steps.