Collection of MCP servers for AzulClaw including AzulHands (workspace filesystem tools) and Folder Organizer (file categorization and organization)
This MCP server has critical gaps in definition quality. Only 4 tools are present, and while they have basic descriptions and input schemas are visible in the code, there are significant issues: (1) Most tool descriptions are under 100 characters and lack context about WHEN to use the tool or WHAT happens on error; (2) Parameter descriptions are minimal or missing, 'path' parameters lack format/validation guidance; (3) Output schemas are completely undocumented, tools return TextContent wrappers with unstructured text, making it impossible for LLMs to parse structured results or plan downstream operations; (4) Error handling is present (SecurityError catching) but error messages are generic ('PATH DENIED') with no recovery guidance; (5) The fourth tool 'echo_local_skill' appears to be a stub/template with unclear purpose; (6) No input validation constraints (enums, min/max, patterns) documented for parameters. The server is functional but well below production quality for agent integration.
Echoes a message from the example local MCP skill.
Lists files inside the user's secure workspace folder.
Moves or renames files within the local Workspace (desktop organisation).
Reads a file to analyze its contents (only within the Workspace).
Output schemas completely undocumented. All tools return TextContent with unstructured text. LLMs cannot parse results or plan downstream operations.
Parameter descriptions are minimal or absent. 'path' parameters lack format constraints, max length, or validation examples. 'message' parameter in echo_local_skill has no description.
Destructive tool (move_safe_file) lacks error recovery guidance, dry-run option, and undo/confirmation pattern. No warning about overwrite behavior or backup implications.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Tool descriptions are generic and lack WHEN/WHY context. No interdependency guidance (e.g., 'call list_workspace_files first to discover available paths').
echo_local_skill appears to be a template stub with unclear purpose. Vague naming and minimal description suggest incomplete implementation or inappropriate tool for agent use.
Error messages are generic ('PATH DENIED', 'Error: directory does not exist') with no actionable recovery guidance. LLMs cannot self-correct from these responses.