Single tool 'generate' has a complete input schema with proper types and enums, and a basic description. However, the description is generic (10 words) and lacks context on when/why to use it, what it returns, or error recovery guidance. Parameter descriptions are present but minimal. No output schema is documented. The tool accepts file I/O parameters (name, folder) which introduce complexity around file handling and error cases that are not well-explained in the schema. Missing guidance on idempotency, side effects, and error recovery.

• Expand tool description to 100-200 chars explaining: (1) What it does: 'Renders Mermaid diagram syntax to PNG or SVG images'; (2) When to use: 'Call when the user requests a diagram, flowchart, sequence diagram, or other Mermaid visualization'; (3) What it returns: 'Base64-encoded image data (if CONTENT_IMAGE_SUPPORTED=true) or file path (if saved to disk)'; (4) Key constraint: 'Requires valid Mermaid syntax, invalid diagrams will fail with a syntax error.'
• Document the output schema explicitly. Define two response shapes: (a) when returning inline: {image_data: string (base64), format: 'png'|'svg', width?: number, height?: number}; (b) when saving to disk: {file_path: string, format: 'png'|'svg', size_bytes: number}. Include this in the tool's docstring or a separate schema reference.
• Add format constraints to parameter descriptions. For 'backgroundColor', specify: 'CSS color name (white, transparent, red) or hex code (#F0F0F0, #fff). Invalid colors will be rejected.' For 'code', add: 'Valid Mermaid diagram syntax (see mermaid.js.org/intro). Diagrams larger than 10KB may timeout.'
• Add error recovery guidance in the tool description: 'If rendering fails, check Mermaid syntax at mermaid.js.org/syntax. If file save fails, verify the folder path exists and is writable. If rendering times out (>30s), simplify the diagram or reduce detail.'
• Clarify conditional parameter requirements. Rewrite the 'name' and 'folder' descriptions to explicitly state: 'Required when folder is specified OR when CONTENT_IMAGE_SUPPORTED=false. Optional otherwise.' Add a note in the tool description: 'Set CONTENT_IMAGE_SUPPORTED=false to require all images be saved to disk (useful for environments that cannot return binary data inline).'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry