MCP server bridging AI clients to Figma Desktop via Plugin API + WebSocket
Strong schema definitions with Zod validation across all 25 tools. All tools have descriptions (avg ~80 chars) and properly typed parameters with constraints (min/max, enums). Naming follows verb_noun convention consistently. However, descriptions are terse and lack context about when to use each tool, dependencies, or recovery guidance. Output schemas are not documented, LLMs cannot predict response structure. Error handling is absent from visible code. No tool annotations (readOnlyHint/destructiveHint) despite clear risk stratification (READ_ONLY, WRITE, DESTRUCTIVE).
Duplicate a node, optionally into a different parent
Create an ellipse (circle if width equals height)
Create a new frame in Figma with position, size, optional fill and auto-layout
Create a rectangle with position, size, optional fill and corner radius
Create a text node. Uses Inter font by default. Figma must have the font available.
Delete a node from the canvas
Output schemas not documented. LLMs cannot predict response structure, forcing them to guess what fields are returned and how to chain tools. This violates pattern:tool and pattern:response-shaper.
Tool annotations missing. Despite clear risk stratification (READ_ONLY, WRITE, DESTRUCTIVE), no readOnlyHint, destructiveHint, or idempotentHint annotations are present. This prevents agents from reasoning about side effects and retry safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 69 | 2026-07-28+ | v2 |
Export a node as PNG, SVG, or PDF. Returns base64-encoded image data.
Get Figma document structure: name, pages, current page
Get all local paint and text styles defined in the document
Get detailed info about a specific node by ID
Get all top-level nodes on current or specified page
Get currently selected nodes in Figma
Group multiple nodes together
Move a node to new X/Y coordinates
Resize a node to new width and height
Find all nodes of specific types (FRAME, TEXT, RECTANGLE, etc.)
Find all text nodes under a parent (or current page)
Configure auto-layout on a frame
Set corner radius on a node (rectangle, frame)
Set solid fill color on a node. Uses Figma's 0-1 RGBA range.
Change font size of a text node
Rename a node
Set opacity on a node (0 = transparent, 1 = opaque)
Set stroke color and width on a node. Uses Figma's 0-1 RGBA range.
Update the text content of an existing text node
Descriptions lack context and recovery guidance. Most descriptions are 60 - 75 chars and state only WHAT the tool does, not WHEN to use it, dependencies, or error recovery. E.g., 'Rename a node' should be 'Rename a node. Useful for organizing canvas. Returns updated node with new name.' This violates pattern:tool-description.
No error handling or recovery guidance visible in tool implementations. execFigmaCommand is a black box, LLMs cannot know what errors are retryable, what user input is needed, or how to recover. Violates pattern:recovery-guide and pattern:error-classification.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. This is a hard architectural limitation, not a code quality issue, but it severely limits production deployment options.