Start the WebSocket server and wait for the Figma plugin to connect. Call this when the user says "start figma session", "connect to figma", or "open slides". Returns connection status and instructions if not yet connected.

Check if the Figma plugin is connected. Does NOT start the server — use start_session first.

Get editor type, document name, and page count from the connected Figma file

Get the full slide deck structure: rows and slides with their IDs and names

Get a rich semantic dump of everything on a slide: text content, shapes, images, positions, styles. Best for understanding what is on a slide before editing.

Capture a visual screenshot of a slide as PNG. Returns base64-encoded image.

Capture thumbnails of all slides. Returns array of base64 PNG images.

Create a new empty slide (fixed 1920x1080).

Remove all content from a slide, keeping the slide itself.

Create a node (FRAME, RECTANGLE, ELLIPSE, POLYGON, STAR, LINE, VECTOR, TEXT) with optional properties. For tables, shapes-with-text, etc., use dedicated tools.

Modify properties of any node. Supports x, y, width, height, rotation, fills, strokes, strokeWeight, effects, opacity, blendMode, cornerRadius, visible, locked, layoutMode, itemSpacing, padding.

Remove a node from the canvas

Duplicate a node, optionally reparenting the clone.

Move a node to a different parent container

Group multiple nodes together

Ungroup a group node, returning children to parent

Set text content of a text node. Font loading is automatic.

Apply styles to a character range: fontSize, fontName, fills, letterSpacing, lineHeight, textDecoration, textCase

Read text content and style segments from a text node

Search available fonts. Use query to filter by family name. Without query, returns first 50 families.

Place an image from URL or bytes. Creates a rectangle with IMAGE fill.

Create a new slide row in the deck grid

Clone a slide with all content

Remove a slide from the deck

Remove a slide row and all slides in it

Set the order of slide rows in the deck

Move a slide to a different row

Set transition: DISSOLVE, SLIDE_FROM_LEFT/RIGHT/TOP/BOTTOM, PUSH_FROM_*, SMART_ANIMATE, NONE

Mark slide as skipped in presentation

Apply a theme to a slide

Navigate to a specific slide in the editor

Switch between grid and single-slide view

Create a table (Slides/FigJam only)

Set text of a table cell

Read text of a table cell

Insert a row into a table

Insert a column into a table

Remove a row from a table

Remove a column from a table

Create a shape with built-in text label (Slides/FigJam). shapeType: SQUARE, ELLIPSE, ROUNDED_RECTANGLE, DIAMOND, TRIANGLE_UP, etc.

Create a GIF node (Slides only, may have limited support)

Create a video node from URL or bytes (Slides only, MP4/MOV/WebM)

Replace media content of a video/image node

Get structural tree: IDs, types, names, bounds. Use depth to limit recursion.

Read all or specific properties of a node

Search for nodes by name (substring), type, visible, locked. All criteria AND-combined.

Get currently selected node IDs

Select specific nodes

List interactive elements on a slide (polls, embeds). Read-only.

List available slide themes

Export any node to PNG, JPG, SVG, or PDF

Set editor viewport center and zoom

Zoom to fit specific nodes or all content

Execute multiple commands in one round-trip. Use "$N.field" to reference results from earlier commands (e.g. "$0.nodeId"). All execute as single undo step.

Import an SVG string as editable Figma vector nodes. Use for icons, logos, simple graphics. The agent generates the SVG string directly.

Render a D3.js visualization as editable Figma vector nodes. PREFERRED for data visualizations, charts, graphs, diagrams.

The script runs in the plugin iframe with full D3 v7 available. Write JS that uses d3 to build SVG in the scratch div. The SVG is auto-extracted and converted to editable Figma nodes.

Available globals: d3, scratch (offscreen div to render into). The script should either return an SVG string or render into scratch (auto-extracted).

IMPORTANT: All text becomes editable Figma text nodes. This is the best renderer for data-driven graphics.

Render hand-drawn / sketchy style graphics using Rough.js as editable Figma nodes.

Use for: informal diagrams, whiteboard-style visuals, creative/playful graphics. Available: rough (Rough.js), scratch div, plus a pre-created SVG element.

Write JS that uses rough.svg(svg) to draw shapes. They render with a hand-drawn aesthetic (hachure, cross-hatch, zigzag, dots fills).

IMPORTANT: All output is editable vector nodes in Figma.

Render HTML/CSS layout as editable Figma vector nodes using Satori (Vercel's HTML-to-SVG engine).

Use ONLY when you need complex CSS layouts that are hard to express as SVG — flexbox cards, multi-column layouts, UI components. For data viz, prefer render_d3 instead.

LIMITATIONS:

• Text is rendered as vector PATHS, not editable text nodes. Users cannot edit text in Figma.

• No CSS gradients (use solid colors instead)

• No rgba() (use hex colors)

• Requires fetching a font file (adds latency)

• Uses JSX-object syntax, not HTML strings

The script runs in the iframe. Use the satori() function with JSX-like objects. Must fetch a font first: fetch Inter WOFF, pass as fonts array.

Available: satori (the render function), scratch div.