MCP server for image manipulation using ImageMagick, providing tools for resizing, cropping, and applying blur effects to images
Two tools with significant definition gaps. Tool 1 (describe_imagemagick_interface) has empty input schema and generic description. Tool 2 (crop_resize_blur_bg) has complete schema with proper types and descriptions, but lacks output schema documentation and error recovery guidance. No enum constraints on 'mode' parameter despite fixed valid values. Descriptions are present but lack LLM-optimized guidance on when/why to use each tool. No parameter validation hints or dependency documentation.
Resize/crop image to exact dimensions. If aspect ratio differs, use mode: blur|cover|contain.
Returns server metadata and available tools
Tool 1 has empty input schema ({}). This tool provides no actionable metadata to agents.
Mode parameter accepts 'blur|cover|contain' but is declared as free-form string, not enum. LLMs may hallucinate invalid values like 'stretch' or 'fit'. Should use enum constraint.
No output schema documented. Tool returns JSON text but agents cannot parse structure reliably. Should document: {ok: boolean, output_path: string, mode: string}.
Error handling returns raw error strings without recovery guidance. E.g., 'magick identify failed' tells agent nothing about next steps. Should suggest: 'File not found. Verify input_path is absolute and readable.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
describe_imagemagick_interface is a discovery tool but lacks guidance on when to call it. Description should state: 'Call this first to discover available image processing modes and tool capabilities.'