PrintPal defines 8 tools with basic schemas and descriptions, but exhibits significant quality gaps. All tools have descriptions (10-80 chars, mostly under the 194-char baseline), but many are terse and lack actionable context. Input schemas are present but sparse: most parameters lack descriptions entirely (violates pattern:tool-description). The 'response_format' parameter appears in 5 tools but is never explained. Error handling is absent, no recovery guidance, no categorization of retryable vs. fatal errors. Irreversible tools (octoprint_start_print, orca_slice_model, cura_slice_model) lack confirmation or dry-run patterns. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Output schemas are undocumented. Parameter naming is inconsistent: 'heater' vs 'tool' vs 'action' lack type suffixes. No pagination or result limits documented. Security: no evidence of secret injection for OctoPrint API keys or slicer credentials.

• Add full parameter descriptions to all tools. For each param, state: what it controls, valid values/ranges, format (e.g., 'heater: string, one of "bed" or "tool0". Controls which heating element to adjust.'), and any dependencies. Example: 'confirm: boolean. If true, require user approval before executing. Prevents accidental printer damage.'
• Document output schemas for all tools. Add a 'Returns' section to each tool description listing key fields and types. E.g., octoprint_get_status returns: {temperature: {bed: number, tool0: number}, job: {progress: number, time_remaining: number}, state: string}.
• Add tool annotations (readOnlyHint, destructiveHint, idempotentHint) to all tools. Mark octoprint_get_status and octoprint_get_job as readOnly=true. Mark octoprint_start_print, orca_slice_model, cura_slice_model as destructive=true (irreversible resource consumption).
• Implement confirmation pattern for irreversible operations. Add a 'dry_run' boolean parameter to octoprint_start_print, orca_slice_model, cura_slice_model. When true, return estimated time/material cost without executing. When false and confirm=true, require explicit user approval before proceeding.
• Add error handling and recovery guidance. Define error responses for each tool: 'OctoPrint not reachable: Check network connection and OCTOPRINT_URL setting. Retry with exponential backoff.' Categorize errors as retryable (network, timeout) vs. user-fixable (invalid credentials, file not found) vs. fatal (unsupported printer model).