figma-console-mcp 1.34.0 → 1.35.0

package/README.md

@@ -8,7 +8,7 @@
 
 > **Your design system as an API.** Model Context Protocol server that bridges design and development—giving AI assistants complete access to Figma for **extraction**, **creation**, **debugging**, and **bidirectional token sync**.
 
-> **🆕 Bidirectional Token Sync v2 + DTCG 2025.10 (v1.34.0):** `figma_import_tokens` now applies the *whole* diff plan — creates, renames, alias re-targeting, and replace-gated deletes — for a true code→Figma round-trip; exports speak DTCG 2025.10 on request (opt-in, legacy default byte-identical); scopes/codeSyntax round-trip; `figma_setup_design_tokens` accepts alias values; and the new `figma_create_component_set` builds a full variant set from an axes matrix in one call. **Plugin re-import required** (`code.js` + `ui.html` changed). [See what's new →](CHANGELOG.md#1340---2026-07-03)
+> **🆕 Figma Slots Support (v1.35.0):** Create, inspect, populate, and reset Figma Slots (GA at Config 2026) programmatically — `figma_create_slot` adds slots to components (variants included), `figma_append_to_slot` populates instance slots with cloned or new content, plus `figma_get_slots`, `figma_reset_slot`, and `figma_add_slot_property`. Live-validated against the GA Plugin API; closes the most-requested issue [#29](https://github.com/southleft/figma-console-mcp/issues/29), based on community PR [#77](https://github.com/southleft/figma-console-mcp/pull/77). **Plugin re-import required** (`code.js` + `ui.html` changed). [See what's new →](CHANGELOG.md#1350---2026-07-09)
 
 ## What is this?
 
@@ -55,9 +55,9 @@ Figma Console MCP connects AI assistants (like Claude) to Figma, enabling:
 | Real-time monitoring (console, selection) | ✅ | ❌ | ❌ |
 | Desktop Bridge plugin | ✅ | ✅ | ❌ |
 | Requires Node.js | Yes | **No** | No |
-| **Total tools available** | **107** | **96** | **9** |
+| **Total tools available** | **112** | **101** | **9** |
 
-> **Bottom line:** Remote SSE is **read-only** with 9 tools. **Cloud Mode** unlocks write access (96 tools) from web AI clients without Node.js. NPX/Local Git gives the full 107 tools with real-time monitoring.
+> **Bottom line:** Remote SSE is **read-only** with 9 tools. **Cloud Mode** unlocks write access (101 tools) from web AI clients without Node.js. NPX/Local Git gives the full 112 tools with real-time monitoring.
 
 ---
 
@@ -65,7 +65,7 @@ Figma Console MCP connects AI assistants (like Claude) to Figma, enabling:
 
 **Best for:** Designers who want full AI-assisted design capabilities.
 
-**What you get:** All 107 tools including design creation, variable management, and component instantiation.
+**What you get:** All 112 tools including design creation, variable management, and component instantiation.
 
 #### Prerequisites
 
@@ -162,7 +162,7 @@ Create a simple frame with a blue background
 
 **Best for:** Developers who want to modify source code or contribute to the project.
 
-**What you get:** Same 107 tools as NPX, plus full source code access.
+**What you get:** Same 112 tools as NPX, plus full source code access.
 
 #### Quick Setup
 
@@ -251,7 +251,7 @@ Ready for design creation? Follow the [NPX Setup](#-npx-setup-recommended) guide
 
 **Best for:** Using Claude.ai, v0, Replit, or Lovable to create and modify Figma designs — no Node.js required.
 
-**What you get:** 96 tools including full write access — design creation, variable management, component instantiation, and all REST API tools. Only real-time monitoring (console logs, selection tracking, document changes) requires Local Mode.
+**What you get:** 101 tools including full write access — design creation, variable management, component instantiation, and all REST API tools. Only real-time monitoring (console logs, selection tracking, document changes) requires Local Mode.
 
 #### Prerequisites
 
@@ -308,7 +308,7 @@ AI Client → Cloud MCP Server → Durable Object Relay → Desktop Bridge Plugi
 | Feature | NPX (Recommended) | Cloud Mode | Local Git | Remote SSE |
 |---------|-------------------|------------|-----------|------------|
 | **Setup time** | ~10 minutes | ~5 minutes | ~15 minutes | ~2 minutes |
-| **Total tools** | **107** | **96** | **107** | **9** (read-only) |
+| **Total tools** | **112** | **101** | **112** | **9** (read-only) |
 | **Design creation** | ✅ | ✅ | ✅ | ❌ |
 | **Variable management** | ✅ | ✅ | ✅ | ❌ |
 | **Component instantiation** | ✅ | ✅ | ✅ | ❌ |
@@ -323,7 +323,7 @@ AI Client → Cloud MCP Server → Durable Object Relay → Desktop Bridge Plugi
 | **Automatic updates** | ✅ (`@latest`) | ✅ | Manual (`git pull`) | ✅ |
 | **Source code access** | ❌ | ❌ | ✅ | ❌ |
 
-> **Key insight:** Remote SSE is read-only. Cloud Mode adds write access for web AI clients without Node.js. NPX/Local Git give the full 107 tools.
+> **Key insight:** Remote SSE is read-only. Cloud Mode adds write access for web AI clients without Node.js. NPX/Local Git give the full 112 tools.
 
 **📖 [Complete Feature Comparison](docs/mode-comparison.md)**
 
@@ -431,6 +431,13 @@ When you first use design system tools:
   - Supports markdown formatting for rich documentation
   - Descriptions appear in Dev Mode for developers
 
+### 🧩 Figma Slots (Local Mode + Cloud Mode)
+- `figma_create_slot` - **Add a slot to a component** via the GA `createSlot()` API — the linked SLOT property is created automatically; works on standalone components and variants inside a component set
+- `figma_get_slots` - List slots on a component, component set (aggregated across variants), or instance — ids, names, property keys, dimensions, and current children
+- `figma_append_to_slot` - **Populate an instance's slot** by cloning an existing node or creating new content (`setProperties` rejects slot values by design — this is the population path)
+- `figma_reset_slot` - Clear a slot's content on an instance
+- `figma_add_slot_property` - Retrofit an existing frame as a slot via a manual SLOT property binding, with `description` and `preferredValues`
+
 ### 🔍 Design-Code Parity (All Modes)
 - `figma_check_design_parity` - Compare Figma component specs against code implementation, producing a scored diff report with actionable fix items
 - `figma_generate_component_doc` - Generate platform-agnostic markdown documentation by merging Figma design data with code-side info
@@ -673,7 +680,7 @@ The **Figma Desktop Bridge** plugin is the recommended way to connect Figma to t
 - The MCP server communicates via **WebSocket** through the Desktop Bridge plugin
 - The server tries port 9223 first, then automatically falls back through ports 9224–9232 if needed
 - The plugin scans all ports in the range and connects to every active server it finds
-- All 107 tools work through the WebSocket transport
+- All 112 tools work through the WebSocket transport
 
 **Multiple files:** The WebSocket server supports multiple simultaneous plugin connections — one per open Figma file. Each connection is tracked by file key with independent state (selection, document changes, console logs).
 
@@ -812,9 +819,10 @@ The architecture supports adding new apps with minimal boilerplate — each app
 
 ## 🛤️ Roadmap
 
-**Current Status:** v1.34.0 (Stable) - Production-ready. Latest: Bidirectional Token Sync v2 + DTCG 2025.10 — `figma_import_tokens` now applies the complete diff plan (creates missing collections/variables, applies renames, writes real `VARIABLE_ALIAS` references, and deletes only under explicit `replace`), `figma_export_tokens` speaks the DTCG 2025.10 dialect on request (legacy default byte-identical), variable scopes/codeSyntax round-trip via `$extensions`, `figma_setup_design_tokens` accepts alias values via DTCG brace references, and the new `figma_create_component_set` builds a full variant set from an axes matrix in one call. On top of the v1.33.x line: version-handshake fix (re-import banner only fires when plugin files actually changed), security dependency sweep, and the v1.33.0 connection UX overhaul (honest status pill derived from live connection state, `/health` auto-discovery with self-healing reconnect) + a 33-fix full-codebase audit (lossless DTCG multi-mode round-trips, cross-collection alias resolution, branch-URL correctness across REST tools, cache-poisoning and CSWSH fixes, bridge-first screenshots). Built on WCAG-accurate accessibility auditing (line height below 1.5× is no longer mis-flagged as a failure; readability hints decoupled from conformance checks and scoped to multi-line text; code-side WCAG 1.4.12 check), a self-healing Desktop Bridge connection (zombie-process reaper + auto-reconnect watchdog — fixes the recurring "not connected until restart" bug), native variable binding on fills/strokes + typography control in the write tools, shared-library inspection (key-based component resolution + library variable read/import without Enterprise plan), 10-format token export pipeline (DTCG, CSS, Tailwind v4, Tailwind v3, SCSS, TS module, JSON flat/nested, Style Dictionary v3, Tokens Studio), bidirectional Figma↔code token sync, version history & time-series awareness, FigJam + Slides support, Cloud Write Relay, Design System Kit, WebSocket-only connectivity, smart multi-file tracking, **107 tools** (Local) / **96 tools** (Cloud) / **9 tools** (Remote read-only), Comments API, cross-MCP identity disambiguation, and MCP Apps.
+**Current Status:** v1.35.0 (Stable) - Production-ready. Latest: Figma Slots write support — create, inspect, populate, and reset Slots (GA at Config 2026) via 5 new tools (`figma_create_slot`, `figma_get_slots`, `figma_append_to_slot`, `figma_reset_slot`, `figma_add_slot_property`), live-validated against the GA Plugin API and based on community PR #77. On top of v1.34.0's Bidirectional Token Sync v2 + DTCG 2025.10 — `figma_import_tokens` applies the complete diff plan (creates missing collections/variables, applies renames, writes real `VARIABLE_ALIAS` references, and deletes only under explicit `replace`), `figma_export_tokens` speaks the DTCG 2025.10 dialect on request (legacy default byte-identical), variable scopes/codeSyntax round-trip via `$extensions`, `figma_setup_design_tokens` accepts alias values via DTCG brace references, and `figma_create_component_set` builds a full variant set from an axes matrix in one call. On top of the v1.33.x line: version-handshake fix (re-import banner only fires when plugin files actually changed), security dependency sweep, and the v1.33.0 connection UX overhaul (honest status pill derived from live connection state, `/health` auto-discovery with self-healing reconnect) + a 33-fix full-codebase audit (lossless DTCG multi-mode round-trips, cross-collection alias resolution, branch-URL correctness across REST tools, cache-poisoning and CSWSH fixes, bridge-first screenshots). Built on WCAG-accurate accessibility auditing (line height below 1.5× is no longer mis-flagged as a failure; readability hints decoupled from conformance checks and scoped to multi-line text; code-side WCAG 1.4.12 check), a self-healing Desktop Bridge connection (zombie-process reaper + auto-reconnect watchdog — fixes the recurring "not connected until restart" bug), native variable binding on fills/strokes + typography control in the write tools, shared-library inspection (key-based component resolution + library variable read/import without Enterprise plan), 10-format token export pipeline (DTCG, CSS, Tailwind v4, Tailwind v3, SCSS, TS module, JSON flat/nested, Style Dictionary v3, Tokens Studio), bidirectional Figma↔code token sync, version history & time-series awareness, FigJam + Slides support, Cloud Write Relay, Design System Kit, WebSocket-only connectivity, smart multi-file tracking, **112 tools** (Local) / **101 tools** (Cloud) / **9 tools** (Remote read-only), Comments API, cross-MCP identity disambiguation, and MCP Apps.
 
 **Recent Releases:**
+- [x] **v1.35.0** - Figma Slots write support, closing [#29](https://github.com/southleft/figma-console-mcp/issues/29) (the tracker's most-requested feature) via community PR [#77](https://github.com/southleft/figma-console-mcp/pull/77) by @simonesalvucci, updated to the GA API. Five new tools: `figma_create_slot` (slot + auto-linked SLOT property; variants inside component sets supported — the beta restriction was lifted at GA), `figma_get_slots`, `figma_append_to_slot` (clone or create content into instance slots; snaps clones to the slot origin), `figma_reset_slot`, and `figma_add_slot_property` (retrofit an existing frame as a slot). Hardened by live validation: VARIANT `defaultValue` passthrough restored (Figma requires non-empty), destructive-path reorder in the append handler (content validated before `clearExisting` empties anything), relay whitelist fix for `slot` payloads. **Plugin re-import required** (`code.js` + `ui.html` changed).
 - [x] **v1.34.0** - Bidirectional Token Sync v2 + DTCG 2025.10. `figma_import_tokens` now applies the *complete* diff plan: missing collections and variables are created (with modes, inferred/recorded types, and values set in dependency order — aliases in a second pass), token-path renames route to the update phase by round-trip variable ID (no more create+delete pairs that would permanently destroy the original under `replace`), reference values write real `{ type: "VARIABLE_ALIAS", id }` payloads via a four-tier resolver, and deletes are strictly gated behind `strategy: "replace"`. `figma_export_tokens` gains `dtcgDialect: "2025"` (object-form colors from full-precision floats, object dimensions) while the legacy default stays byte-identical; import accepts both dialects unconditionally with dialect-insensitive diff normalization. Variable `scopes` + `codeSyntax` round-trip through `$extensions["figma-console-mcp"]`. `figma_setup_design_tokens` accepts DTCG brace references (`"{color.blue.600}"`) that resolve to real aliases, including forward references. New tool `figma_create_component_set` builds a variant set from an axes matrix (or combines existing components) with `Prop=Value` naming, optional auto-arranged grid, and variant keys in the response — with count-scaled timeouts and rollback on failure. **Plugin re-import required** (`code.js` + `ui.html` changed — the component-set handler and relay). 183 tests across the token/write-tools suites.
 - [x] **v1.33.2** - Version-handshake false-positive fix. The v1.33.0 handshake compared the plugin's reported version against the server's *package* version, so server-only releases (like the v1.33.1 dependency sweep) flagged every up-to-date plugin as stale and pushed the re-import banner for files that hadn't changed. The server now compares against the `PLUGIN_VERSION` embedded in the `figma-desktop-bridge/code.js` it ships — exactly what a re-import would install — and `PLUGIN_VERSION` itself now means "last release in which plugin files changed" (release tooling bumps it only when `figma-desktop-bridge/` actually changed since the last tag). `figma_get_status` gains `transport.websocket.bundledPluginVersion`; `figma_diagnose` blames the right version. No new tools, **no plugin re-import required** (one-time exception: if you re-imported at v1.33.1, the banner appears once more — clear it with one final re-import). 1245 tests passing (9 new).
 - [x] **v1.33.1** - Security dependency sweep. All runtime and critical npm audit alerts resolved via in-range bumps (`ws` 8.21.0, `hono` 4.12.27, `undici` 7.28.0, `handlebars` 4.7.9 — the lone critical, dev-only — plus `lodash`, `path-to-regexp`, `basic-ftp`, `fast-uri`, `vite`). `wrangler` deliberately held at 4.72.0 because newer versions require Node ≥22; the only residual audit findings are inside wrangler/miniflare's dev-time toolchain, which never ships in the npm package or Worker bundle. Supersedes dependabot PRs #81/#82/#84. No code changes, no API changes, no plugin re-import. 1236 tests passing unchanged.

package/dist/cloudflare/core/cloud-websocket-connector.js

@@ -154,6 +154,8 @@ export class CloudWebSocketConnector {
         const params = { nodeId, propertyName, propertyType: type, defaultValue };
         if (options?.preferredValues)
             params.preferredValues = options.preferredValues;
+        if (options?.description)
+            params.description = options.description;
         return this.sendCommand('ADD_COMPONENT_PROPERTY', params);
     }
     async editComponentProperty(nodeId, propertyName, newValue) {
@@ -199,6 +201,21 @@ export class CloudWebSocketConnector {
         return this.sendCommand('CREATE_COMPONENT_SET', params, timeout);
     }
     // ============================================================================
+    // Slot operations
+    // ============================================================================
+    async createSlot(nodeId, options) {
+        return this.sendCommand('CREATE_SLOT', { nodeId, ...options });
+    }
+    async getSlots(nodeId) {
+        return this.sendCommand('GET_SLOTS', { nodeId });
+    }
+    async appendToSlot(params) {
+        return this.sendCommand('APPEND_TO_SLOT', params);
+    }
+    async resetSlot(params) {
+        return this.sendCommand('RESET_SLOT', params);
+    }
+    // ============================================================================
     // Node manipulation
     // ============================================================================
     async resizeNode(nodeId, width, height, withConstraints = true) {

package/dist/cloudflare/core/figma-tools.js

@@ -3229,7 +3229,7 @@ export function registerFigmaAPITools(server, getFigmaAPI, getCurrentUrl, variab
     // Tool 16: Set Instance Properties (Desktop Bridge)
     // Updates component properties on an instance using setProperties()
     // This is the correct way to update TEXT/BOOLEAN/VARIANT properties on component instances
-    server.tool("figma_set_instance_properties", "Update component properties on a component instance. IMPORTANT: Use this tool instead of trying to edit text nodes directly when working with component instances. Components often expose TEXT, BOOLEAN, INSTANCE_SWAP, and VARIANT properties that control their content. Direct text node editing may fail silently if the component uses properties. This tool handles the #nodeId suffix pattern automatically. Requires Desktop Bridge connection.", {
+    server.tool("figma_set_instance_properties", "Update component properties on a component instance. IMPORTANT: Use this tool instead of trying to edit text nodes directly when working with component instances. Components often expose TEXT, BOOLEAN, INSTANCE_SWAP, and VARIANT properties that control their content. SLOT properties CANNOT be set here — use figma_append_to_slot to populate slot content. Direct text node editing may fail silently if the component uses properties. This tool handles the #nodeId suffix pattern automatically. Requires Desktop Bridge connection.", {
         nodeId: z
             .string()
             .describe("ID of the INSTANCE node to update (e.g., '1:234'). Must be a component instance, not a regular frame."),

package/dist/cloudflare/core/slot-tools.js

@@ -0,0 +1,334 @@
+import { z } from "zod";
+import { createChildLogger } from "./logger.js";
+const logger = createChildLogger({ component: "slot-tools" });
+const SLOT_LAYOUT_MODES = ["NONE", "HORIZONTAL", "VERTICAL"];
+const SLOT_CHILD_NODE_TYPES = [
+    "FRAME",
+    "RECTANGLE",
+    "ELLIPSE",
+    "TEXT",
+    "LINE",
+    "POLYGON",
+    "STAR",
+    "VECTOR",
+];
+const preferredValueSchema = z.object({
+    type: z.enum(["COMPONENT", "COMPONENT_SET"]).describe("Type of preferred value"),
+    key: z.string().describe("Component or component set key"),
+});
+/**
+ * Register MCP tools for Figma Slots (open beta).
+ * Requires Desktop Bridge and a Figma Desktop version with SlotNode API support.
+ */
+export function registerSlotTools(server, getDesktopConnector) {
+    server.tool("figma_create_slot", `Create a SlotNode inside a component using createSlot(). Automatically creates a linked SLOT component property named after the slot (renaming the slot renames the property). Slots are freeform drop zones for instance content — more flexible than INSTANCE_SWAP. Works on standalone COMPONENTs and variant COMPONENTs inside a COMPONENT_SET (call once per variant). GRID layout is not allowed on slots. Requires Desktop Bridge.`, {
+        nodeId: z
+            .string()
+            .describe("The COMPONENT node ID to add a slot to"),
+        name: z
+            .string()
+            .optional()
+            .describe("Slot layer name (e.g. 'Content', 'Footer')"),
+        width: z
+            .number()
+            .optional()
+            .describe("Initial slot width in pixels"),
+        height: z
+            .number()
+            .optional()
+            .describe("Initial slot height in pixels"),
+        layoutMode: z
+            .enum(SLOT_LAYOUT_MODES)
+            .optional()
+            .describe("Auto-layout mode for the slot (GRID is not supported)"),
+    }, async ({ nodeId, name, width, height, layoutMode }) => {
+        try {
+            const connector = await getDesktopConnector();
+            const result = await connector.createSlot(nodeId, {
+                name,
+                width,
+                height,
+                layoutMode,
+            });
+            if (!result.success) {
+                throw new Error(result.error || "Failed to create slot");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            slot: result.slot,
+                            hint: "Use figma_get_slots to inspect slots. Populate instance slots with figma_append_to_slot (not figma_set_instance_properties).",
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_create_slot failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            hint: "Target a COMPONENT node (standalone or a variant inside a COMPONENT_SET). Ensure Figma Desktop supports Slots.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("figma_get_slots", `List SlotNode children on a component, component set, or instance. Returns slot IDs, names, property keys, dimensions, and current child nodes. Use on instances before figma_append_to_slot to discover slot names/IDs.`, {
+        nodeId: z
+            .string()
+            .describe("COMPONENT, COMPONENT_SET, or INSTANCE node ID"),
+    }, async ({ nodeId }) => {
+        try {
+            const connector = await getDesktopConnector();
+            const result = await connector.getSlots(nodeId);
+            if (!result.success) {
+                throw new Error(result.error || "Failed to get slots");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, ...(result.data ?? {}) }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_get_slots failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            hint: "Ensure the node is a component or instance with slots, and Desktop Bridge is connected.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("figma_append_to_slot", `Add content to a slot on a component instance. Clones sourceNodeId into the slot, or creates a new node (nodeType). SLOT content cannot be set via figma_set_instance_properties — use this tool instead. Widgets, stickies, and raw ComponentNodes cannot be appended to slots.`, {
+        slotId: z
+            .string()
+            .optional()
+            .describe("Direct SlotNode ID (from figma_get_slots)"),
+        instanceId: z
+            .string()
+            .optional()
+            .describe("Instance ID — use with slotName when slotId is unknown"),
+        slotName: z
+            .string()
+            .optional()
+            .describe("Slot layer name on the instance (e.g. 'Content')"),
+        sourceNodeId: z
+            .string()
+            .optional()
+            .describe("Node to clone into the slot (default: clone=true)"),
+        nodeType: z
+            .enum(SLOT_CHILD_NODE_TYPES)
+            .optional()
+            .describe("Create a new node in the slot instead of cloning"),
+        properties: z
+            .record(z.string(), z.union([z.string(), z.number()]))
+            .optional()
+            .describe("Properties for created nodes: name, text, width, height"),
+        clone: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("When using sourceNodeId, clone the node (default true). Set false to move."),
+        clearExisting: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Remove existing slot children before appending"),
+    }, async (args) => {
+        try {
+            if (!args.slotId && !(args.instanceId && args.slotName)) {
+                throw new Error("Provide slotId OR (instanceId + slotName)");
+            }
+            if (!args.sourceNodeId && !args.nodeType) {
+                throw new Error("Provide sourceNodeId (clone into slot) or nodeType (create new content)");
+            }
+            const connector = await getDesktopConnector();
+            const result = await connector.appendToSlot(args);
+            if (!result.success) {
+                throw new Error(result.error || "Failed to append to slot");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            slot: result.slot,
+                            appendedNode: result.appendedNode,
+                            hint: "Use figma_capture_screenshot to verify slot content visually.",
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_append_to_slot failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            hints: [
+                                "Use figma_get_slots on the instance to find slot IDs/names",
+                                "Clone instances or frames — not raw ComponentNodes",
+                                "SLOT properties cannot be set via figma_set_instance_properties",
+                            ],
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("figma_reset_slot", `Reset a slot on a component instance to its default (empty) state from the main component. Uses SlotNode.resetSlot().`, {
+        slotId: z
+            .string()
+            .optional()
+            .describe("Direct SlotNode ID"),
+        instanceId: z
+            .string()
+            .optional()
+            .describe("Instance ID — use with slotName when slotId is unknown"),
+        slotName: z
+            .string()
+            .optional()
+            .describe("Slot layer name on the instance"),
+    }, async ({ slotId, instanceId, slotName }) => {
+        try {
+            if (!slotId && !(instanceId && slotName)) {
+                throw new Error("Provide slotId OR (instanceId + slotName)");
+            }
+            const connector = await getDesktopConnector();
+            const result = await connector.resetSlot({ slotId, instanceId, slotName });
+            if (!result.success) {
+                throw new Error(result.error || "Failed to reset slot");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            slot: result.slot,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_reset_slot failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("figma_add_slot_property", `Manually add a SLOT component property and bind it to an existing frame (alternative to figma_create_slot). The frame must be a direct child of the component, must not use GRID layout, and must not be nested inside another slot. Supports description and preferredValues.`, {
+        nodeId: z.string().describe("COMPONENT or COMPONENT_SET node ID"),
+        propertyName: z.string().describe("Slot property name (e.g. 'Content')"),
+        frameNodeId: z
+            .string()
+            .describe("Frame node ID to bind as the slot content area"),
+        description: z
+            .string()
+            .optional()
+            .describe("Slot property description (SLOT-only)"),
+        preferredValues: z
+            .array(preferredValueSchema)
+            .optional()
+            .describe("Preferred components for slot content (SLOT-only)"),
+    }, async ({ nodeId, propertyName, frameNodeId, description, preferredValues }) => {
+        try {
+            const connector = await getDesktopConnector();
+            const code = `
+const component = await figma.getNodeByIdAsync(${JSON.stringify(nodeId)});
+if (!component || (component.type !== 'COMPONENT' && component.type !== 'COMPONENT_SET')) {
+  throw new Error('Node must be COMPONENT or COMPONENT_SET');
+}
+const frame = await figma.getNodeByIdAsync(${JSON.stringify(frameNodeId)});
+if (!frame || frame.type !== 'FRAME') {
+  throw new Error('frameNodeId must be a FRAME node');
+}
+// For a COMPONENT the frame must be its direct child. For a COMPONENT_SET the
+// property lives on the set but the frame lives inside a variant COMPONENT —
+// accept a frame whose parent is a variant of this set.
+const directChild = frame.parent === component;
+const variantChild = component.type === 'COMPONENT_SET' &&
+  frame.parent && frame.parent.type === 'COMPONENT' && frame.parent.parent === component;
+if (!directChild && !variantChild) {
+  throw new Error(component.type === 'COMPONENT_SET'
+    ? 'Frame must be a direct child of one of the set\\'s variant components'
+    : 'Frame must be a direct child of the component');
+}
+if (frame.layoutMode === 'GRID') {
+  throw new Error('GRID layoutMode is not allowed on slot frames');
+}
+const options = {};
+${description ? `options.description = ${JSON.stringify(description)};` : ""}
+${preferredValues ? `options.preferredValues = ${JSON.stringify(preferredValues)};` : ""}
+const propKey = component.addComponentProperty(${JSON.stringify(propertyName)}, 'SLOT', '', Object.keys(options).length ? options : undefined);
+// Merge — assigning a fresh object would wipe the frame's existing bindings
+// (e.g. a BOOLEAN property driving 'visible').
+frame.componentPropertyReferences = Object.assign({}, frame.componentPropertyReferences, { slotContentId: propKey });
+return { propertyKey: propKey, frameId: frame.id, frameName: frame.name };
+`;
+            const result = await connector.executeCodeViaUI(code, 10000);
+            if (!result.success) {
+                throw new Error(result.error || "Failed to add slot property");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            result: result.result,
+                            hint: "Prefer figma_create_slot() for new slots — it creates the SlotNode and property automatically.",
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_add_slot_property failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/cloudflare/core/tokens-tools.js

@@ -35,7 +35,7 @@ const logger = createChildLogger({ component: "tokens-tools" });
  * on every exported token document. Kept in sync with package.json by
  * scripts/release.sh — see step 3 of the release flow.
  */
-const MCP_VERSION = "1.34.0";
+const MCP_VERSION = "1.35.0";
 const EXPORT_TOOL_DESCRIPTION = `Export Figma variables to design token files in your codebase. Bidirectional with figma_import_tokens — together they replace Style Dictionary and Tokens Studio's export pipeline for the popular styling methods.
 
 FULLY-IMPLEMENTED OUTPUT FORMATS:

package/dist/cloudflare/core/websocket-connector.js

@@ -196,6 +196,8 @@ export class WebSocketConnector {
         const params = { nodeId, propertyName, propertyType: type, defaultValue };
         if (options?.preferredValues)
             params.preferredValues = options.preferredValues;
+        if (options?.description)
+            params.description = options.description;
         return this.wsServer.sendCommand('ADD_COMPONENT_PROPERTY', params);
     }
     async editComponentProperty(nodeId, propertyName, newValue) {
@@ -231,6 +233,21 @@ export class WebSocketConnector {
         return this.wsServer.sendCommand('CREATE_COMPONENT_SET', params, componentSetTimeoutMs(params));
     }
     // ============================================================================
+    // Slot operations
+    // ============================================================================
+    async createSlot(nodeId, options) {
+        return this.wsServer.sendCommand('CREATE_SLOT', { nodeId, ...options });
+    }
+    async getSlots(nodeId) {
+        return this.wsServer.sendCommand('GET_SLOTS', { nodeId });
+    }
+    async appendToSlot(params) {
+        return this.wsServer.sendCommand('APPEND_TO_SLOT', params);
+    }
+    async resetSlot(params) {
+        return this.wsServer.sendCommand('RESET_SLOT', params);
+    }
+    // ============================================================================
     // Node manipulation
     // ============================================================================
     async resizeNode(nodeId, width, height, withConstraints = true) {

package/dist/cloudflare/core/write-tools.js

@@ -1076,21 +1076,52 @@ After instantiating components, use figma_take_screenshot to verify the result l
         }
     });
     // Tool: Add Component Property
-    server.tool("figma_add_component_property", "Add a new component property to a component or component set. Properties enable dynamic content and behavior in component instances. Supported types: BOOLEAN (toggle), TEXT (string), INSTANCE_SWAP (component swap), VARIANT (variant selection).", {
+    server.tool("figma_add_component_property", "Add a new component property to a component or component set. Properties enable dynamic content and behavior in component instances. Supported types: BOOLEAN (toggle), TEXT (string), INSTANCE_SWAP (component swap), VARIANT (variant selection), SLOT (freeform slot — prefer figma_create_slot for new slots).", {
         nodeId: z.string().describe("The component or component set node ID"),
         propertyName: z
             .string()
-            .describe("Name for the new property (e.g., 'Show Icon', 'Button Label')"),
+            .describe("Name for the new property (e.g., 'Show Icon', 'Button Label', 'Content')"),
         type: z
-            .enum(["BOOLEAN", "TEXT", "INSTANCE_SWAP", "VARIANT"])
-            .describe("Property type: BOOLEAN for toggles, TEXT for strings, INSTANCE_SWAP for component swaps, VARIANT for variant selection"),
+            .enum(["BOOLEAN", "TEXT", "INSTANCE_SWAP", "VARIANT", "SLOT"])
+            .describe("Property type: BOOLEAN for toggles, TEXT for strings, INSTANCE_SWAP for component swaps, VARIANT for variant selection, SLOT for freeform slot areas"),
         defaultValue: z
             .union([z.string(), z.number(), z.boolean()])
-            .describe("Default value for the property. BOOLEAN: true/false, TEXT: string, INSTANCE_SWAP: component key, VARIANT: variant value"),
-    }, async ({ nodeId, propertyName, type, defaultValue }) => {
+            .optional()
+            .describe("Default value. Required for TEXT (string), INSTANCE_SWAP (component id), and VARIANT (a non-empty variant option name — Figma rejects empty). Optional for BOOLEAN (defaults false). Omit for SLOT."),
+        description: z
+            .string()
+            .optional()
+            .describe("Property description (SLOT properties only)"),
+        preferredValues: z
+            .array(z.object({
+            type: z.enum(["COMPONENT", "COMPONENT_SET"]),
+            key: z.string(),
+        }))
+            .optional()
+            .describe("Preferred components (INSTANCE_SWAP and SLOT only)"),
+    }, async ({ nodeId, propertyName, type, defaultValue, description, preferredValues }) => {
         try {
             const connector = await getDesktopConnector();
-            const result = await connector.addComponentProperty(nodeId, propertyName, type, defaultValue);
+            const options = {};
+            if (description)
+                options.description = description;
+            if (preferredValues)
+                options.preferredValues = preferredValues;
+            // SLOT is the only type that takes no default. VARIANT requires a
+            // non-empty default (Figma rejects ''), and TEXT/INSTANCE_SWAP fail
+            // deep in the plugin with opaque errors when the default is missing —
+            // validate here so the caller gets an actionable message.
+            if ((type === "TEXT" || type === "INSTANCE_SWAP" || type === "VARIANT") &&
+                (defaultValue === undefined || defaultValue === "")) {
+                throw new Error(`defaultValue is required for ${type} properties` +
+                    (type === "INSTANCE_SWAP"
+                        ? " (a component id)"
+                        : type === "VARIANT"
+                            ? " (a non-empty variant option name)"
+                            : ""));
+            }
+            const resolvedDefault = type === "SLOT" ? "" : (defaultValue ?? (type === "BOOLEAN" ? false : ""));
+            const result = await connector.addComponentProperty(nodeId, propertyName, type, resolvedDefault, Object.keys(options).length > 0 ? options : undefined);
             if (!result.success) {
                 throw new Error(result.error || "Failed to add property");
             }
@@ -1184,7 +1215,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
         }
     });
     // Tool: Delete Component Property
-    server.tool("figma_delete_component_property", "Delete a component property. Only works with BOOLEAN, TEXT, and INSTANCE_SWAP properties (not VARIANT). This is a destructive operation.", {
+    server.tool("figma_delete_component_property", "Delete a component property. Works with BOOLEAN, TEXT, INSTANCE_SWAP, and SLOT properties (not VARIANT). This is a destructive operation.", {
         nodeId: z.string().describe("The component or component set node ID"),
         propertyName: z
             .string()
@@ -1216,7 +1247,7 @@ After instantiating components, use figma_take_screenshot to verify the result l
                         type: "text",
                         text: JSON.stringify({
                             error: error instanceof Error ? error.message : String(error),
-                            hint: "Cannot delete VARIANT properties. Only BOOLEAN, TEXT, and INSTANCE_SWAP can be deleted.",
+                            hint: "Cannot delete VARIANT properties. BOOLEAN, TEXT, INSTANCE_SWAP, and SLOT can be deleted.",
                         }),
                     },
                 ],