Skip to main content
Glama
figma-tunnel-mcp

figma-tunnel-mcp

by skulidropek

Figma HTTP API

Share the currently open Figma file with an AI agent through one HTTPS URL. The agent reads llms.txt and uses ordinary GET and POST requests.

AI agent
   │ HTTPS API
   ▼
Local API server (:8765) ← Cloudflare Tunnel
   │ local WebSocket
   ▼
Figma API Plugin ↔ open Figma file

The WebSocket relay is an internal transport. It is not exposed publicly and is not an interface for agents.

Start on Windows

Requirements: Figma Desktop, Node.js, Bun, and Cloudflared.

  1. In Figma, import src/plugin/manifest.json as a development plugin once.

  2. Start everything with one command:

    .\start.cmd

The command starts the internal relay, HTTP API, Figma, Cloudflare Tunnel, and the plugin watchdog. It then tries to open the plugin and verifies that the current document answers.

Nothing is installed in Windows Startup. Re-running the command is safe and only repairs missing services.

Related MCP server: Agent to Figma MCP

Plugin controls

After the server is running, normal management happens in the Figma plugin:

  • API, Figma, and tunnel status;

  • read-only or read/write access;

  • copy/open share URL and scoped llms.txt;

  • start, stop, or replace the Cloudflare quick tunnel;

  • rotate the secret share URL;

  • repair the local stack.

Public API

Give the agent only the generated share URL:

https://<host>.trycloudflare.com/s/<secret>

The main routes are:

Method

Route

Purpose

GET

/s/{secret}

Discover exact URLs and current state

GET

/s/{secret}/llms.txt

Complete live API instructions

GET

/v1/shares/{secret}/llms.txt

Documentation for this share

GET

/v1/shares/{secret}/{topic}/llms.txt

Documentation for one route or operation

GET

/v1/shares/{secret}/status

Check readiness

GET

/v1/shares/{secret}/capabilities

List available Figma operations

POST

/v1/shares/{secret}/{operation}

Execute an operation; the body contains its parameters

GET

/openapi.json

OpenAPI 3.1 contract

Example read request:

POST /v1/shares/{secret}/get_document_info
Content-Type: application/json

{}

Write requests also require an Idempotency-Key header. Documentation is hierarchical: service errors link to /llms.txt, share errors link to /v1/shares/{secret}/llms.txt, and known route errors link to that route's own llms.txt.

