MCP server for Figma integration providing tools to query Figma files, nodes, comments, and export images
Four tools with complete schemas and basic descriptions, but significant gaps in parameter documentation and error handling. All tools are READ_ONLY and follow verb_noun naming (get_*, export_*). Descriptions are present but minimal (10-50 chars), below the 194-char baseline for A+ tools. Parameter descriptions exist but lack detail on formats, constraints, and dependencies. No output schema documentation. No error recovery guidance. No tool annotations. Composition is reasonable, tools are single-purpose and chainable via fileKey/nodeId.
Export an image from Figma
Get comments from a Figma file
Get information about a Figma file
Get a specific node from a Figma file
Descriptions are too brief (10-50 chars vs 194-char baseline). LLMs cannot determine when to select each tool or distinguish get_figma_file from get_figma_node without reading the schema.
Parameter descriptions lack actionable detail. 'The Figma file key' does not explain format, length, or where to find it. 'The node ID (format: 93-1305, will be converted to 93:1305)' is helpful but inconsistent across tools.
No output schema documented. LLMs cannot plan downstream calls or extract relevant fields from Figma API responses. Responses are raw JSON dumps without field descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling or recovery guidance. If Figma API returns 401 (invalid token), 404 (file not found), or 429 (rate limit), the agent receives no actionable error message or retry strategy.
export_figma_image lacks constraints on scale parameter. Description says '1-4 for raster' but no min/max validation in schema. LLMs may pass invalid values (0, 5, -1) without guidance.