Figma MCP has complete input schemas for all 12 tools with proper JSON Schema structure (type, properties, required). However, tool descriptions are uniformly terse (10-30 chars), falling well below the 50-200 char baseline for LLM-optimized descriptions. Parameter descriptions are minimal (3-10 words). No output schemas are documented. Error handling is basic (Axios error catch with generic message). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk stratification (READ_ONLY, WRITE, DESTRUCTIVE). Naming is verb-first and clear (get_*, post_*, delete_*, create_*), following pattern:tool conventions. No parameter validation guidance, no enum constraints, no format specifications. Missing dependency hints and recovery guidance.

• Expand all tool descriptions to 50-200 chars. Include WHAT (e.g., 'Retrieves file metadata including name, owner, last modified date'), WHEN (e.g., 'Call before get_file_comments to verify file access'), and RETURN (e.g., 'Returns file_id, team_id, project_id for chaining'). Reference pattern:tool-description.
• Document output schemas for all tools. Specify which fields are returned, their types, and which are needed for downstream calls. E.g., get_file should return {file_id, team_id, project_id, name, owner_id} so agent can chain to get_file_comments(file_id).
• Add tool annotations: mark all get_* tools with readOnlyHint=true; mark delete_comment and delete_webhook with destructiveHint=true; mark idempotent tools with idempotentHint=true. This enables agents to reason about retry safety.
• Expand parameter descriptions to 50-100 chars with format/constraint guidance. E.g., 'file_key: The Figma file key (alphanumeric, 20-30 chars, found in file URL after /file/)' instead of 'The Figma file key'.
• Add enum constraints for create_webhook event_type parameter. Document valid values (e.g., 'FILE_UPDATE', 'FILE_DELETE', 'LIBRARY_PUBLISH') and include in description: 'event_type: The event to listen for. Must be one of: FILE_UPDATE, FILE_DELETE, LIBRARY_PUBLISH, COMMENT_CREATE, COMMENT_UPDATE, COMMENT_DELETE'.