37 tools with consistent basic structure, but significant gaps in descriptions and schema completeness. All tools have names starting with verbs (good), but most descriptions are generic and lack LLM-optimized guidance. Input schemas are present for all tools but lack constraints (enums, min/max, patterns). No output schemas documented. Error handling is absent, no guidance on recovery, retryability, or error categorization. Security concerns: no mention of API key/secret management, no permission gates, no audit trails visible in code. Composition is poor, many tools could be combined (e.g., set_fill_color + set_stroke_color → set_colors) or split further (e.g., create_rectangle + create_frame could share a 'create_shape' tool). Overall tone is 'basic CRUD operations on Figma API' without agent-friendly polish.

• Document output schemas for all 37 tools. Example for get_node_info: {type: 'object', properties: {id: {type: 'string'}, name: {type: 'string'}, x: {type: 'number'}, y: {type: 'number'}, width: {type: 'number'}, height: {type: 'number'}, ...}, required: [id, name]}.
• Rewrite descriptions to be 50 - 200 chars and answer: (1) What does this tool do? (2) When should I use it vs similar tools? (3) What does it return? Example for get_node_info: 'Retrieve detailed properties of a specific Figma node (position, size, color, text, etc.). Use this to inspect a single element; use get_nodes_info for bulk info.'
• Add enum constraints to format parameters (export_node_as_image: format enum [PNG, JPG, SVG]). Add min/max and patterns to numeric/string params. Example for set_fill_color: color {type: 'string', pattern: '^#[0-9A-Fa-f]{6}$', description: 'Hex color code (e.g., #FF0000)'}.
• Add error handling to each tool. Return structured errors with message, error_code, and recovery_hint. Example: {error: 'node_not_found', message: 'Node xyz not found.', recovery_hint: 'Verify node ID or use scan_nodes_by_types() to search for it.'}.
• Implement dry-run support for destructive tools. Add optional dry_run parameter: delete_node(nodeId, dry_run=false). When dry_run=true, return would-be effects without executing. Agents can preview before committing.
• Add scope declarations to tool descriptions. Example for create_rectangle: 'Requires design:write scope. Creates a new rectangle in the document.' For delete_node: 'Requires design:delete scope. Permanently removes a node, use dry_run=true to preview before executing.'