27 tools with consistent naming (verb_noun pattern) and basic descriptions, but critical gaps in schema completeness and parameter documentation. All tools have descriptions (10-100 chars), but most lack detailed parameter constraints, enums, and output schema documentation. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications. Error handling is minimal, most tools return generic error strings without recovery guidance. Schemas present but sparse: many parameters lack type constraints, ranges, or format specifications. No pagination support despite tools returning potentially large result sets (e.g., get_styles, get_local_components, scan_nodes_by_types). Output structures undocumented, LLMs cannot predict response fields for chaining.

• Add tool annotations to all tools: mark READ_ONLY tools with readOnlyHint=true, WRITE tools with idempotentHint=true (if safe to retry), and DESTRUCTIVE tools with destructiveHint=true. This signals to agents which calls are reversible.
• Document output schemas for all tools. For get_node_info, specify: {id: string, name: string, type: string, x: number, y: number, width: number, height: number, fills?: array, ...}. For list tools, return {items: array, total: number, hasMore: boolean}.
• Add pagination to list tools: get_styles(limit=20, offset=0), get_local_components(limit=20, offset=0), scan_text_nodes(limit=50, offset=0), scan_nodes_by_types(limit=50, offset=0). Return total count and hasMore flag.
• Constrain parameters: set_fill_color/set_stroke_color require regex pattern '^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$'; numeric x/y/width/height require min=0; export_node_as_image format must be enum ['PNG', 'JPG', 'SVG'].
• Enhance error messages with recovery guidance: 'Node not found (ID: abc123). Try get_document_info() to list available nodes.' For color validation: 'Invalid color: got "red", must be hex format #RRGGBB or #RRGGBBAA.'

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

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