sudo_run has a well-structured input schema with all parameters typed and described. The tool description is clear and security-conscious (explains password handling via SUDO_ASKPASS). However, the output schema is not documented, callers cannot predict the structure of the response. The tool is single-purpose and appropriately named with a verb prefix. Parameter descriptions are actionable and include examples. No critical gaps, but missing output documentation and lack of error recovery guidance prevent a higher score.
Run a single command as root. The user is prompted for their password via a native OS dialog (SUDO_ASKPASS); the password never enters this conversation. Pass argv as a list, not a shell string. Always include a short `reason` so the user sees in the dialog what they are authorizing.
Output schema not documented. Callers cannot predict response structure or plan downstream operations.
Error handling lacks recovery guidance. Errors return generic internal_error with message text, but do not categorize as retryable/user-fixable/fatal or suggest next steps.
No confirmation or dry-run pattern for destructive operation. sudo_run executes arbitrary commands as root with no pre-execution review step.
timeout_seconds parameter lacks explicit bounds in description. Spec says max 3600, but LLMs may not parse this constraint from the description text alone.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Limits deployment scenarios significantly.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |