Two tools with complete schemas and descriptions, but quality is uneven. get_figma_data has a vague description ('When the nodeId cannot be obtained...') that doesn't clearly state what the tool does or when to use it. download_figma_images has better clarity but both tools lack output schema documentation. Parameter descriptions are present but some are verbose and could be more concise. No tool annotations (readOnlyHint/destructiveHint) despite clear risk profiles. Error handling and recovery guidance are absent from descriptions.

• Rewrite get_figma_data description to: 'Fetch the structure, layout, and metadata for a Figma file or specific node. Use this to explore file hierarchy, retrieve component definitions, or get node properties. Returns nested node tree with design tokens and layout info.' (Currently 35 chars; target 100-200 chars.)
• Document output schemas for both tools. Example for get_figma_data: 'Returns {nodes: [{id, name, type, bounds, fills, strokes, ...}], metadata: {version, lastModified}, errors?: []}'. This enables LLMs to chain calls and extract IDs for follow-up operations.
• Add tool annotations to tool definitions: get_figma_data should include readOnlyHint=true; download_figma_images should include destructiveHint=true (creates files on disk). This guides agent planning and safety checks.
• Enhance error descriptions with recovery paths. For get_figma_data: 'If fileKey is invalid, extract it from the Figma URL (figma.com/file/<fileKey>/...). If nodeId is not found, call get_figma_data without nodeId to explore available nodes.' For download_figma_images: 'If localPath does not exist, the tool will create it. Ensure write permissions on the parent directory.'
• Clarify parameter dependencies in descriptions. For download_figma_images, explicitly state: 'imageRef is required for raster/image nodes with fills; omit for vector/SVG nodes. If unsure, call get_figma_data first to inspect node.type and node.fills.'

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

• Relies on Stateful initialize / Mcp-Session-Id (removed; protocol is stateless) - make each request self-contained