# Figma Proxy MCP (npm · figma-proxy-mcp)

Figma → code: tokenized IR, PNG renders and SSIM/pixel visual diff to verify builds.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

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

## Channel facts

- Registry: `npm`
- Package: `figma-proxy-mcp`
- Version: `1.1.1`
- 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-11-21.

- **Supply Chain Security**: 98/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.
  - 23 of 70 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 5 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1796 tokens (~199/item across 9 items; 9 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.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 9 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 10 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; 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

### How do I install the Figma Proxy MCP server?

Figma Proxy MCP runs locally as an npm package, launched with npx -y figma-proxy-mcp --stdio. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add semmargl-figma-proxy-mcp -- npx -y figma-proxy-mcp --stdio
```

### Cursor

```json
{
  "mcpServers": {
    "semmargl-figma-proxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "figma-proxy-mcp",
        "--stdio"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "semmargl-figma-proxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "figma-proxy-mcp",
        "--stdio"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add semmargl-figma-proxy-mcp -- npx -y figma-proxy-mcp --stdio
```

### opencode

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

### Hermes

```yaml
mcp_servers:
  semmargl-figma-proxy-mcp:
    command: "npx"
    args: ["-y", "figma-proxy-mcp", "--stdio"]
```

### Netclaw

```json
{
  "McpServers": {
    "semmargl-figma-proxy-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "figma-proxy-mcp",
        "--stdio"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "semmargl-figma-proxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "figma-proxy-mcp",
        "--stdio"
      ]
    }
  }
}
```

## 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-11-17 (score 65, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-16 (score 50)

First indexed and scored.

## MCP tools (9)

### `get_figma_file` (~49 tokens)

Get Figma file data by file ID and transform it for development

Input parameters:

- `fileId` (string, required): Figma file ID (from the URL: figma.com/file/{fileId}/...)

### `get_figma_component` (~556 tokens)

Get a Figma node by URL. Returns a deterministic, pruned + tokenized + componentized IR with a :root{} CSS-variable block, a Tailwind theme, and a component registry. Colors/spacing/fonts are already resolved to $--var references — the caller does NOT need to re-match raw RGBA against :root. For large sections, call with summary:true FIRST to get a compact { cssVars, tailwindTheme, registry, sections[] } object (top-level children with bounding boxes) WITHOUT the full node tree; this replaces manual get_figma_file decomposition. Then fetch individual sections (optionally with maxDepth) to build them.

Input parameters:

- `componentize` (boolean): Cluster repeated nodes into a component registry with variant axes and named text styles. Default true.
- `figmaUrl` (string, required): Full Figma URL to a specific node (e.g., https://www.figma.com/design/{fileId}/...?node-id={nodeId})
- `format` (string): (non-summary) IR shape. "nested" (default) = full annotated tree. "flat" = a flat array of compact node records (render fields only, coords RELATIVE to the root frame) — much smaller and machine-read…
- `lean` (boolean): Omit the global blocks (CSS vars, Tailwind theme, component registry) that are identical on every call. Pass true on per-section fetches AFTER the summary call to avoid re-sending ~15KB of duplicated…
- `maxDepth` (number): Cap the IR tree depth (e.g. 3-4) to keep a large section compact without manual decomposition. Omit for full depth.
- `minFreq` (number): Minimum occurrences for a value to become a design token during tokenization (default 2).
- `prune` (boolean): Run the deterministic noise-pruning pass (collapse decorative wrappers, drop invisible/zero-size nodes). Default true; set false for raw IR (debug).
- `summary` (boolean): When true, return a compact summary (component meta, CSS vars, Tailwind theme, component registry, and top-level sections with bounding boxes) instead of the full annotated IR tree. Recommended first…
- `tokenize` (boolean): Run frequency-analysis tokenization: emit :root CSS vars + Tailwind theme and replace raw color/spacing/font values in the IR with $--var references. Default true.

### `export_svg` (~141 tokens)

Export a specific Figma node as SVG and optionally save it

Input parameters:

- `fileId` (string, required): Figma file ID
- `fileName` (string): Custom filename for saved SVG (optional)
- `nodeId` (string, required): Node ID to export as SVG
- `outputDir` (string): Output directory for saved SVGs (default: $FIGMA_PROXY_SVG_DIR or ./exported-svgs relative to the server working directory; pass an absolute path to be explicit)
- `save` (boolean): Whether to save the SVG to disk (default: false)
- `scale` (number): Scale factor for export (default: 1)

### `render_node_png` (~126 tokens)

Export a specific Figma node as PNG and return base64-encoded image data

Input parameters:

- `figmaUrl` (string): Full Figma URL to a specific node (e.g., https://www.figma.com/design/{fileId}/...?node-id={nodeId})
- `fileId` (string): Figma file ID (alternative to figmaUrl)
- `nodeId` (string): Node ID to export (alternative to figmaUrl, use colon format: 12:34)
- `scale` (number): Scale factor for PNG export (default: 2)

### `migrate_all_svgs` (~85 tokens)

Automatically find and export all SVG icons from a Figma file

Input parameters:

- `fileId` (string, required): Figma file ID to migrate SVGs from
- `outputDir` (string): Output directory for exported SVGs (default: $FIGMA_PROXY_SVG_DIR or ./exported-svgs relative to the server working directory; pass an absolute path to be explicit)

### `get_cached_components` (~17 tokens)

Get previously fetched Figma components data

### `get_component_by_name` (~35 tokens)

Get a specific Figma component by name from cached data

Input parameters:

- `name` (string, required): Name of the component to find

### `list_svg_cache` (~15 tokens)

List all cached SVG exports

### `verify_render` (~460 tokens)

Visual verification (MEASUREMENT ONLY): render an HTML file with headless Chromium INSIDE this server (does NOT use the user's own browser) and compare it to the Figma design PNG. Returns SSIM (0-1, higher = closer), pixel-diff %, and clustered diff regions (bounding boxes of disagreement, in logical px). Provide the reference PNG via figmaUrl (auto-fetched), figmaPngPath, or figmaPngBase64. Use after generating HTML to objectively check fidelity, then fix only the reported regions — this tool never changes code. Requires Playwright Chromium: `npx playwright install chromium`.

Input parameters:

- `bg` (array): Background [r,g,b] to flatten transparent reference-PNG pixels onto before comparing. Default [255,255,255]. For dark designs pass the real background (e.g. [13,17,23]) — otherwise transparent areas…
- `clip` (array): Optional [x,y,w,h] in CSS/logical px to compare ONLY the content area. Use it to exclude dead margins / parent-canvas background that the isolated frame cannot reproduce (that noise otherwise dominat…
- `figmaPngBase64` (string): Alternative: base64 of the reference PNG.
- `figmaPngPath` (string): Alternative to figmaUrl: local path to an already-saved reference PNG.
- `figmaUrl` (string): Figma node URL — reference PNG fetched automatically at the given scale.
- `frameWidth` (number, required): Figma frame width in CSS px (e.g. 1440 or 1920). HTML is rendered at this width.
- `htmlPath` (string, required): Absolute path to the generated .html file to render.
- `outDir` (string): Directory for the diff image (default: $FIGMA_PROXY_VERIFY_DIR or <os temp dir>/figma-proxy-mcp/verify-out).
- `scale` (number): Device scale factor for render and reference (default 2 — match render_node_png).
- `threshold` (number): SSIM pass threshold (default 0.95).

## Diagnostics

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

## Score history

- 2026-11-21: 65
- 2026-11-20: 65
- 2026-11-19: 65
- 2026-11-18: 65
- 2026-11-17: 65
- 2026-11-16: 50

## Common questions

### What is the Figma Proxy MCP server?

Figma Proxy MCP is listed in the public MCP registry as io.github.Semmargl/figma-proxy-mcp. Figma → code: tokenized IR, PNG renders and SSIM/pixel visual diff to verify builds. This page covers its npm package (figma-proxy-mcp).

### Is the Figma Proxy MCP server safe to use?

Figma Proxy MCP scores 65 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Figma Proxy MCP server expose?

Figma Proxy MCP exposes 9 tools: get_figma_file, get_figma_component, export_svg, render_node_png, migrate_all_svgs, and 4 more. Their descriptions and schemas cost roughly 1,484 tokens of context every time the server is loaded.

### Is the Figma Proxy MCP server still maintained?

Figma Proxy MCP is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Figma Proxy MCP server under?

Figma Proxy MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Figma Proxy MCP server?

VerifyMCP ran 15 checks on Figma Proxy MCP, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Figma Proxy MCP: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/figma-proxy-mcp
- Socket report: https://socket.dev/npm/package/figma-proxy-mcp
- Repository: https://github.com/Semmargl/figma-proxy-mcp
- Changelog RSS feed: https://verifymcp.io/servers/semmargl-figma-proxy-mcp/figma-proxy-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/semmargl-figma-proxy-mcp/figma-proxy-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/semmargl-figma-proxy-mcp/figma-proxy-mcp.json
- HTML version of this page: https://verifymcp.io/servers/semmargl-figma-proxy-mcp/figma-proxy-mcp
