# io.github.vkhanhqui/figma-mcp-go (npm · @vkhanhqui/figma-mcp-go)

Figma MCP server with full read/write access via plugin — no API token, no rate limits. 73 tools.

- Trust score: 65/100 (medium)
- Change this week: +46
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `@vkhanhqui/figma-mcp-go`: 65/100 (this document), [markdown](https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go.md), [page](https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go)

## Channel facts

- Registry: `npm`
- Package: `@vkhanhqui/figma-mcp-go`
- Version: `0.1.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 451.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 116 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 83/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 7994 tokens (~109/item across 73 items; 73 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add vkhanhqui-figma-mcp-go -- npx -y @vkhanhqui/figma-mcp-go
```

### Codex

```bash
codex mcp add vkhanhqui-figma-mcp-go -- npx -y @vkhanhqui/figma-mcp-go
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vkhanhqui-figma-mcp-go": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@vkhanhqui/figma-mcp-go"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vkhanhqui-figma-mcp-go --command npx --arg -y --arg @vkhanhqui/figma-mcp-go
```

### Hermes

```yaml
mcp_servers:
  vkhanhqui-figma-mcp-go:
    command: "npx"
    args: ["-y", "@vkhanhqui/figma-mcp-go"]
```

### Other

```json
{
  "mcpServers": {
    "vkhanhqui-figma-mcp-go": {
      "command": "npx",
      "args": [
        "-y",
        "@vkhanhqui/figma-mcp-go"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-07 (score 65, +6)

- [functional improvement] Schema quality: unverified → good

### 2026-08-06 (score 59, +25)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: unverified
- [functional] First check of Tool coverage: 100

### 2026-08-02 (score 34, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-07-31 (score 19, −4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 23, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 41, 0)

- [functional] Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess.
- [functional] Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess.

### 2026-07-26 (score 41)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (73)

### `add_page` (~56 tokens)

Add a new page to the Figma document.

Input parameters:

- `index` (number): Position index to insert the page (0 = first). Defaults to last position.
- `name` (string): Name for the new page (default 'Page')

### `add_variable_mode` (~155 tokens)

Add a new mode to an existing variable collection (e.g. Light/Dark, Desktop/Mobile). IMPORTANT — Figma free plan only allows 1 mode per collection; calling this tool on a free-plan account will return the error 'Limited to 1 modes only'. If that error occurs, stop retrying and switch to the name-prefix workaround: keep the single default mode and create variables prefixed by mode, e.g. 'light/color-bg' and 'dark/color-bg' in the same collection. Tell the user that native multi-mode variables require a paid Figma plan (Professional or above).

Input parameters:

- `collectionId` (string, required): Variable collection ID
- `modeName` (string, required): Name for the new mode

### `apply_style_to_node` (~98 tokens)

Apply an existing local style (paint, text, effect, or grid) to a node, linking the node to that style.

Input parameters:

- `nodeId` (string, required): Target node ID in colon format e.g. 4029:12345
- `styleId` (string, required): Style ID to apply (from get_styles)
- `target` (string): For paint styles only — apply to 'fill' (default) or 'stroke'

### `batch_rename_nodes` (~160 tokens)

Rename multiple nodes using find/replace, regex substitution, or prefix/suffix addition.

Input parameters:

- `find` (string): String (or regex pattern when useRegex=true) to search for in the node name
- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `prefix` (string): String to prepend to the node name
- `regexFlags` (string): Regex flags e.g. 'gi' (default 'g'). Only used when useRegex=true.
- `replace` (string): Replacement string. Required when find is provided.
- `suffix` (string): String to append to the node name
- `useRegex` (boolean): Treat find as a regular expression (default false)

### `bind_variable_to_node` (~197 tokens)

Bind a local variable to a node property so the property is driven by the variable's value. COLOR variables: use fillColor or strokeColor. BOOLEAN variables: use visible. FLOAT variables: use opacity, rotation, width, height, cornerRadius, topLeftRadius, topRightRadius, bottomLeftRadius, bottomRightRadius, strokeWeight, itemSpacing, paddingTop, paddingRight, paddingBottom, paddingLeft.

Input parameters:

- `field` (string, required): Property to bind: fillColor | strokeColor | visible | opacity | rotation | width | height | cornerRadius | topLeftRadius | topRightRadius | bottomLeftRadius | bottomRightRadius | strokeWeight | itemS…
- `nodeId` (string, required): Target node ID in colon format e.g. 4029:12345
- `variableId` (string, required): Variable ID to bind (from get_variable_defs)

### `clone_node` (~93 tokens)

Clone an existing node, optionally repositioning it or placing it in a new parent.

Input parameters:

- `nodeId` (string, required): Source node ID in colon format e.g. '4029:12345'
- `parentId` (string): Parent node ID for the clone. Defaults to same parent as source.
- `x` (number): X position of the clone
- `y` (number): Y position of the clone

### `create_component` (~75 tokens)

Convert an existing FRAME node into a reusable COMPONENT. The frame is replaced in place by the new component.

Input parameters:

- `name` (string): Optional name for the component. Defaults to the frame's current name.
- `nodeId` (string, required): FRAME node ID to convert, in colon format e.g. '4029:12345'

### `create_effect_style` (~209 tokens)

Create a new local effect style (drop shadow, inner shadow, or blur).

Input parameters:

- `color` (string): Shadow color as hex e.g. #000000 (default #000000, shadows only)
- `description` (string): Optional style description
- `name` (string, required): Style name e.g. 'Shadow/Card'
- `offsetX` (number): Shadow X offset in pixels (default 0, shadows only)
- `offsetY` (number): Shadow Y offset in pixels (default 4, shadows only)
- `opacity` (number): Shadow color opacity 0–1 (default 0.25, shadows only)
- `radius` (number): Blur radius in pixels (default 8 for shadows, 4 for blurs)
- `spread` (number): Shadow spread in pixels (default 0, shadows only)
- `type` (string): Effect type: DROP_SHADOW (default), INNER_SHADOW, LAYER_BLUR, or BACKGROUND_BLUR

### `create_ellipse` (~132 tokens)

Create a new ellipse (circle/oval) on the current page or inside a parent node.

Input parameters:

- `fillColor` (string): Fill color as hex e.g. #3B82F6
- `height` (number): Height in pixels (default 100)
- `name` (string): Ellipse name
- `parentId` (string): Parent node ID in colon format. Defaults to current page.
- `width` (number): Width in pixels (default 100)
- `x` (number): X position (default 0)
- `y` (number): Y position (default 0)

### `create_frame` (~329 tokens)

Create a new frame on the current page or inside a parent node.

Input parameters:

- `counterAxisAlignItems` (string): Cross-axis alignment: MIN, CENTER, MAX, or BASELINE
- `counterAxisSizingMode` (string): Cross-axis sizing: FIXED or AUTO (hug)
- `counterAxisSpacing` (number): Gap between wrapped rows/columns (only when layoutWrap is WRAP)
- `fillColor` (string): Fill color as hex e.g. #FFFFFF
- `height` (number): Height in pixels (default 100)
- `itemSpacing` (number): Auto-layout gap between children
- `layoutMode` (string): Auto-layout direction: HORIZONTAL, VERTICAL, or NONE
- `layoutWrap` (string): Wrap behaviour: NO_WRAP or WRAP
- `name` (string): Frame name
- `paddingBottom` (number): Auto-layout bottom padding
- `paddingLeft` (number): Auto-layout left padding
- `paddingRight` (number): Auto-layout right padding
- `paddingTop` (number): Auto-layout top padding
- `parentId` (string): Parent node ID in colon format. Defaults to current page.
- `primaryAxisAlignItems` (string): Main-axis alignment: MIN, CENTER, MAX, or SPACE_BETWEEN
- `primaryAxisSizingMode` (string): Main-axis sizing: FIXED or AUTO (hug)
- `width` (number): Width in pixels (default 100)
- `x` (number): X position (default 0)
- `y` (number): Y position (default 0)

### `create_grid_style` (~227 tokens)

Create a new local layout grid style.

Input parameters:

- `alignment` (string): Alignment: STRETCH (default), CENTER, MIN, or MAX (COLUMNS/ROWS only)
- `color` (string): Grid line color as hex e.g. #FF0000 (GRID only, default #FF0000)
- `count` (number): Number of columns or rows (COLUMNS/ROWS only, default 12)
- `description` (string): Optional style description
- `gutterSize` (number): Gutter size in pixels (COLUMNS/ROWS only, default 16)
- `name` (string, required): Style name e.g. 'Grid/Desktop'
- `offset` (number): Margin/offset in pixels (COLUMNS/ROWS only, default 0)
- `opacity` (number): Grid line opacity 0–1 (GRID only, default 0.1)
- `pattern` (string): Grid pattern: GRID (default), COLUMNS, or ROWS
- `sectionSize` (number): Grid cell size in pixels (GRID only, default 8)

### `create_paint_style` (~66 tokens)

Create a new local paint style with a solid fill color.

Input parameters:

- `color` (string, required): Fill color as hex e.g. #FF5733
- `description` (string): Optional style description
- `name` (string, required): Style name e.g. 'Brand/Primary'

### `create_rectangle` (~135 tokens)

Create a new rectangle on the current page or inside a parent node.

Input parameters:

- `cornerRadius` (number): Corner radius in pixels
- `fillColor` (string): Fill color as hex e.g. #FF5733
- `height` (number): Height in pixels (default 100)
- `name` (string): Rectangle name
- `parentId` (string): Parent node ID in colon format. Defaults to current page.
- `width` (number): Width in pixels (default 100)
- `x` (number): X position (default 0)
- `y` (number): Y position (default 0)

### `create_section` (~92 tokens)

Create a Figma Section node on the current page. Sections are the modern way to organize frames and groups on a page.

Input parameters:

- `height` (number): Height in pixels
- `name` (string): Section name (default 'Section')
- `width` (number): Width in pixels
- `x` (number): X position (default 0)
- `y` (number): Y position (default 0)

### `create_text` (~250 tokens)

Create a new text node on the current page or inside a parent node. The font is loaded automatically before insertion. Returns the created node ID and bounds. Use set_text to update the content of an existing text node.

Input parameters:

- `fillColor` (string): Text color as hex e.g. #000000 (default black)
- `fontFamily` (string): Font family name e.g. 'Inter', 'Roboto', 'SF Pro Display' (default Inter). Must be a font installed in Figma.
- `fontSize` (number): Font size in pixels (default 14)
- `fontStyle` (string): Font style variant e.g. 'Regular', 'Bold', 'Italic', 'Medium', 'SemiBold' (default Regular). Must match an available style for the chosen fontFamily.
- `name` (string): Node name shown in the layers panel (defaults to the text content)
- `parentId` (string): Parent node ID in colon format. Defaults to current page.
- `text` (string, required): Text content to display
- `x` (number): X position in pixels (default 0)
- `y` (number): Y position in pixels (default 0)

### `create_text_style` (~272 tokens)

Create a new local text style (typography preset). Returns the new style's ID. Apply it to nodes with apply_style_to_node. Use get_styles to list existing text styles.

Input parameters:

- `description` (string): Optional human-readable description shown in the Figma style panel
- `fontFamily` (string): Font family name e.g. 'Inter', 'Roboto' (default Inter). Must be installed in Figma.
- `fontSize` (number): Font size in pixels (default 16)
- `fontStyle` (string): Font style variant e.g. 'Regular', 'Bold', 'Medium', 'SemiBold' (default Regular)
- `letterSpacingUnit` (string): Letter spacing unit: PIXELS (default) or PERCENT
- `letterSpacingValue` (number): Letter spacing value (unit set by letterSpacingUnit)
- `lineHeightUnit` (string): Line height unit: PIXELS (default) or PERCENT
- `lineHeightValue` (number): Line height value (unit set by lineHeightUnit)
- `name` (string, required): Style name — use slash notation to organise into groups e.g. 'Heading/H1', 'Body/Regular'
- `textDecoration` (string): Text decoration: NONE (default), UNDERLINE, or STRIKETHROUGH

### `create_variable` (~186 tokens)

Create a new variable (design token) inside an existing collection. Returns the new variable's ID. Use get_variable_defs to find collection IDs, set_variable_value to set values per mode, and bind_variable_to_node to apply the variable to a node property.

Input parameters:

- `collectionId` (string, required): ID of the variable collection to add this variable to (from get_variable_defs)
- `name` (string, required): Variable name — use slash notation to group e.g. 'Color/Primary', 'Spacing/MD'
- `type` (string, required): Variable type: COLOR (hex color), FLOAT (numeric dimension/spacing), STRING (text), or BOOLEAN (true/false toggle)
- `value` (string): Initial value for the first mode. COLOR: hex e.g. #FF5733. FLOAT: number e.g. 16. STRING: text. BOOLEAN: true or false.

### `create_variable_collection` (~141 tokens)

Create a new local variable collection with an optional initial mode name. NOTE — Figma free plan limits each collection to 1 mode. If you need Light/Dark (or any multi-mode) theming and the user is on the free plan, do NOT try to call add_variable_mode; instead use the name-prefix workaround: create all variables in a single collection and prefix each variable name with its mode, e.g. 'light/color-bg' and 'dark/color-bg'. Inform the user of this limitation.

Input parameters:

- `initialModeName` (string): Name for the initial mode (default 'Mode 1')
- `name` (string, required): Collection name

### `delete_nodes` (~49 tokens)

Delete one or more nodes. This cannot be undone via MCP — use with care.

Input parameters:

- `nodeIds` (array, required): Node IDs to delete in colon format e.g. ['4029:12345']

### `delete_page` (~63 tokens)

Delete a page from the Figma document. Cannot delete the only remaining page.

Input parameters:

- `pageId` (string): Page node ID in colon format e.g. '0:2'
- `pageName` (string): Exact page name to delete (alternative to pageId)

### `delete_style` (~37 tokens)

Delete a style (paint, text, effect, or grid) by its ID.

Input parameters:

- `styleId` (string, required): Style ID to delete

### `delete_variable` (~72 tokens)

Delete a single variable (provide variableId) or an entire collection and all its variables (provide collectionId). Provide exactly one of the two — not both.

Input parameters:

- `collectionId` (string): Collection ID to delete (removes all variables in the collection)
- `variableId` (string): Variable ID to delete

### `detach_instance` (~60 tokens)

Detach one or more component instances, converting them to plain frames. The link to the main component is broken; all visual properties are preserved.

Input parameters:

- `nodeIds` (array, required): INSTANCE node IDs in colon format e.g. ['4029:12345']

### `export_frames_to_pdf` (~99 tokens)

Export multiple frames as a single multi-page PDF file. Each frame becomes one page in order. Ideal for pitch decks, proposals, and slide exports.

Input parameters:

- `nodeIds` (array, required): Ordered list of frame node IDs to export as PDF pages, colon format e.g. '4029:12345'
- `outputPath` (string, required): File path to write the PDF to, must end in .pdf (relative to working directory or absolute)

### `export_tokens` (~52 tokens)

Export all design tokens (variables and paint styles) as JSON or CSS custom properties. Ideal for bridging Figma variables into your codebase.

Input parameters:

- `format` (string): Output format: json (default) or css

### `find_replace_text` (~137 tokens)

Find and replace text content across all TEXT nodes in a subtree. Searches the entire current page if no nodeId is given.

Input parameters:

- `find` (string, required): Text string (or regex pattern when useRegex=true) to search for
- `nodeId` (string): Root node ID to scope the search. Defaults to the entire current page.
- `regexFlags` (string): Regex flags e.g. 'gi' (default 'g'). Only used when useRegex=true.
- `replace` (string, required): Replacement string (use empty string to delete matches)
- `useRegex` (boolean): Treat find as a regular expression (default false)

### `get_annotations` (~86 tokens)

Get dev-mode annotations in the current document or scoped to a specific node. Returns annotation objects with label text, measurement type, and the ID of the annotated node. Omit nodeId to retrieve all annotations on the current page.

Input parameters:

- `nodeId` (string): Optional — scope results to annotations on this node and its descendants, colon format e.g. '4029:12345'

### `get_design_context` (~166 tokens)

Get a depth-limited, token-efficient tree of the current selection or page. Use this instead of get_document when exploring large files. Supports detail levels (minimal/compact/full) and dedupe_components for pages heavy with repeated component instances.

Input parameters:

- `dedupe_components` (boolean): When true, INSTANCE nodes are serialized compactly (mainComponentId + componentProperties + overrides array of differing text/nested content) and unique component definitions are collected once in a…
- `depth` (number): How many levels deep to traverse (default 2)
- `detail` (string): Property verbosity: minimal (id/name/type/bounds only), compact (+fills/strokes/opacity), full (everything, default)

### `get_document` (~50 tokens)

Get the full node tree of the current page (not the whole file — only the active page). Returns all nodes recursively and can be very large. Prefer get_design_context for exploration or when token efficiency matters.

### `get_fonts` (~32 tokens)

List all fonts used in the current page, sorted by usage frequency. Useful for understanding typography without scanning all text nodes.

### `get_local_components` (~20 tokens)

Get all components defined in the current Figma file.

### `get_metadata` (~25 tokens)

Get metadata about the current Figma document: file name, pages, current page

### `get_node` (~79 tokens)

Get a single node by ID with full detail. Use get_nodes_info to fetch multiple nodes in one round-trip instead of calling this repeatedly. Node ID must be colon format e.g. '4029:12345', never hyphens.

Input parameters:

- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'

### `get_nodes_info` (~66 tokens)

Get full details for multiple nodes by ID in one round-trip. Prefer this over calling get_node repeatedly when you need several nodes.

Input parameters:

- `nodeIds` (array, required): List of node IDs in colon format e.g. ['4029:12345', '4029:67890']

### `get_pages` (~26 tokens)

List all pages in the document with their IDs and names. Lightweight alternative to get_document.

### `get_reactions` (~99 tokens)

Get the prototype reactions defined on a node. Returns an array of reaction objects — each has a trigger (e.g. ON_CLICK, ON_HOVER, AFTER_TIMEOUT) and an actions array (navigate to node, open URL, go back, etc.). Use set_reactions to add or replace reactions, remove_reactions to delete them.

Input parameters:

- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'

### `get_screenshot` (~110 tokens)

Export a screenshot of one or more nodes as base64-encoded image data (held in memory). Use save_screenshots instead when you want to write images directly to disk without base64 in the response.

Input parameters:

- `format` (string): Export format: PNG (default), SVG, JPG, or PDF
- `nodeIds` (array): Optional node IDs to export, colon format. If empty, exports current selection.
- `scale` (number): Export scale for raster formats (default 2)

### `get_selection` (~44 tokens)

Get the nodes currently selected in Figma. Returns an empty array if nothing is selected. Use get_design_context or get_node to retrieve deeper detail about a specific node by ID.

### `get_styles` (~65 tokens)

Get all local styles in the document (paint, text, effect, and grid). Returns each style's ID, name, type, and properties. Use the style ID with apply_style_to_node or update_paint_style. For design tokens (variables), use get_variable_defs instead.

### `get_variable_defs` (~31 tokens)

Get all local variable definitions: collections, modes, and values. Variables are Figma's design token system.

### `get_viewport` (~26 tokens)

Get the current Figma viewport: scroll center, zoom level, and visible bounds.

### `group_nodes` (~74 tokens)

Group two or more nodes into a GROUP. All nodes must share the same parent.

Input parameters:

- `name` (string): Optional name for the new group
- `nodeIds` (array, required): Node IDs to group (minimum 2), in colon format e.g. ['4029:12345', '4029:12346']

### `import_image` (~167 tokens)

Import a base64-encoded image into Figma as a rectangle with an image fill. Use get_screenshot to capture images or provide your own base64 PNG/JPG.

Input parameters:

- `height` (number): Height in pixels (default 200)
- `imageData` (string, required): Base64-encoded image data (PNG or JPG)
- `name` (string): Node name
- `parentId` (string): Parent node ID in colon format. Defaults to current page.
- `scaleMode` (string): Image scale mode: FILL (default), FIT, CROP, or TILE
- `width` (number): Width in pixels (default 200)
- `x` (number): X position (default 0)
- `y` (number): Y position (default 0)

### `lock_nodes` (~43 tokens)

Lock one or more nodes to prevent accidental edits in Figma.

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']

### `move_nodes` (~80 tokens)

Move one or more nodes to an absolute canvas position. The same x/y is applied to every node independently (not a relative offset from current position).

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `x` (number): Target X position
- `y` (number): Target Y position

### `navigate_to_page` (~59 tokens)

Switch the active Figma page. Provide either pageId or pageName.

Input parameters:

- `pageId` (string): Page node ID in colon format e.g. '0:1'
- `pageName` (string): Exact page name to navigate to

### `remove_reactions` (~90 tokens)

Remove prototype reactions from a node. Omit indices to remove all reactions. Provide a zero-based indices array to remove specific reactions (use get_reactions first to see current indices).

Input parameters:

- `indices` (array): Zero-based indices of reactions to remove. Omit or pass [] to remove all.
- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'

### `rename_node` (~104 tokens)

Rename a single node by ID. Returns the updated node with its new name. Use batch_rename_nodes to rename multiple nodes at once or to apply find/replace patterns across many nodes.

Input parameters:

- `name` (string, required): New name for the node. Figma supports slash-separated path notation e.g. 'Icons/Arrow/Left' to organise nodes in component panels.
- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'

### `rename_page` (~70 tokens)

Rename an existing page in the Figma document.

Input parameters:

- `newName` (string, required): New name for the page
- `pageId` (string): Page node ID in colon format e.g. '0:2'
- `pageName` (string): Current page name to find (alternative to pageId)

### `reorder_nodes` (~69 tokens)

Change the z-order (layer stack position) of one or more nodes.

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `order` (string, required): Order operation: bringToFront, sendToBack, bringForward, or sendBackward

### `reparent_nodes` (~72 tokens)

Move one or more nodes to a different parent frame, group, or section.

Input parameters:

- `nodeIds` (array, required): Node IDs to move in colon format e.g. ['4029:12345']
- `parentId` (string, required): Target parent node ID in colon format e.g. '4029:99'

### `resize_nodes` (~81 tokens)

Resize one or more nodes. The same width/height is applied to every node in the list independently. Provide width, height, or both.

Input parameters:

- `height` (number): New height in pixels
- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `width` (number): New width in pixels

### `rotate_nodes` (~62 tokens)

Rotate one or more nodes to an absolute angle in degrees.

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `rotation` (number, required): Rotation angle in degrees (positive = counter-clockwise in Figma)

### `save_screenshots` (~115 tokens)

Export screenshots for multiple nodes and write them to the local filesystem. Returns file metadata (path, size, dimensions) — no base64 in the response. Use get_screenshot instead when you need the image data in memory.

Input parameters:

- `format` (string): Default export format: PNG (default), SVG, JPG, or PDF
- `items` (array, required): List of {nodeId, outputPath, format?, scale?} objects
- `scale` (number): Default export scale for raster formats (default 2)

### `scan_nodes_by_types` (~85 tokens)

Find all nodes of specific types in a subtree, regardless of name. Use search_nodes instead when you need to filter by name.

Input parameters:

- `nodeId` (string, required): Root node ID to scan from, colon format e.g. '4029:12345'
- `types` (array, required): Node types to find e.g. ['FRAME', 'COMPONENT', 'INSTANCE']

### `scan_text_nodes` (~72 tokens)

Scan all TEXT nodes in a subtree and return their content. Shorthand for scan_nodes_by_types with ['TEXT'] — use when you only need text copy from a component or frame.

Input parameters:

- `nodeId` (string, required): Root node ID to scan from, colon format e.g. '4029:12345'

### `search_nodes` (~137 tokens)

Search for nodes by name substring and/or type within a subtree. Use this when you know (part of) the node name. Use scan_nodes_by_types when you want all nodes of a type regardless of name.

Input parameters:

- `limit` (number): Maximum results to return (default: 50)
- `nodeId` (string): Scope search to this subtree (default: current page), colon format e.g. '4029:12345'
- `query` (string, required): Name substring to match (case-insensitive)
- `types` (array): Filter by Figma node type e.g. ['TEXT', 'FRAME', 'COMPONENT']

### `set_auto_layout` (~244 tokens)

Set or update auto-layout (flex) properties on an existing frame.

Input parameters:

- `counterAxisAlignItems` (string): Cross-axis alignment: MIN, CENTER, MAX, or BASELINE
- `counterAxisSizingMode` (string): Cross-axis sizing: FIXED or AUTO (hug)
- `counterAxisSpacing` (number): Gap between wrapped rows/columns (only when layoutWrap is WRAP)
- `itemSpacing` (number): Gap between children
- `layoutMode` (string): Auto-layout direction: HORIZONTAL, VERTICAL, or NONE
- `layoutWrap` (string): Wrap behaviour: NO_WRAP or WRAP
- `nodeId` (string, required): Frame node ID in colon format e.g. '4029:12345'
- `paddingBottom` (number): Bottom padding
- `paddingLeft` (number): Left padding
- `paddingRight` (number): Right padding
- `paddingTop` (number): Top padding
- `primaryAxisAlignItems` (string): Main-axis alignment: MIN, CENTER, MAX, or SPACE_BETWEEN
- `primaryAxisSizingMode` (string): Main-axis sizing: FIXED or AUTO (hug)

### `set_blend_mode` (~120 tokens)

Set the blend mode of one or more nodes (e.g. MULTIPLY, SCREEN, OVERLAY).

Input parameters:

- `blendMode` (string, required): Blend mode: NORMAL, MULTIPLY, SCREEN, OVERLAY, DARKEN, LIGHTEN, COLOR_DODGE, COLOR_BURN, HARD_LIGHT, SOFT_LIGHT, DIFFERENCE, EXCLUSION, HUE, SATURATION, COLOR, LUMINOSITY, PASS_THROUGH
- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']

### `set_constraints` (~100 tokens)

Set layout constraints (pinning behaviour) on one or more nodes relative to their parent.

Input parameters:

- `horizontal` (string): Horizontal constraint: MIN (left), MAX (right), CENTER, STRETCH, or SCALE
- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `vertical` (string): Vertical constraint: MIN (top), MAX (bottom), CENTER, STRETCH, or SCALE

### `set_corner_radius` (~119 tokens)

Set corner radius on one or more nodes. Provide a uniform cornerRadius or individual per-corner values.

Input parameters:

- `bottomLeftRadius` (number): Bottom-left corner radius
- `bottomRightRadius` (number): Bottom-right corner radius
- `cornerRadius` (number): Uniform corner radius applied to all corners
- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `topLeftRadius` (number): Top-left corner radius
- `topRightRadius` (number): Top-right corner radius

### `set_effects` (~143 tokens)

Apply one or more effects (drop shadow, inner shadow, layer blur, background blur) directly to a node. Replaces all existing effects. Pass an empty array to clear all effects.

Input parameters:

- `effects` (array, required): Array of effect objects. Each has: type (DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR), radius, color (hex, shadows only), opacity (0–1, shadows only), offsetX, offsetY (shadows only), s…
- `nodeId` (string, required): Target node ID in colon format e.g. 4029:12345

### `set_fills` (~171 tokens)

Set the fill color on a single node (takes one nodeId, not an array). Use mode='append' to stack a new fill on top of existing fills instead of replacing them.

Input parameters:

- `color` (string, required): Fill color as hex: #RRGGBB e.g. #FF5733 or #RRGGBBAA e.g. #FF573380 for 50% alpha
- `mode` (string): 'replace' (default) overwrites all existing fills; 'append' stacks this fill on top of existing ones
- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'
- `opacity` (number): Fill opacity 0–1 (default 1). Combines multiplicatively with any alpha in the color hex.

### `set_opacity` (~67 tokens)

Set the opacity of one or more nodes (0 = fully transparent, 1 = fully opaque).

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `opacity` (number, required): Opacity value between 0 and 1

### `set_reactions` (~695 tokens)

Set prototype reactions on a node. Use mode "replace" (default) to overwrite all reactions, or "append" to add to existing ones.

Supported triggers: ON_CLICK, ON_HOVER, ON_PRESS, ON_DRAG, AFTER_TIMEOUT, MOUSE_ENTER, MOUSE_LEAVE, MOUSE_UP, MOUSE_DOWN
Supported action types: NODE (navigation), BACK, CLOSE, URL
  NODE navigation values: NAVIGATE, OVERLAY, SCROLL_TO, SWAP, CHANGE_TO
Transition types: DISSOLVE, SMART_ANIMATE, MOVE_IN, MOVE_OUT, PUSH, SLIDE_IN, SLIDE_OUT
  DISSOLVE / SMART_ANIMATE: {"type":"DISSOLVE","duration":0.3,"easing":{"type":"EASE_OUT"}}
  Directional (PUSH, MOVE_IN, MOVE_OUT, SLIDE_IN, SLIDE_OUT): also require "direction" (LEFT|RIGHT|TOP|BOTTOM) and "matchLayers" (bool):
    {"type":"PUSH","direction":"LEFT","matchLayers":false,"duration":0.3,"easing":{"type":"EASE_OUT"}}

Each reaction has a "trigger" and an "actions" array (plural). Each action in the array is an Action object.

Example — on-click navigate with dissolve:
{"nodeId":"1:2","reactions":[{"trigger":{"type":"ON_CLICK"},"actions":[{"type":"NODE","destinationId":"1:3","navigation":"NAVIGATE","transition":{"type":"DISSOLVE","duration":0.3,"easing":{"type":"EASE_OUT"}},"preserveScrollPosition":false}]}]}

Example — on-click navigate with push (directional transition):
{"nodeId":"1:2","reactions":[{"trigger":{"type":"ON_CLICK"},"actions":[{"type":"NODE","destinationId":"1:3","navigation":"NAVIGATE","transition":{"type":"PUSH","direction":"LEFT","matchLayers":false,"duration":0.3,"easing":{"type":"EASE_OUT"}},"preserveScrollPosition":false}]}]}

Example — open URL on hover:
{"nodeId":"1:2","reactions":[{"trigger":{"type":"ON_HOVER"},"actions":[{"type":"URL","url":"https://example.com"}]}]}

Example — auto-advance after 3 seconds:
{"nodeId":"1:2","reactions":[{"trigger":{"type":"AFTER_TIMEOUT","timeout":3000},"actions":[{"type":"NODE","destinationId":"1:4","navigation":"NAVIGATE","transition":{"type":"DISSOLVE","duration":0.3,"easing":{"type":"EASE_OUT"}},"preserveScrollPosition":false}]}]…

Input parameters:

- `mode` (string): "replace" (default) overwrites all existing reactions; "append" adds to them
- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'
- `reactions` (array, required): Array of reaction objects. Each has a 'trigger' and an 'actions' array (plural) of Action objects.

### `set_strokes` (~131 tokens)

Set the stroke color and weight on a single node (takes one nodeId, not an array). Use mode='append' to stack a new stroke on top of existing strokes instead of replacing them.

Input parameters:

- `color` (string, required): Stroke color as hex e.g. #000000
- `mode` (string): 'replace' (default) overwrites all strokes; 'append' stacks on top of existing strokes
- `nodeId` (string, required): Node ID in colon format e.g. '4029:12345'
- `strokeWeight` (number): Stroke weight in pixels (default 1)

### `set_text` (~51 tokens)

Update the text content of an existing TEXT node.

Input parameters:

- `nodeId` (string, required): TEXT node ID in colon format e.g. '4029:12345'
- `text` (string, required): New text content

### `set_variable_value` (~82 tokens)

Set a variable's value for a specific mode.

Input parameters:

- `modeId` (string, required): Mode ID within the collection
- `value` (string, required): Value to set. COLOR: hex e.g. #FF5733. FLOAT: number e.g. 16. STRING: text. BOOLEAN: true or false.
- `variableId` (string, required): Variable ID

### `set_visible` (~59 tokens)

Show or hide one or more nodes by setting their visibility.

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']
- `visible` (boolean, required): true to show the node, false to hide it

### `swap_component` (~73 tokens)

Swap the main component of an existing INSTANCE node, replacing it with a different component while keeping position and size.

Input parameters:

- `componentId` (string, required): Target COMPONENT node ID in colon format (from get_local_components)
- `nodeId` (string, required): INSTANCE node ID in colon format e.g. 4029:12345

### `ungroup_nodes` (~51 tokens)

Ungroup one or more GROUP nodes, moving their children to the parent and removing the group.

Input parameters:

- `nodeIds` (array, required): GROUP node IDs in colon format e.g. ['4029:12345']

### `unlock_nodes` (~43 tokens)

Unlock one or more nodes, allowing them to be edited again.

Input parameters:

- `nodeIds` (array, required): Node IDs in colon format e.g. ['4029:12345']

### `update_paint_style` (~98 tokens)

Update an existing paint style's name, color, or description. Only paint styles support in-place updates — to modify text, effect, or grid styles, use delete_style and recreate them.

Input parameters:

- `color` (string): New fill color as hex e.g. #FF5733
- `description` (string): New style description
- `name` (string): New style name
- `styleId` (string, required): Paint style ID

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go#diagnostics

## Score history

- 2026-08-07: 65
- 2026-08-06: 59
- 2026-08-05: 34
- 2026-08-04: 34
- 2026-08-03: 34
- 2026-08-02: 34
- 2026-08-01: 19
- 2026-07-31: 19
- 2026-07-30: 23
- 2026-07-28: 41
- 2026-07-27: 41
- 2026-07-26: 41

## Links

- npm package: https://www.npmjs.com/package/@vkhanhqui/figma-mcp-go
- Socket report: https://socket.dev/npm/package/@vkhanhqui/figma-mcp-go
- Changelog RSS feed: https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go.xml
- Changelog JSON feed: https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go.json
- HTML version of this page: https://verifymcp.io/servers/vkhanhqui-figma-mcp-go/vkhanhqui-figma-mcp-go