All 8 tools have basic descriptions (50-100 chars) and verb-noun naming (get*Diagram). However, input schemas are severely underdeveloped: each tool accepts a single complex object parameter (ClassDiagram, ComplexDiagram, ErDiagram, etc.) with NO visible type definitions, field descriptions, or constraints in the source code. The parameter descriptions are minimal ('The X diagram object to convert to mermaid format'). No output schemas are documented. No error handling guidance. No parameter validation rules. Tools lack the structured, LLM-optimized definitions required for reliable agent composition. Naming is consistent but generic ('get' prefix repeated 8 times with minimal differentiation). No pagination, no batch operations, no idempotent hints.

• Define explicit JSON Schema for each diagram type parameter. For ClassDiagram, document required fields (e.g., className, methods, attributes), types (string, array, object), and constraints (e.g., className max 100 chars). Use @ToolParam annotations with detailed descriptions in the Java source.
• Add output schema documentation. Define the response as a structured object with fields like {url: string, diagramType: string, format: string} instead of a bare string. This enables LLMs to extract and chain the URL reliably.
• Enhance parameter descriptions with validation rules. E.g., '@ToolParam(description = "ClassDiagram object with required fields: className (string, 1-100 chars), methods (array of Method objects), attributes (array of Attribute objects). Each method must have name and returnType.")'
• Add error handling with recovery guidance. Catch IOException and return structured errors like {error: 'Invalid diagram structure', message: 'Missing required field: className', suggestion: 'Ensure all diagram objects have required fields before calling this tool'}.
• Rename tools for clarity. Instead of 8 'get*Diagram' tools, use names that reflect the diagram purpose: 'generate_class_structure_diagram', 'generate_system_architecture_diagram', 'generate_database_schema_diagram'. This helps LLMs select the right tool on first try.