Security

  • The random share URL is a bearer capability; anyone holding it gets the configured access.

  • Public access can be stopped immediately from the plugin.

  • Rotating the secret invalidates the previous share URL.

  • Management routes under /local/control/* accept only loopback plugin requests and return 404 through Cloudflare.

  • The internal relay binds only to 127.0.0.1.

  • Access mode and tunnel state persist across server repairs.

Project files

File

Purpose

start.cmd

Single user-facing start command

src/api/

Public API server and health probe

src/relay/

Loopback-only Figma transport

src/plugin/

Figma development plugin

scripts/

Windows bootstrap, watchdog, tunnel, and Figma launcher

Available Tools

40 tools
clone_nodeC

Clone an existing node in Figma

Inputs: nodeId (required), x, y.

create_component_instanceA

Create an instance of a component in Figma. For LOCAL components (from get_local_components), use componentId with the id field. For published LIBRARY components, use componentKey with the publishedKey field.

Inputs: x (required), y (required), parentId, componentId, +1 more.

create_connectionsB

Create connections between nodes using the default connector style

Inputs: connections (required).

create_frameC

Create a new frame in Figma

Inputs: x (required), y (required), width (required), height (required), +16 more.

create_rectangleC

Create a new rectangle in Figma

Inputs: x (required), y (required), width (required), height (required), +2 more.

create_textC

Create a new text element in Figma

Inputs: x (required), y (required), text (required), name, +4 more.

delete_multiple_nodesB

Delete multiple nodes from Figma at once

Inputs: nodeIds (required).

delete_nodeC

Delete a node from Figma

Inputs: nodeId (required).

export_node_as_imageC

Export a node as an image from Figma

Inputs: nodeId (required), scale, format.

get_annotationsB

Get all annotations in the current document or specific node

Inputs: nodeId (required), includeCategories.

get_document_infoA

Get detailed information about the current Figma document

Inputs: no named parameters.

get_instance_overridesA

Get all override properties from a selected component instance. These overrides can be applied to other instances, which will swap them to match the source component.

Inputs: nodeId.

get_local_componentsA

Get all local components from the Figma document

Inputs: no named parameters.

get_node_infoB

Get detailed information about a specific node in Figma

Inputs: nodeId (required).

get_nodes_infoC

Get detailed information about multiple nodes in Figma

Inputs: nodeIds (required).

get_reactionsA

Get Figma Prototyping Reactions from multiple nodes. CRITICAL: The output MUST be processed using the 'reaction_to_connector_strategy' prompt IMMEDIATELY to generate parameters for connector lines via the 'create_connections' tool.

Inputs: nodeIds (required).

get_selectionB

Get information about the current selection in Figma

Inputs: no named parameters.

get_stylesA

Get all styles from the current Figma document

Inputs: no named parameters.

join_channelC

Join a specific channel to communicate with Figma

Inputs: channel.

move_nodeC

Move a node to a new position in Figma

Inputs: x (required), y (required), nodeId (required).

read_my_designA

Get detailed information about the current selection in Figma, including all node details

Inputs: no named parameters.

resize_nodeC

Resize a node in Figma

Inputs: width (required), height (required), nodeId (required).

scan_nodes_by_typesC

Scan for child nodes with specific types in the selected Figma node

Inputs: types (required), nodeId (required).

scan_text_nodesC

Scan all text nodes in the selected Figma node

Inputs: nodeId (required).

set_annotationB

Create or update an annotation

Inputs: nodeId (required), labelMarkdown (required), categoryId, properties, +1 more.

set_axis_alignA

Set primary and counter axis alignment for an auto-layout frame in Figma

Inputs: nodeId (required), counterAxisAlignItems, primaryAxisAlignItems.

set_corner_radiusA

Set the corner radius of a node in Figma

Inputs: nodeId (required), radius (required), corners.

set_default_connectorB

Set a copied connector node as the default connector

Inputs: connectorId.

set_fill_colorC

Set the fill color of a node in Figma can be TextNode or FrameNode

Inputs: b (required), g (required), r (required), nodeId (required), +1 more.

set_focusA

Set focus on a specific node in Figma by selecting it and scrolling viewport to it

Inputs: nodeId (required).

set_instance_overridesA

Apply previously copied overrides to selected component instances. Target instances will be swapped to the source component and all copied override properties will be applied.

Inputs: targetNodeIds (required), sourceInstanceId (required).

set_item_spacingA

Set distance between children in an auto-layout frame

Inputs: nodeId (required), itemSpacing, counterAxisSpacing.

set_layout_modeB

Set the layout mode and wrap behavior of a frame in Figma

Inputs: nodeId (required), layoutMode (required), layoutWrap.

set_layout_sizingA

Set horizontal and vertical sizing modes for an auto-layout frame in Figma

Inputs: nodeId (required), layoutSizingVertical, layoutSizingHorizontal.

set_multiple_annotationsC

Set multiple annotations parallelly in a node

Inputs: nodeId (required), annotations (required).

set_multiple_text_contentsB

Set multiple text contents parallelly in a node

Inputs: text (required), nodeId (required).

set_paddingB

Set padding values for an auto-layout frame in Figma

Inputs: nodeId (required), paddingTop, paddingLeft, paddingRight, +1 more.

set_selectionsA

Set selection to multiple nodes in Figma and scroll viewport to show them

Inputs: nodeIds (required).

set_stroke_colorB

Set the stroke color of a node in Figma

Inputs: b (required), g (required), r (required), nodeId (required), +2 more.

set_text_contentA

Set the text content of an existing text node in Figma

Inputs: text (required), nodeId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 40 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is slight overlap between get_selection and read_my_design, and between set_selections and set_focus. Annotation and text tools are clearly separated by singular/plural variants.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case, e.g., create_frame, delete_node, set_fill_color. No mixed conventions or ambiguous verb choices.

    Tool Count3/5

    With 40 tools, the server is on the heavy side for a typical MCP server. While Figma is complex, the tool count may overwhelm agents; some property-setting tools could potentially be consolidated.

    Completeness4/5

    The tool set covers many common Figma operations (CRUD for nodes, components, styles, annotations, layout properties, and selection management). Missing operations like reordering or grouping nodes are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables AI agents to read and modify Figma designs programmatically through WebSocket communication, supporting document manipulation, styling, text replacement, and component management.
      42
      5
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables local AI agents to generate and edit Figma designs via the Plugin API through a WebSocket relay, with no rate limits and all communication remaining local.
      50
      MIT