@autobest-ui/agent 1.0.0 → 1.0.1

package/mcp/figma-mcp-bridge/src/tools/index.js

@@ -0,0 +1,1727 @@
+/**
+ * Tool registry - registers all Figma tools with the MCP server
+ */
+
+import { z } from 'zod';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { handleGetContext } from './context.js';
+import { handleListPages } from './pages.js';
+import { handleGetNodes } from './nodes.js';
+import {
+  handleSetFills,
+  handleSetStrokes,
+  handleCreateRectangle,
+  handleSetText,
+  handleCloneNodes,
+  handleDeleteNodes,
+  handleMoveNodes,
+  handleResizeNodes,
+  handleSetOpacity,
+  handleSetCornerRadius,
+  handleGroupNodes,
+  handleUngroupNodes,
+  handleCreateFrame,
+  handleCreateText,
+  handleSetSelection,
+  handleSetCurrentPage,
+  handleExportNode,
+  // Phase 2 commands
+  handleCreateEllipse,
+  handleSetEffects,
+  handleSetAutoLayout,
+  handleGetLocalStyles,
+  handleApplyStyle,
+  handleCreateComponent,
+  handleCreateInstance,
+  // Phase 3 commands
+  handleGetLocalVariables,
+  handleSearchVariables,
+  handleSetVariable,
+  handleCreateLine,
+  handleSetConstraints,
+  // Phase 4 commands
+  handleCreatePolygon,
+  handleBooleanOperation,
+  handleZoomToNode,
+  handleSetBlendMode,
+  handleDetachInstance,
+  // Phase 5 commands
+  handleSetLayoutAlign,
+  handleCreateVector,
+  handleRenameNode,
+  handleReorderNode,
+  // Smart Query commands
+  handleSearchNodes,
+  handleSearchComponents,
+  handleSearchStyles,
+  handleGetChildren,
+  // Design System Creation commands
+  handleSetTextStyle,
+  handleCreatePaintStyle,
+  handleCreateTextStyle,
+  handleCreateVariableCollection,
+  handleCreateVariable,
+  handleRenameVariable,
+  handleDeleteVariables,
+  handleDeleteVariableCollection,
+  handleRenameVariableCollection,
+  handleRenameMode,
+  handleAddMode,
+  handleDeleteMode,
+  handleUnbindVariable,
+  // Page Management commands
+  handleCreatePage,
+  handleRenamePage,
+  handleDeletePage,
+  handleReorderPage,
+  // Node Structure commands
+  handleReparentNodes,
+  handleMoveToPage,
+  // Instance commands
+  handleSwapInstance,
+  // Additional commands
+  handleDuplicatePage,
+  handleSetRotation,
+  handleSetLayoutGrids,
+  handleCombineAsVariants,
+  // FigJam commands
+  handleCreateSticky,
+  handleSetSticky,
+  handleCreateShapeWithText,
+  handleSetShapeType,
+  handleCreateConnector,
+  handleSetConnector,
+  handleCreateSection,
+  handleSetSection,
+  handleCreateTable,
+  handleSetTableCell,
+  handleInsertTableRow,
+  handleInsertTableColumn,
+  handleRemoveTableRow,
+  handleRemoveTableColumn,
+  handleResizeTableRow,
+  handleResizeTableColumn,
+  handleMoveTableRow,
+  handleMoveTableColumn,
+  handleCreateCodeBlock,
+  handleSetCodeBlock,
+  handleCreateLinkPreview,
+  // Prototype commands
+  handleGetReactions,
+  handleAddReaction,
+  handleRemoveReaction,
+  handleSetFlowStartingPoint,
+  // Visibility / clipping / style deletion / variable modes / size limits
+  handleSetVisible,
+  handleSetClipsContent,
+  handleDeleteStyle,
+  handleSetVariableMode,
+  handleSetSizeLimits
+} from './mutations.js';
+
+// Read package.json once at module load — used by figma_server_info to surface the running version
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let pkgVersion = 'unknown';
+try {
+  const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8'));
+  pkgVersion = pkg.version;
+} catch (_) {
+  // package.json not found — fall back to 'unknown'
+}
+
+// Color schema for fill/stroke shorthand
+const colorSchema = z.union([
+  z.object({
+    color: z.string().describe('Hex color (e.g., "#FF0000" or "#FF0000FF" with alpha)')
+  }),
+  z.object({
+    r: z.number().min(0).max(1).describe('Red (0-1)'),
+    g: z.number().min(0).max(1).describe('Green (0-1)'),
+    b: z.number().min(0).max(1).describe('Blue (0-1)'),
+    a: z.number().min(0).max(1).optional().describe('Alpha (0-1, optional)')
+  }),
+  z.array(z.any()).describe('Full Figma fills array')
+]);
+
+// ============================================================
+// FigJam shared enums
+// ============================================================
+
+const SHAPE_TYPES = [
+  'SQUARE', 'ELLIPSE', 'ROUNDED_RECTANGLE', 'DIAMOND',
+  'TRIANGLE_UP', 'TRIANGLE_DOWN',
+  'PARALLELOGRAM_RIGHT', 'PARALLELOGRAM_LEFT',
+  'ENG_DATABASE', 'ENG_QUEUE', 'ENG_FILE', 'ENG_FOLDER',
+  'TRAPEZOID', 'PREDEFINED_PROCESS', 'SHIELD',
+  'DOCUMENT_SINGLE', 'DOCUMENT_MULTIPLE', 'MANUAL_INPUT',
+  'HEXAGON', 'CHEVRON', 'PENTAGON', 'OCTAGON', 'STAR', 'PLUS',
+  'ARROW_LEFT', 'ARROW_RIGHT',
+  'SUMMING_JUNCTION', 'OR',
+  'SPEECH_BUBBLE', 'INTERNAL_STORAGE'
+];
+
+const CONNECTOR_LINE_TYPES = ['ELBOWED', 'STRAIGHT', 'CURVED'];
+const CONNECTOR_STROKE_CAPS = [
+  'NONE', 'ARROW_EQUILATERAL', 'ARROW_LINES',
+  'TRIANGLE_FILLED', 'CIRCLE_FILLED', 'DIAMOND_FILLED'
+];
+const MAGNETS = ['NONE', 'AUTO', 'TOP', 'LEFT', 'BOTTOM', 'RIGHT', 'CENTER'];
+const CODE_LANGUAGES = [
+  'TYPESCRIPT', 'CPP', 'RUBY', 'CSS', 'JAVASCRIPT', 'HTML',
+  'JSON', 'GRAPHQL', 'PYTHON', 'GO', 'SQL', 'SWIFT',
+  'KOTLIN', 'RUST', 'BASH', 'PLAINTEXT', 'DART'
+];
+
+// Endpoint spec for figma_create_connector / figma_set_connector.
+// One of: { nodeId, magnet }, { nodeId, position }, { position }.
+const connectorEndpointSchema = z.object({
+  nodeId: z.string().optional().describe('ID of the node this endpoint attaches to. Omit for a free-floating endpoint.'),
+  magnet: z.enum(MAGNETS).optional().describe('Where on the target node the connector attaches. AUTO is recommended; STRAIGHT lines only support CENTER or NONE.'),
+  position: z.object({
+    x: z.number(),
+    y: z.number()
+  }).optional().describe('Fixed position. Relative to the target node when nodeId is set; absolute canvas coordinates otherwise.')
+});
+
+/**
+ * Register all tools with the MCP server
+ * @param {McpServer} server - MCP Server instance
+ * @param {FigmaBridge} bridge - Figma bridge instance
+ */
+export function registerTools(server, bridge) {
+  // ============================================================
+  // Server Info
+  // ============================================================
+
+  // figma_server_info - Get MCP server info including port and version
+  server.tool(
+    'figma_server_info',
+    'Get information about the MCP server: package version, WebSocket port, connection state, and connected document info.',
+    {},
+    async () => ({
+      content: [{
+        type: 'text',
+        text: JSON.stringify({
+          version: pkgVersion,
+          port: bridge.port,
+          connected: bridge.isConnected(),
+          documentInfo: bridge.getDocumentInfo()
+        }, null, 2)
+      }]
+    })
+  );
+
+  // ============================================================
+  // Query Tools
+  // ============================================================
+
+  // figma_get_context - Get current document context
+  server.tool(
+    'figma_get_context',
+    'Get the current Figma document context including file info, current page, and selection. Use this to understand what document is open and what the user has selected.',
+    {},
+    async () => handleGetContext(bridge)
+  );
+
+  // figma_list_pages - List all pages
+  server.tool(
+    'figma_list_pages',
+    'List all pages in the current Figma document. Returns page IDs, names, and indicates which page is currently active.',
+    {},
+    async () => handleListPages(bridge)
+  );
+
+  // figma_get_nodes - Get node details by ID
+  server.tool(
+    'figma_get_nodes',
+    'Get detailed information about specific Figma nodes by their IDs. Returns node properties including type, position, size, fills, strokes (strokeWeight reads "MIXED" plus the four per-side weights when sides differ), auto-layout (including layoutWrap and counterAxisSpacing), clipsContent, node-level boundVariables (which properties are bound to which variables), explicitVariableModes (variable modes pinned on the node), and more. Composite instance-sublayer IDs (the "I<instanceId>;<childId>" form) resolve reliably — if the direct lookup misses, the instance root is resolved and its subtree searched. IDs that genuinely do not exist come back in notFound with an explanation in notFoundDetails. TIP: Use figma_search_nodes or figma_get_children FIRST to find node IDs efficiently, then use this tool only for nodes you need full details on.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of Figma node IDs (e.g., ["1:23", "4:56"])'),
+      depth: z.enum(['minimal', 'compact', 'full']).optional().default('full').describe('Detail level: "minimal" (~5 props: id, name, type, childIds), "compact" (~10 props: + x/y/width/height + childIds), "full" (all ~40 props). Use minimal/compact for tree traversal to reduce tokens.')
+    },
+    async (args) => handleGetNodes(bridge, args)
+  );
+
+  // ============================================================
+  // Mutation Tools
+  // ============================================================
+
+  // figma_set_fills - Set fill colors on a node
+  server.tool(
+    'figma_set_fills',
+    'Set fill color. Accepts hex shorthand or fills array.',
+    {
+      nodeId: z.string().describe('The node ID to modify'),
+      fills: colorSchema.describe('Fill color - use { color: "#RRGGBB" } for simple colors')
+    },
+    async (args) => handleSetFills(bridge, args)
+  );
+
+  // figma_set_strokes - Set stroke colors and weights on a node
+  server.tool(
+    'figma_set_strokes',
+    'Set stroke color and/or weight. Accepts hex shorthand or strokes array. Supports per-side weights (strokeTopWeight etc.) for border-top-only style dividers — no need to fake them with 1px rectangles. Omit `strokes` to change weights only.',
+    {
+      nodeId: z.string().describe('The node ID to modify'),
+      strokes: colorSchema.optional().describe('Stroke color - use { color: "#RRGGBB" } for simple colors. Omit to leave existing stroke colors untouched.'),
+      strokeWeight: z.number().optional().describe('Uniform stroke weight in pixels (applied before any per-side weights)'),
+      strokeTopWeight: z.number().optional().describe('Top stroke weight in pixels. RECTANGLE / FRAME / COMPONENT / COMPONENT_SET / INSTANCE / SLOT / SLIDE only — errors on other types.'),
+      strokeRightWeight: z.number().optional().describe('Right stroke weight in pixels (same node-type restriction as strokeTopWeight)'),
+      strokeBottomWeight: z.number().optional().describe('Bottom stroke weight in pixels (same node-type restriction as strokeTopWeight)'),
+      strokeLeftWeight: z.number().optional().describe('Left stroke weight in pixels (same node-type restriction as strokeTopWeight)')
+    },
+    async (args) => handleSetStrokes(bridge, args)
+  );
+
+  // figma_create_rectangle - Create a new rectangle
+  server.tool(
+    'figma_create_rectangle',
+    'Create a rectangle.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(100).describe('Width in pixels'),
+      height: z.number().optional().default(100).describe('Height in pixels'),
+      name: z.string().optional().default('Rectangle').describe('Node name'),
+      fills: colorSchema.optional().describe('Fill color'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateRectangle(bridge, args)
+  );
+
+  // figma_set_text - Set text content on a text node
+  server.tool(
+    'figma_set_text',
+    'Set text content. Auto-loads fonts.',
+    {
+      nodeId: z.string().describe('The text node ID to modify'),
+      text: z.string().describe('The new text content')
+    },
+    async (args) => handleSetText(bridge, args)
+  );
+
+  // figma_clone_nodes - Clone/duplicate nodes
+  server.tool(
+    'figma_clone_nodes',
+    'Duplicate nodes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to clone'),
+      parentId: z.string().optional().describe('Parent node ID for clones (optional)'),
+      offset: z.object({
+        x: z.number().optional().default(20).describe('X offset from original'),
+        y: z.number().optional().default(20).describe('Y offset from original')
+      }).optional().describe('Position offset for cloned nodes')
+    },
+    async (args) => handleCloneNodes(bridge, args)
+  );
+
+  // ============================================================
+  // Node Manipulation Tools
+  // ============================================================
+
+  // figma_delete_nodes - Delete nodes
+  server.tool(
+    'figma_delete_nodes',
+    'Delete nodes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to delete')
+    },
+    async (args) => handleDeleteNodes(bridge, args)
+  );
+
+  // figma_move_nodes - Move nodes
+  server.tool(
+    'figma_move_nodes',
+    'Move nodes. Use relative=true for offset.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to move'),
+      x: z.number().optional().describe('X position (absolute) or offset (if relative=true)'),
+      y: z.number().optional().describe('Y position (absolute) or offset (if relative=true)'),
+      relative: z.boolean().optional().default(false).describe('If true, x/y are offsets from current position')
+    },
+    async (args) => handleMoveNodes(bridge, args)
+  );
+
+  // figma_resize_nodes - Resize nodes
+  server.tool(
+    'figma_resize_nodes',
+    'Resize one or more nodes to an explicit pixel size. At least one dimension (width or height) must be provided. ' +
+    'PREFER figma_set_layout_align with STRETCH when the goal is "size this child to its parent" — STRETCH works ' +
+    'inside instances, survives breakpoint changes, and PRESERVES width/height variable binds; an explicit resize does not. ' +
+    'Safety behavior of this tool: (1) resizing an instance sublayer is rejected up front with INSTANCE_SUBLAYER_RESTRICTED ' +
+    '(Figma silently ignores it); (2) width/height/min/max variable binds are captured before the resize and re-applied ' +
+    'afterwards — recovered binds are listed in "rebound", destroyed ones that could not be recovered are named in "warnings"; ' +
+    '(3) the resulting size is read back and compared to the request — a no-op returns success: false with a RESIZE_NO_OP ' +
+    'error, and a clamped result (min/max limits, auto-layout sizing) is reported in "warnings". Each node echoes ' +
+    '"requested" and "actual" sizes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to resize. Instance sublayers are rejected — resize the component master instead.'),
+      width: z.number().optional().describe('New width in pixels'),
+      height: z.number().optional().describe('New height in pixels')
+    },
+    async (args) => handleResizeNodes(bridge, args)
+  );
+
+  // figma_set_size_limits - Set or clear min/max width/height
+  server.tool(
+    'figma_set_size_limits',
+    'Set or CLEAR the min/max size limits (minWidth, maxWidth, minHeight, maxHeight) on one or more nodes. ' +
+    'Pass a positive number to set a limit, or explicit null to remove it — null is the documented way to clear a limit, ' +
+    'so max-width is no longer a one-way door. Limits apply to auto-layout frames and their direct children; a node that ' +
+    'is neither gets a warning because Figma may ignore the value. Every write is read back and verified: a limit that ' +
+    'did not apply returns success: false with LIMIT_NOT_APPLIED, and one that would not clear returns LIMIT_NOT_CLEARED. ' +
+    'If the field is variable-bound the bound value wins over the literal — the response warns and points at ' +
+    'figma_unbind_variable, which also clears the residual literal. The response echoes all four limits for each node.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to update'),
+      minWidth: z.number().positive().nullable().optional().describe('Minimum width in pixels. null clears the limit. Omit to leave unchanged.'),
+      maxWidth: z.number().positive().nullable().optional().describe('Maximum width in pixels. null clears the limit. Omit to leave unchanged.'),
+      minHeight: z.number().positive().nullable().optional().describe('Minimum height in pixels. null clears the limit. Omit to leave unchanged.'),
+      maxHeight: z.number().positive().nullable().optional().describe('Maximum height in pixels. null clears the limit. Omit to leave unchanged.')
+    },
+    async (args) => handleSetSizeLimits(bridge, args)
+  );
+
+  // figma_set_opacity - Set node opacity
+  server.tool(
+    'figma_set_opacity',
+    'Set opacity (0-1).',
+    {
+      nodeId: z.string().describe('The node ID to modify'),
+      opacity: z.number().min(0).max(1).describe('Opacity value from 0 (transparent) to 1 (opaque)')
+    },
+    async (args) => handleSetOpacity(bridge, args)
+  );
+
+  // figma_set_visible - Show or hide nodes
+  server.tool(
+    'figma_set_visible',
+    'Show or hide nodes. Sets node.visible directly — use this instead of binding a BOOLEAN variable or setting opacity to 0 just to hide something. Response echoes each node\'s resulting visibility.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to show or hide'),
+      visible: z.boolean().describe('true to show, false to hide')
+    },
+    async (args) => handleSetVisible(bridge, args)
+  );
+
+  // figma_set_clips_content - Toggle content clipping on frame-like nodes
+  server.tool(
+    'figma_set_clips_content',
+    'Set whether frame-like nodes clip their children to the frame bounds. Works on FRAME, COMPONENT, COMPONENT_SET, INSTANCE, SLOT and SLIDE — other node types return an error. Response echoes the resulting clipsContent. Read it back with figma_get_nodes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to modify'),
+      clipsContent: z.boolean().describe('true to clip children to the frame bounds, false to let them overflow')
+    },
+    async (args) => handleSetClipsContent(bridge, args)
+  );
+
+  // figma_set_corner_radius - Set corner radius
+  server.tool(
+    'figma_set_corner_radius',
+    'Set corner radius. Use individual values for asymmetric.',
+    {
+      nodeId: z.string().describe('The node ID to modify'),
+      radius: z.number().optional().describe('Uniform corner radius for all corners'),
+      topLeft: z.number().optional().describe('Top-left corner radius'),
+      topRight: z.number().optional().describe('Top-right corner radius'),
+      bottomLeft: z.number().optional().describe('Bottom-left corner radius'),
+      bottomRight: z.number().optional().describe('Bottom-right corner radius')
+    },
+    async (args) => handleSetCornerRadius(bridge, args)
+  );
+
+  // figma_group_nodes - Group nodes
+  server.tool(
+    'figma_group_nodes',
+    'Group nodes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to group together'),
+      name: z.string().optional().default('Group').describe('Name for the new group')
+    },
+    async (args) => handleGroupNodes(bridge, args)
+  );
+
+  // figma_ungroup_nodes - Ungroup nodes
+  server.tool(
+    'figma_ungroup_nodes',
+    'Ungroup nodes.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of group node IDs to ungroup')
+    },
+    async (args) => handleUngroupNodes(bridge, args)
+  );
+
+  // ============================================================
+  // Creation Tools
+  // ============================================================
+
+  // figma_create_frame - Create a new frame
+  server.tool(
+    'figma_create_frame',
+    'Create a frame.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(100).describe('Width in pixels'),
+      height: z.number().optional().default(100).describe('Height in pixels'),
+      name: z.string().optional().default('Frame').describe('Frame name'),
+      fills: colorSchema.optional().describe('Fill color'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateFrame(bridge, args)
+  );
+
+  // figma_create_text - Create a new text node
+  server.tool(
+    'figma_create_text',
+    'Create a text node.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      text: z.string().optional().default('Text').describe('The text content'),
+      fontSize: z.number().optional().default(16).describe('Font size in pixels'),
+      fontFamily: z.string().optional().default('Inter').describe('Font family name'),
+      fontStyle: z.string().optional().default('Regular').describe('Font style (Regular, Bold, etc.)'),
+      fills: colorSchema.optional().describe('Text color'),
+      name: z.string().optional().default('Text').describe('Node name'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateText(bridge, args)
+  );
+
+  // ============================================================
+  // Navigation Tools
+  // ============================================================
+
+  // figma_set_selection - Set the current selection
+  server.tool(
+    'figma_set_selection',
+    'Set selection. Empty array clears.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to select (empty array to clear)')
+    },
+    async (args) => handleSetSelection(bridge, args)
+  );
+
+  // figma_set_current_page - Switch to a different page
+  server.tool(
+    'figma_set_current_page',
+    'Switch to a different page in the Figma document.',
+    {
+      pageId: z.string().describe('The page ID to switch to')
+    },
+    async (args) => handleSetCurrentPage(bridge, args)
+  );
+
+  // ============================================================
+  // Export Tools
+  // ============================================================
+
+  // figma_export_node - Export a node as an image
+  server.tool(
+    'figma_export_node',
+    'Export a node as an image (PNG, SVG, JPG, or PDF). The image is WRITTEN TO DISK and the file path is returned — ' +
+    'read that file to actually view the render (inline base64 cannot be viewed, which is why this is file-first). ' +
+    'Response is { success, nodeId, path, format, scale, bytes } with no inline image data. ' +
+    'Pass outputPath to choose the destination; omit it and the file lands in the OS temp dir under figma-mcp-bridge/. ' +
+    'Set returnBase64: true only if you genuinely need the raw data inline instead of a file. ' +
+    'Exporting and LOOKING at the render is the only way to catch composition problems that property readback cannot see.',
+    {
+      nodeId: z.string().describe('The node ID to export'),
+      format: z.enum(['PNG', 'SVG', 'JPG', 'PDF']).optional().default('PNG').describe('Export format'),
+      scale: z.number().optional().default(1).describe('Export scale (1 = 100%, 2 = 200%, etc.). No need to inflate this to make the image viewable — the file on disk is viewable at any size.'),
+      outputPath: z.string().optional().describe('Absolute file path to write the image to. Parent directories are created. Omit for an auto-named file in the OS temp dir.'),
+      returnBase64: z.boolean().optional().default(false).describe('Return base64 image data inline instead of writing a file. Rarely what you want — the inline data cannot be viewed.')
+    },
+    async (args) => handleExportNode(bridge, args)
+  );
+
+  // ============================================================
+  // Phase 2 Tools
+  // ============================================================
+
+  // figma_create_ellipse - Create an ellipse/circle
+  server.tool(
+    'figma_create_ellipse',
+    'Create ellipse. Use arcData for arcs/rings.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(100).describe('Width in pixels (diameter for circle)'),
+      height: z.number().optional().default(100).describe('Height in pixels (same as width for circle)'),
+      name: z.string().optional().default('Ellipse').describe('Node name'),
+      fills: colorSchema.optional().describe('Fill color'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)'),
+      arcData: z.object({
+        startingAngle: z.number().min(0).max(6.28319).optional().describe('Starting angle in radians (0 = 3 o\'clock)'),
+        endingAngle: z.number().min(0).max(6.28319).optional().describe('Ending angle in radians (2*PI = full circle)'),
+        innerRadius: z.number().min(0).max(1).optional().describe('Inner radius ratio (0 = solid, 0.5 = 50% hole)')
+      }).optional().describe('Arc data for partial ellipses or rings')
+    },
+    async (args) => handleCreateEllipse(bridge, args)
+  );
+
+  // figma_set_effects - Set effects (shadows, blurs)
+  server.tool(
+    'figma_set_effects',
+    'Set effects. Replaces existing.',
+    {
+      nodeId: z.string().describe('The node ID to modify'),
+      effects: z.array(z.union([
+        z.object({
+          type: z.enum(['DROP_SHADOW', 'INNER_SHADOW']).describe('Shadow type'),
+          color: colorSchema.optional().describe('Shadow color'),
+          offset: z.object({
+            x: z.number().describe('Horizontal offset'),
+            y: z.number().describe('Vertical offset')
+          }).optional().describe('Shadow offset'),
+          radius: z.number().min(0).optional().describe('Blur radius'),
+          spread: z.number().optional().describe('Spread radius'),
+          visible: z.boolean().optional().describe('Whether effect is visible'),
+          blendMode: z.string().optional().describe('Blend mode')
+        }),
+        z.object({
+          type: z.enum(['LAYER_BLUR', 'BACKGROUND_BLUR']).describe('Blur type'),
+          radius: z.number().min(0).describe('Blur radius'),
+          visible: z.boolean().optional().describe('Whether effect is visible')
+        })
+      ])).describe('Array of effects to apply')
+    },
+    async (args) => handleSetEffects(bridge, args)
+  );
+
+  // figma_set_auto_layout - Configure auto-layout
+  server.tool(
+    'figma_set_auto_layout',
+    'Configure auto-layout on a frame. Enables responsive layouts with automatic spacing and alignment. ' +
+    'Changing layoutMode or primaryAxisSizingMode can clear a width/height variable bind, so the node\'s size binds are ' +
+    'captured before the change and re-applied after: recovered binds are listed in "rebound", and any bind that could ' +
+    'not be restored is named in "warnings" rather than silently lost.',
+    {
+      nodeId: z.string().describe('The frame node ID to configure'),
+      layoutMode: z.enum(['NONE', 'HORIZONTAL', 'VERTICAL']).optional().describe('Layout direction: NONE (disable), HORIZONTAL (row), or VERTICAL (column)'),
+      primaryAxisSizingMode: z.enum(['FIXED', 'AUTO']).optional().describe('How the frame sizes along the primary axis'),
+      counterAxisSizingMode: z.enum(['FIXED', 'AUTO']).optional().describe('How the frame sizes along the counter axis'),
+      primaryAxisAlignItems: z.enum(['MIN', 'CENTER', 'MAX', 'SPACE_BETWEEN']).optional().describe('Alignment of children along primary axis'),
+      counterAxisAlignItems: z.enum(['MIN', 'CENTER', 'MAX', 'BASELINE']).optional().describe('Alignment of children along counter axis'),
+      paddingTop: z.number().min(0).optional().describe('Top padding in pixels'),
+      paddingRight: z.number().min(0).optional().describe('Right padding in pixels'),
+      paddingBottom: z.number().min(0).optional().describe('Bottom padding in pixels'),
+      paddingLeft: z.number().min(0).optional().describe('Left padding in pixels'),
+      itemSpacing: z.number().min(0).optional().describe('Space between items in pixels'),
+      counterAxisSpacing: z.number().min(0).optional().describe('Space between rows when wrapped'),
+      layoutWrap: z.enum(['NO_WRAP', 'WRAP']).optional().describe('Whether to wrap items to new rows/columns')
+    },
+    async (args) => handleSetAutoLayout(bridge, args)
+  );
+
+  // figma_get_local_styles - List local styles
+  server.tool(
+    'figma_get_local_styles',
+    'List all local styles defined in the document (colors, text, effects, grids). TIP: Use figma_search_styles instead when looking for specific styles by name - it returns compact results and reduces token usage.',
+    {
+      type: z.enum(['PAINT', 'TEXT', 'EFFECT', 'GRID', 'ALL']).optional().default('ALL').describe('Filter by style type')
+    },
+    async (args) => handleGetLocalStyles(bridge, args)
+  );
+
+  // figma_apply_style - Apply a style to a node
+  server.tool(
+    'figma_apply_style',
+    'Apply a local style to a node. Styles provide consistent, reusable design tokens. Works for all five style ' +
+    'properties including text — the plugin uses the async setters (setTextStyleIdAsync / setFillStyleIdAsync / ' +
+    'setStrokeStyleIdAsync / setEffectStyleIdAsync / setGridStyleIdAsync) that are mandatory under ' +
+    'documentAccess: "dynamic-page". The applied style ID is read back off the node and returned as appliedStyleId ' +
+    'with verified: true; if the readback does not match, the call fails with STYLE_NOT_APPLIED instead of reporting success.',
+    {
+      nodeId: z.string().describe('The node ID to apply the style to'),
+      styleId: z.string().describe('The style ID to apply'),
+      property: z.enum(['fills', 'strokes', 'text', 'effects', 'grid']).describe('Which property to apply the style to')
+    },
+    async (args) => handleApplyStyle(bridge, args)
+  );
+
+  // figma_create_component - Create a component
+  server.tool(
+    'figma_create_component',
+    'Create a component.',
+    {
+      fromNodeId: z.string().optional().describe('Convert an existing node to a component'),
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(100).describe('Width in pixels'),
+      height: z.number().optional().default(100).describe('Height in pixels'),
+      name: z.string().optional().default('Component').describe('Component name'),
+      fills: colorSchema.optional().describe('Fill color'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)'),
+      description: z.string().optional().describe('Component description')
+    },
+    async (args) => handleCreateComponent(bridge, args)
+  );
+
+  // figma_create_instance - Create an instance of a component
+  server.tool(
+    'figma_create_instance',
+    'Create a component instance.',
+    {
+      componentId: z.string().describe('The component ID to create an instance of'),
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)'),
+      name: z.string().optional().describe('Instance name (defaults to component name)')
+    },
+    async (args) => handleCreateInstance(bridge, args)
+  );
+
+  // ============================================================
+  // Phase 3 Tools: Variables, Lines, Constraints
+  // ============================================================
+
+  // figma_get_local_variables - Get local variables
+  // WARNING: Can return 25k+ tokens for large design systems. Prefer figma_search_variables when possible.
+  server.tool(
+    'figma_get_local_variables',
+    'Get all local variables and variable collections from the Figma document. Returns variables with their types (COLOR, FLOAT, STRING, BOOLEAN), modes, and values. WARNING: Can return 25k+ tokens and may be truncated. Use figma_search_variables instead when looking for specific variables.',
+    {
+      type: z.enum(['COLOR', 'FLOAT', 'STRING', 'BOOLEAN', 'ALL']).optional().default('ALL').describe('Filter by variable type')
+    },
+    async (args) => handleGetLocalVariables(bridge, args)
+  );
+
+  // figma_search_variables - Search variables with filtering (optimized for reduced token usage)
+  // PREFERRED: Use this instead of figma_get_local_variables for ~50x token reduction
+  server.tool(
+    'figma_search_variables',
+    'Search for variables by name pattern. More efficient than get_local_variables - use this when looking for specific variables like "tailwind/orange/*" or "*primary*". Returns compact results to reduce token usage. PREFERRED over figma_get_local_variables for efficiency (~500 tokens vs 25k+).',
+    {
+      namePattern: z.string().optional().describe('Filter by name pattern with wildcards. Examples: "tailwind/orange/*", "*primary*", "spacing/*". Use * for any characters.'),
+      nameContains: z.string().optional().describe('Simple filter: find variables where name contains this string (case-insensitive). Example: "orange" matches "tailwind/orange/500"'),
+      type: z.enum(['COLOR', 'FLOAT', 'STRING', 'BOOLEAN', 'ALL']).optional().default('ALL').describe('Filter by variable type'),
+      collectionName: z.string().optional().describe('Filter by collection name (exact match or partial)'),
+      compact: z.boolean().optional().default(true).describe('Return minimal data (id, name, hex/value only). Set false for full metadata.'),
+      limit: z.number().optional().default(50).describe('Maximum number of variables to return')
+    },
+    async (args) => handleSearchVariables(bridge, args)
+  );
+
+  // ============================================================
+  // Smart Query Tools (token-efficient search)
+  // ============================================================
+
+  // figma_search_nodes - Search nodes by name within a scope
+  server.tool(
+    'figma_search_nodes',
+    'Search for nodes by name within a scope. PREFERRED for finding specific frames, sections, or elements. Requires parentId to scope search. Returns compact results (~50 tokens/node vs ~500 for full).',
+    {
+      parentId: z.string().describe('Scope to search (page/frame/section ID). REQUIRED to prevent runaway queries.'),
+      nameContains: z.string().optional().describe('Case-insensitive substring match. Example: "color scale" matches "Color Scale Section"'),
+      namePattern: z.string().optional().describe('Glob pattern with wildcards. Examples: "*button*", "Header/*"'),
+      types: z.array(z.string()).optional().describe('Filter by node types: FRAME, TEXT, SECTION, COMPONENT, INSTANCE, GROUP, etc.'),
+      maxDepth: z.number().optional().default(-1).describe('How deep to search (-1 = unlimited, 1 = immediate children only)'),
+      compact: z.boolean().optional().default(true).describe('Return minimal data (id, name, type, parentId, childCount)'),
+      limit: z.number().optional().default(50).describe('Maximum number of results')
+    },
+    async (args) => handleSearchNodes(bridge, args)
+  );
+
+  // figma_search_components - Search local components by name
+  server.tool(
+    'figma_search_components',
+    'Search local components by name. Use when looking for specific components like "Button", "Header", etc. Returns compact results with component metadata.',
+    {
+      nameContains: z.string().optional().describe('Case-insensitive substring match'),
+      namePattern: z.string().optional().describe('Glob pattern with wildcards'),
+      includeVariants: z.boolean().optional().default(false).describe('Include individual variants from component sets'),
+      compact: z.boolean().optional().default(true).describe('Return minimal data'),
+      limit: z.number().optional().default(50).describe('Maximum number of results')
+    },
+    async (args) => handleSearchComponents(bridge, args)
+  );
+
+  // figma_search_styles - Search local styles by name
+  server.tool(
+    'figma_search_styles',
+    'Search local styles by name. More efficient than figma_get_local_styles when looking for specific styles.',
+    {
+      nameContains: z.string().optional().describe('Case-insensitive substring match'),
+      type: z.enum(['PAINT', 'TEXT', 'EFFECT', 'GRID', 'ALL']).optional().default('ALL').describe('Filter by style type'),
+      compact: z.boolean().optional().default(true).describe('Return minimal data'),
+      limit: z.number().optional().default(50).describe('Maximum number of results')
+    },
+    async (args) => handleSearchStyles(bridge, args)
+  );
+
+  // figma_get_children - Get immediate children of a node
+  server.tool(
+    'figma_get_children',
+    'Get immediate children of a node. Use for browsing hierarchy one level at a time. More efficient than figma_get_nodes for exploring structure. Compact results include x/y, so they can be used to measure layout (e.g. which children share a row after wrapping). Composite instance-sublayer parent IDs ("I<instanceId>;<childId>") resolve here too.',
+    {
+      parentId: z.string().describe('Node ID to get children of. REQUIRED.'),
+      compact: z.boolean().optional().default(true).describe('Return minimal data (id, name, type, x, y, parentId, childCount). Set false for the full ~40-property serialization.')
+    },
+    async (args) => handleGetChildren(bridge, args)
+  );
+
+  // figma_set_variable - Set variable value or bind to node
+  server.tool(
+    'figma_set_variable',
+    'Set the value of an existing variable for a specific mode, or bind a variable to a node property OR to a local style. Styles are supported: pass styleId (or a style ID as nodeId) with field. TEXT styles bind fontFamily, fontSize, fontStyle, fontWeight, letterSpacing, lineHeight, paragraphSpacing, paragraphIndent; PAINT styles bind their color via field "paints". Style binds echo the style\'s boundVariables so the bind is verifiable in the same call. ' +
+    'Node binds are VERIFIED: after binding, node.boundVariables is re-read and the response returns it with verified: true. ' +
+    'If the bind did not land, the call fails with BIND_NOT_APPLIED rather than reporting success — this catches Figma\'s ' +
+    'silent no-ops. Binding "width" or "height" on an instance sublayer is rejected up front with ' +
+    'INSTANCE_SUBLAYER_RESTRICTED: Figma does not allow that override, so bind it on the component master instead (or size ' +
+    'the sublayer with figma_set_layout_align: STRETCH).',
+    {
+      variableId: z.string().describe('The variable ID to set or bind'),
+      modeId: z.string().optional().describe('Mode ID to set value for (required when setting value)'),
+      value: z.union([
+        z.number(),
+        z.string(),
+        z.boolean(),
+        z.object({
+          r: z.number().min(0).max(1).describe('Red (0-1)'),
+          g: z.number().min(0).max(1).describe('Green (0-1)'),
+          b: z.number().min(0).max(1).describe('Blue (0-1)'),
+          a: z.number().min(0).max(1).optional().describe('Alpha (0-1)')
+        })
+      ]).optional().describe('The value to set (number, string, boolean, or color object)'),
+      nodeId: z.string().optional().describe('Node ID to bind variable to (for binding operation). A style ID passed here is routed to the style path.'),
+      styleId: z.string().optional().describe('Local style ID to bind variable to (e.g., "S:abc123..."). Use instead of nodeId to bind a TEXT or PAINT style.'),
+      field: z.string().optional().describe('Field to bind. Nodes: "opacity", "cornerRadius", "fills", "strokes", etc. Text styles: "fontSize", "lineHeight", "letterSpacing", "paragraphSpacing", "paragraphIndent", "fontFamily", "fontStyle", "fontWeight". Paint styles: "paints".'),
+      paintIndex: z.number().optional().default(0).describe('Paint array index when binding to fills, strokes, or a paint style')
+    },
+    async (args) => handleSetVariable(bridge, args)
+  );
+
+  // figma_create_line - Create a line
+  server.tool(
+    'figma_create_line',
+    'Create a line.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      length: z.number().optional().default(100).describe('Line length in pixels'),
+      rotation: z.number().optional().default(0).describe('Line rotation in degrees (0 = horizontal)'),
+      name: z.string().optional().default('Line').describe('Node name'),
+      strokeWeight: z.number().optional().default(1).describe('Stroke weight in pixels'),
+      strokes: colorSchema.optional().describe('Stroke color'),
+      strokeCap: z.enum(['NONE', 'ROUND', 'SQUARE', 'ARROW_LINES', 'ARROW_EQUILATERAL']).optional().default('NONE').describe('Stroke cap style (ARROW_LINES/ARROW_EQUILATERAL for arrows)'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateLine(bridge, args)
+  );
+
+  // figma_set_constraints - Set resize constraints
+  server.tool(
+    'figma_set_constraints',
+    'Set resize constraints on a node. Constraints control how a node resizes when its parent frame resizes. Only works on nodes inside frames (not auto-layout frames).',
+    {
+      nodeId: z.string().describe('The node ID to set constraints on'),
+      horizontal: z.enum(['MIN', 'CENTER', 'MAX', 'STRETCH', 'SCALE']).optional().describe('Horizontal constraint: MIN (left), CENTER, MAX (right), STRETCH (left+right), SCALE (proportional)'),
+      vertical: z.enum(['MIN', 'CENTER', 'MAX', 'STRETCH', 'SCALE']).optional().describe('Vertical constraint: MIN (top), CENTER, MAX (bottom), STRETCH (top+bottom), SCALE (proportional)')
+    },
+    async (args) => handleSetConstraints(bridge, args)
+  );
+
+  // ============================================================
+  // Phase 4 Tools: Polygons, Boolean Operations, Viewport, Blend Mode, Detach
+  // ============================================================
+
+  // DISABLED - Uncomment to enable advanced shape tools
+  // // figma_create_polygon - Create a polygon or star
+  // server.tool(
+  //   'figma_create_polygon',
+  //   'Create a polygon (triangle, pentagon, hexagon, etc.) or star shape. Set innerRadius (0-1) to create a star with spiky points.',
+  //   {
+  //     x: z.number().optional().default(0).describe('X position'),
+  //     y: z.number().optional().default(0).describe('Y position'),
+  //     width: z.number().optional().default(100).describe('Width in pixels'),
+  //     height: z.number().optional().default(100).describe('Height in pixels'),
+  //     pointCount: z.number().min(3).optional().default(5).describe('Number of sides (polygon) or points (star). Minimum 3.'),
+  //     innerRadius: z.number().min(0).max(1).optional().describe('Inner radius ratio for stars (0-1). 0 = very spiky, 1 = polygon. Omit for regular polygon.'),
+  //     name: z.string().optional().describe('Node name'),
+  //     fills: colorSchema.optional().describe('Fill color'),
+  //     strokes: colorSchema.optional().describe('Stroke color'),
+  //     strokeWeight: z.number().optional().describe('Stroke weight in pixels'),
+  //     cornerRadius: z.number().optional().describe('Corner radius for vertices'),
+  //     parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+  //   },
+  //   async (args) => handleCreatePolygon(bridge, args)
+  // );
+
+  // // figma_boolean_operation - Perform boolean operations on shapes
+  // server.tool(
+  //   'figma_boolean_operation',
+  //   'Combine multiple shapes using boolean operations (union, subtract, intersect, exclude) or flatten them into a single vector.',
+  //   {
+  //     operation: z.enum(['UNION', 'SUBTRACT', 'INTERSECT', 'EXCLUDE', 'FLATTEN']).describe('Boolean operation type: UNION (combine), SUBTRACT (cut), INTERSECT (overlap only), EXCLUDE (non-overlap only), FLATTEN (destructive vector)'),
+  //     nodeIds: z.array(z.string()).min(2).describe('Array of node IDs to combine (minimum 2 nodes)'),
+  //     name: z.string().optional().describe('Name for the resulting node')
+  //   },
+  //   async (args) => handleBooleanOperation(bridge, args)
+  // );
+
+  // // figma_zoom_to_node - Zoom viewport to focus on specific nodes
+  // server.tool(
+  //   'figma_zoom_to_node',
+  //   'Scroll and zoom the Figma viewport to focus on specific nodes. Automatically calculates zoom level to fit all specified nodes.',
+  //   {
+  //     nodeIds: z.array(z.string()).min(1).describe('Array of node IDs to zoom to')
+  //   },
+  //   async (args) => handleZoomToNode(bridge, args)
+  // );
+
+  // // figma_set_blend_mode - Set blend mode on a node
+  // server.tool(
+  //   'figma_set_blend_mode',
+  //   'Set the blend mode (layer blending) of a node. Controls how the node visually blends with layers below it.',
+  //   {
+  //     nodeId: z.string().describe('The node ID to modify'),
+  //     blendMode: z.enum([
+  //       'PASS_THROUGH', 'NORMAL', 'DARKEN', 'MULTIPLY', 'LINEAR_BURN', 'COLOR_BURN',
+  //       'LIGHTEN', 'SCREEN', 'LINEAR_DODGE', 'COLOR_DODGE', 'OVERLAY', 'SOFT_LIGHT',
+  //       'HARD_LIGHT', 'DIFFERENCE', 'EXCLUSION', 'HUE', 'SATURATION', 'COLOR', 'LUMINOSITY'
+  //     ]).describe('Blend mode: NORMAL (default), MULTIPLY (darken), SCREEN (lighten), OVERLAY (contrast), etc.')
+  //   },
+  //   async (args) => handleSetBlendMode(bridge, args)
+  // );
+
+  // figma_detach_instance - Detach instance from component
+  server.tool(
+    'figma_detach_instance',
+    'Detach a component instance, converting it to a regular frame. Preserves overrides but severs the link to the main component.',
+    {
+      nodeId: z.string().describe('The instance node ID to detach')
+    },
+    async (args) => handleDetachInstance(bridge, args)
+  );
+
+  // ============================================================
+  // Phase 5 Tools: Layout Align, Vector, Rename, Reorder
+  // ============================================================
+
+  // figma_set_layout_align - Set layout alignment for auto-layout children
+  server.tool(
+    'figma_set_layout_align',
+    'Set how a child behaves within an auto-layout frame. Controls individual alignment (STRETCH), growth (fill container), and absolute positioning.',
+    {
+      nodeId: z.string().describe('The child node ID to modify'),
+      layoutAlign: z.enum(['MIN', 'CENTER', 'MAX', 'STRETCH', 'INHERIT']).optional().describe('Counter-axis alignment: STRETCH to fill width/height'),
+      layoutGrow: z.number().min(0).max(1).optional().describe('Primary-axis growth: 0 = fixed size, 1 = fill available space'),
+      layoutPositioning: z.enum(['AUTO', 'ABSOLUTE']).optional().describe('AUTO = follow auto-layout, ABSOLUTE = manually positioned')
+    },
+    async (args) => handleSetLayoutAlign(bridge, args)
+  );
+
+  // DISABLED - Uncomment to enable custom vector paths
+  // // figma_create_vector - Create a custom vector path
+  // server.tool(
+  //   'figma_create_vector',
+  //   'Create a custom vector shape using SVG-style path data. Supports M (move), L (line), Q (quadratic curve), C (cubic bezier), Z (close).',
+  //   {
+  //     x: z.number().optional().default(0).describe('X position'),
+  //     y: z.number().optional().default(0).describe('Y position'),
+  //     data: z.string().describe('SVG path string (e.g., "M 0 100 L 100 100 L 50 0 Z" for triangle)'),
+  //     windingRule: z.enum(['NONZERO', 'EVENODD', 'NONE']).optional().default('NONZERO').describe('Fill rule: NONZERO (solid), EVENODD (holes), NONE (outline only)'),
+  //     name: z.string().optional().default('Vector').describe('Node name'),
+  //     fills: colorSchema.optional().describe('Fill color'),
+  //     strokes: colorSchema.optional().describe('Stroke color'),
+  //     strokeWeight: z.number().optional().describe('Stroke weight in pixels'),
+  //     parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+  //   },
+  //   async (args) => handleCreateVector(bridge, args)
+  // );
+
+  // figma_rename_node - Rename nodes
+  server.tool(
+    'figma_rename_node',
+    'Rename one or more nodes. For batch renaming, all nodes get the same name.',
+    {
+      nodeId: z.string().optional().describe('Single node ID to rename'),
+      nodeIds: z.array(z.string()).optional().describe('Array of node IDs to rename (batch)'),
+      name: z.string().describe('The new name for the node(s)')
+    },
+    async (args) => handleRenameNode(bridge, args)
+  );
+
+  // figma_reorder_node - Change z-order of a node
+  server.tool(
+    'figma_reorder_node',
+    'Change the z-order (layer order) of a node among its siblings. A numeric position is the FINAL index the node ' +
+    'ends up at — index 2 means the node is at index 2 when the call returns, not one off from it. Figma sorts children ' +
+    'back-to-front, so 0 is the BOTTOM of the layer stack and childCount - 1 is the top; "back" is 0 and "front" is the ' +
+    'last index. Out-of-range indices are clamped into range and the response reports clamped: true with a message. ' +
+    'The final index is verified by reading it back — a mismatch fails with REORDER_FAILED rather than reporting success. ' +
+    'Reordering children of an INSTANCE is blocked by Figma and returns INSTANCE_SUBLAYER_RESTRICTED; reorder on the master instead.',
+    {
+      nodeId: z.string().describe('The node ID to reorder'),
+      position: z.union([
+        z.literal('front'),
+        z.literal('back'),
+        z.number()
+      ]).describe('Final position: "front" (top of stack), "back" (bottom), or the final zero-based index among siblings (0 = bottom)')
+    },
+    async (args) => handleReorderNode(bridge, args)
+  );
+
+  // ============================================================
+  // Design System Creation Tools
+  // ============================================================
+
+  // figma_set_text_style - Set font properties on existing text
+  server.tool(
+    'figma_set_text_style',
+    'Set text font properties.',
+    {
+      nodeId: z.string().describe('Text node ID'),
+      fontSize: z.number().optional().describe('Font size in pixels'),
+      fontFamily: z.string().optional().describe('Font family (e.g., "Inter")'),
+      fontStyle: z.string().optional().describe('Font style (e.g., "Bold", "Regular")'),
+      textCase: z.enum(['ORIGINAL', 'UPPER', 'LOWER', 'TITLE']).optional().describe('Text case transformation'),
+      textDecoration: z.enum(['NONE', 'UNDERLINE', 'STRIKETHROUGH']).optional().describe('Text decoration'),
+      lineHeight: z.union([
+        z.object({ unit: z.literal('AUTO') }),
+        z.object({ unit: z.literal('PIXELS'), value: z.number() }),
+        z.object({ unit: z.literal('PERCENT'), value: z.number() })
+      ]).optional().describe('Line height (AUTO, or PIXELS/PERCENT with value)'),
+      letterSpacing: z.union([
+        z.object({ unit: z.literal('PIXELS'), value: z.number() }),
+        z.object({ unit: z.literal('PERCENT'), value: z.number() })
+      ]).optional().describe('Letter spacing (PIXELS or PERCENT with value)'),
+      textAlignHorizontal: z.enum(['LEFT', 'CENTER', 'RIGHT', 'JUSTIFIED']).optional().describe('Horizontal text alignment'),
+      textAlignVertical: z.enum(['TOP', 'CENTER', 'BOTTOM']).optional().describe('Vertical text alignment')
+    },
+    async (args) => handleSetTextStyle(bridge, args)
+  );
+
+  // figma_create_paint_style - Create a local paint style
+  server.tool(
+    'figma_create_paint_style',
+    'Create a paint style.',
+    {
+      name: z.string().describe('Style name (use "/" for folders, e.g., "Brand/Primary")'),
+      fills: colorSchema.describe('Fill color - use { color: "#RRGGBB" } for simple colors'),
+      description: z.string().optional().describe('Style description')
+    },
+    async (args) => handleCreatePaintStyle(bridge, args)
+  );
+
+  // figma_create_text_style - Create a local text style
+  server.tool(
+    'figma_create_text_style',
+    'Create a text style.',
+    {
+      name: z.string().describe('Style name (use "/" for folders)'),
+      fontFamily: z.string().optional().default('Inter').describe('Font family'),
+      fontStyle: z.string().optional().default('Regular').describe('Font style (Regular, Bold, etc.)'),
+      fontSize: z.number().optional().default(16).describe('Font size in pixels'),
+      lineHeight: z.union([
+        z.object({ unit: z.literal('AUTO') }),
+        z.object({ unit: z.literal('PIXELS'), value: z.number() }),
+        z.object({ unit: z.literal('PERCENT'), value: z.number() })
+      ]).optional().describe('Line height'),
+      letterSpacing: z.union([
+        z.object({ unit: z.literal('PIXELS'), value: z.number() }),
+        z.object({ unit: z.literal('PERCENT'), value: z.number() })
+      ]).optional().describe('Letter spacing'),
+      textCase: z.enum(['ORIGINAL', 'UPPER', 'LOWER', 'TITLE']).optional().describe('Text case'),
+      textDecoration: z.enum(['NONE', 'UNDERLINE', 'STRIKETHROUGH']).optional().describe('Text decoration'),
+      description: z.string().optional().describe('Style description')
+    },
+    async (args) => handleCreateTextStyle(bridge, args)
+  );
+
+  // figma_delete_style - Delete a local style
+  server.tool(
+    'figma_delete_style',
+    'Delete a local style (paint, text, effect or grid) from the document. Only local styles can be deleted — styles from a subscribed library return a REMOTE_STYLE error. Use with caution: nodes using the style keep their resolved values but lose the link. Find style IDs with figma_search_styles.',
+    {
+      styleId: z.string().describe('The style ID to delete (e.g., "S:abc123...")')
+    },
+    async (args) => handleDeleteStyle(bridge, args)
+  );
+
+  // figma_create_variable_collection - Create a variable collection
+  server.tool(
+    'figma_create_variable_collection',
+    'Create a new variable collection to organize variables.',
+    {
+      name: z.string().describe('Collection name'),
+      modes: z.array(z.string()).optional().describe('Mode names (defaults to ["Mode 1"])')
+    },
+    async (args) => handleCreateVariableCollection(bridge, args)
+  );
+
+  // figma_create_variable - Create a variable
+  server.tool(
+    'figma_create_variable',
+    'Create a new variable in a collection.',
+    {
+      collectionId: z.string().describe('Variable collection ID'),
+      name: z.string().describe('Variable name (use "/" for groups, e.g., "colors/primary")'),
+      type: z.enum(['COLOR', 'FLOAT', 'STRING', 'BOOLEAN']).describe('Variable type'),
+      value: z.union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+        z.object({ r: z.number(), g: z.number(), b: z.number(), a: z.number().optional() }),
+        z.object({ color: z.string() })
+      ]).optional().describe('Initial value for default mode'),
+      aliasOf: z.string().optional().describe('Variable ID to alias (instead of direct value)'),
+      description: z.string().optional().describe('Variable description'),
+      scopes: z.array(z.enum([
+        'ALL_SCOPES', 'TEXT_CONTENT', 'CORNER_RADIUS', 'WIDTH_HEIGHT',
+        'GAP', 'ALL_FILLS', 'FRAME_FILL', 'SHAPE_FILL', 'TEXT_FILL', 'STROKE_COLOR',
+        'STROKE_FLOAT', 'EFFECT_FLOAT', 'EFFECT_COLOR', 'OPACITY', 'FONT_FAMILY',
+        'FONT_STYLE', 'FONT_WEIGHT', 'FONT_SIZE', 'LINE_HEIGHT', 'LETTER_SPACING',
+        'PARAGRAPH_SPACING', 'PARAGRAPH_INDENT'
+      ])).optional().describe('Where this variable can be used')
+    },
+    async (args) => handleCreateVariable(bridge, args)
+  );
+
+  // figma_rename_variable - Rename an existing variable
+  server.tool(
+    'figma_rename_variable',
+    'Rename an existing variable. Use "/" in the name to organize into groups (e.g., "font weight/heading/h1").',
+    {
+      variableId: z.string().describe('The variable ID to rename'),
+      name: z.string().describe('The new name for the variable (use "/" for groups)')
+    },
+    async (args) => handleRenameVariable(bridge, args)
+  );
+
+  // figma_delete_variables - Delete one or more variables
+  server.tool(
+    'figma_delete_variables',
+    'Delete one or more variables from the document. Use with caution - this cannot be undone.',
+    {
+      variableIds: z.array(z.string()).describe('Array of variable IDs to delete')
+    },
+    async (args) => handleDeleteVariables(bridge, args)
+  );
+
+  // figma_delete_variable_collection - Delete a variable collection
+  server.tool(
+    'figma_delete_variable_collection',
+    'Delete a variable collection and all its variables. Use with caution - this cannot be undone.',
+    {
+      collectionId: z.string().describe('The collection ID to delete')
+    },
+    async (args) => handleDeleteVariableCollection(bridge, args)
+  );
+
+  // figma_rename_variable_collection - Rename a variable collection
+  server.tool(
+    'figma_rename_variable_collection',
+    'Rename a variable collection.',
+    {
+      collectionId: z.string().describe('The collection ID to rename'),
+      name: z.string().describe('The new name for the collection')
+    },
+    async (args) => handleRenameVariableCollection(bridge, args)
+  );
+
+  // figma_rename_mode - Rename a mode in a collection
+  server.tool(
+    'figma_rename_mode',
+    'Rename a mode in a variable collection (e.g., "Mode 1" to "dark").',
+    {
+      collectionId: z.string().describe('The collection ID containing the mode'),
+      modeId: z.string().describe('The mode ID to rename'),
+      name: z.string().describe('The new name for the mode')
+    },
+    async (args) => handleRenameMode(bridge, args)
+  );
+
+  // figma_add_mode - Add a mode to a collection
+  server.tool(
+    'figma_add_mode',
+    'Add a new mode to a variable collection.',
+    {
+      collectionId: z.string().describe('The collection ID to add mode to'),
+      name: z.string().describe('Name for the new mode')
+    },
+    async (args) => handleAddMode(bridge, args)
+  );
+
+  // figma_delete_mode - Delete a mode from a collection
+  server.tool(
+    'figma_delete_mode',
+    'Delete a mode from a variable collection. Cannot delete the last mode.',
+    {
+      collectionId: z.string().describe('The collection ID containing the mode'),
+      modeId: z.string().describe('The mode ID to delete')
+    },
+    async (args) => handleDeleteMode(bridge, args)
+  );
+
+  // figma_set_variable_mode - Pin or unpin an explicit variable mode on nodes/pages
+  server.tool(
+    'figma_set_variable_mode',
+    'Pin an explicit variable mode on nodes or pages, or clear an existing pin. This is how a preview/page frame is made to resolve a particular mode (e.g. a mobile frame pinned to the Spacing collection\'s "mobile" mode) — no more cloning a frame just to inherit its mode. Pass clear: true to unpin, which fixes a bad pin inherited through a clone or component master. Works on scene nodes AND page IDs. The response echoes each node\'s resulting explicitVariableModes map so the change is verifiable in the same call ({} means nothing is pinned).',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs or page IDs to pin/unpin'),
+      collectionId: z.string().describe('Variable collection ID the pin applies to (pins are per-collection)'),
+      modeId: z.string().optional().describe('Mode ID to pin. Required unless clear is true. Must belong to collectionId — the error lists the valid modes if it does not.'),
+      clear: z.boolean().optional().default(false).describe('true to remove this collection\'s pin from the nodes instead of setting one')
+    },
+    async (args) => handleSetVariableMode(bridge, args)
+  );
+
+  // figma_unbind_variable - Remove variable binding from a node
+  server.tool(
+    'figma_unbind_variable',
+    'Remove a variable binding from a node property. The unbind is verified by readback (UNBIND_FAILED if the field is ' +
+    'still bound) and the response echoes the node\'s remaining boundVariables. ' +
+    'Special handling for minWidth / maxWidth / minHeight / maxHeight: unbinding one of these leaves the last resolved ' +
+    'number behind as a hard literal clamp, so the literal is cleared to null too — the response reports previousLiteral ' +
+    'and clearedLiteral. Set a new limit with figma_set_size_limits.',
+    {
+      nodeId: z.string().describe('The node ID to unbind from'),
+      field: z.string().describe('The field to unbind (fills, strokes, opacity, cornerRadius, minWidth, maxWidth, etc.)'),
+      paintIndex: z.number().optional().default(0).describe('Paint array index for fills/strokes')
+    },
+    async (args) => handleUnbindVariable(bridge, args)
+  );
+
+  // ============================================================
+  // Page Management Tools
+  // ============================================================
+
+  // figma_create_page - Create a new page (Figma Design only)
+  server.tool(
+    'figma_create_page',
+    'Create a new page in the document. **Figma Design only — not available in FigJam.** Calling this in a FigJam file returns a FIGMA_DESIGN_ONLY error. FigJam files have pages but the plugin API does not expose figma.createPage(); pages must be created via the FigJam UI.',
+    {
+      name: z.string().describe('Name for the new page'),
+      index: z.number().optional().describe('Position in the page list (0 = first). Defaults to end.')
+    },
+    async (args) => handleCreatePage(bridge, args)
+  );
+
+  // figma_rename_page - Rename a page
+  server.tool(
+    'figma_rename_page',
+    'Rename an existing page in the Figma document.',
+    {
+      pageId: z.string().describe('The page ID to rename'),
+      name: z.string().describe('The new name for the page')
+    },
+    async (args) => handleRenamePage(bridge, args)
+  );
+
+  // figma_delete_page - Delete a page
+  server.tool(
+    'figma_delete_page',
+    'Delete a page from the Figma document. Cannot delete the last remaining page.',
+    {
+      pageId: z.string().describe('The page ID to delete')
+    },
+    async (args) => handleDeletePage(bridge, args)
+  );
+
+  // DISABLED - Uncomment to enable page reordering
+  // // figma_reorder_page - Reorder a page
+  // server.tool(
+  //   'figma_reorder_page',
+  //   'Change the position of a page in the page list.',
+  //   {
+  //     pageId: z.string().describe('The page ID to reorder'),
+  //     index: z.number().describe('New position in the page list (0 = first)')
+  //   },
+  //   async (args) => handleReorderPage(bridge, args)
+  // );
+
+  // ============================================================
+  // Node Structure Tools
+  // ============================================================
+
+  // figma_reparent_nodes - Move nodes to a different parent
+  server.tool(
+    'figma_reparent_nodes',
+    'Move nodes to a different parent container. Useful for reorganizing the layer hierarchy.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to move'),
+      newParentId: z.string().describe('The new parent node ID (must be a frame, group, or page)'),
+      index: z.number().optional().describe('Position within the new parent (0 = bottom/back). Defaults to top/front.')
+    },
+    async (args) => handleReparentNodes(bridge, args)
+  );
+
+  // figma_move_to_page - Move nodes to a different page
+  server.tool(
+    'figma_move_to_page',
+    'Move nodes from their current page to a different page.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to move'),
+      targetPageId: z.string().describe('The destination page ID'),
+      x: z.number().optional().describe('X position on the target page'),
+      y: z.number().optional().describe('Y position on the target page')
+    },
+    async (args) => handleMoveToPage(bridge, args)
+  );
+
+  // ============================================================
+  // Component Instance Tools
+  // ============================================================
+
+  // figma_swap_instance - Swap instance to different component
+  server.tool(
+    'figma_swap_instance',
+    'Swap a component instance to use a different component. Preserves position and size.',
+    {
+      instanceId: z.string().describe('The instance node ID to swap'),
+      newComponentId: z.string().describe('The component ID to swap to')
+    },
+    async (args) => handleSwapInstance(bridge, args)
+  );
+
+  // ============================================================
+  // Additional Tools
+  // ============================================================
+
+  // figma_duplicate_page - Clone an entire page (Figma Design only)
+  server.tool(
+    'figma_duplicate_page',
+    'Clone an entire page including all its contents. The new page is inserted after the original. **Figma Design only — not available in FigJam.** Returns FIGMA_DESIGN_ONLY in FigJam since the underlying figma.createPage() API is not exposed there.',
+    {
+      pageId: z.string().describe('The page ID to duplicate'),
+      name: z.string().optional().describe('Name for the new page (defaults to "original name + copy")')
+    },
+    async (args) => handleDuplicatePage(bridge, args)
+  );
+
+  // figma_set_rotation - Set rotation on nodes
+  server.tool(
+    'figma_set_rotation',
+    'Set the rotation (in degrees) of one or more nodes. pivot defaults to "center", which keeps the node\'s visual ' +
+    'centre in place by writing relativeTransform. pivot: "top-left" is Figma\'s raw node.rotation behavior, which ' +
+    'rotates about the top-left corner and therefore MOVES the visual centre. ' +
+    'Limitation: an auto-layout parent computes its children\'s positions and ignores the translation part of ' +
+    'relativeTransform, so a centre pivot is impossible on a non-ABSOLUTE auto-layout child — those nodes get a ' +
+    'top-left rotation plus an explicit warning naming the parent (set layoutPositioning: ABSOLUTE, or wrap the node ' +
+    'in a plain frame, to get a true centre pivot). Each node echoes appliedPivot, its resulting rotation, and its ' +
+    'absoluteBoundingBox so the pivot can be verified.',
+    {
+      nodeIds: z.array(z.string()).describe('Array of node IDs to rotate'),
+      rotation: z.number().min(-180).max(180).describe('Rotation in degrees (-180 to 180)'),
+      pivot: z.enum(['center', 'top-left']).optional().default('center').describe('Point to rotate about. "center" (default) preserves the node\'s visual centre; "top-left" is Figma\'s raw node.rotation behavior.')
+    },
+    async (args) => handleSetRotation(bridge, args)
+  );
+
+  // figma_combine_as_variants - Combine components into a component set
+  server.tool(
+    'figma_combine_as_variants',
+    'Combine multiple components into a component set with variants. Components must use variant naming (e.g., "Size=Large", "State=Active"). Returns the new component set.',
+    {
+      componentIds: z.array(z.string()).min(2).describe('Array of component IDs to combine (minimum 2)')
+    },
+    async (args) => handleCombineAsVariants(bridge, args)
+  );
+
+  // DISABLED - Uncomment to enable layout grids
+  // // figma_set_layout_grids - Set layout grids on a frame
+  // server.tool(
+  //   'figma_set_layout_grids',
+  //   'Set layout grids on a frame. Grids help with alignment and spacing. Pass an empty array to remove all grids.',
+  //   {
+  //     nodeId: z.string().describe('The frame node ID to set grids on'),
+  //     layoutGrids: z.array(z.object({
+  //       pattern: z.enum(['COLUMNS', 'ROWS', 'GRID']).describe('Grid pattern type'),
+  //       sectionSize: z.number().optional().describe('Size of each column/row/cell in pixels'),
+  //       visible: z.boolean().optional().default(true).describe('Whether grid is visible'),
+  //       color: z.object({
+  //         r: z.number().min(0).max(1).describe('Red (0-1)'),
+  //         g: z.number().min(0).max(1).describe('Green (0-1)'),
+  //         b: z.number().min(0).max(1).describe('Blue (0-1)'),
+  //         a: z.number().min(0).max(1).optional().default(0.1).describe('Alpha (0-1)')
+  //       }).optional().describe('Grid color with alpha'),
+  //       alignment: z.enum(['MIN', 'CENTER', 'MAX', 'STRETCH']).optional().describe('Column/row alignment (for COLUMNS/ROWS pattern)'),
+  //       gutterSize: z.number().optional().describe('Gutter size between columns/rows in pixels'),
+  //       offset: z.number().optional().describe('Offset from edge in pixels'),
+  //       count: z.number().optional().describe('Number of columns/rows (use large number like 100 for auto)')
+  //     })).describe('Array of layout grid configurations')
+  //   },
+  //   async (args) => handleSetLayoutGrids(bridge, args)
+  // );
+
+  // ============================================================
+  // FigJam Tools
+  // ============================================================
+  // These commands target FigJam-only node types (sticky notes, flowchart shapes,
+  // connectors, tables, code blocks, link previews). Most return WRONG_EDITOR
+  // when called outside a FigJam file. Sections work in both Figma and FigJam.
+
+  // figma_create_sticky - Create a sticky note
+  server.tool(
+    'figma_create_sticky',
+    'FigJam only: create a sticky note. Default size is fixed (240×240); width/height are not configurable. Text is set via the embedded sublayer (font auto-loaded). Note: the author name and visibility are auto-populated by Figma from the active user — they cannot be set programmatically.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      text: z.string().optional().describe('Sticky note body text'),
+      fills: colorSchema.optional().describe('Background color of the sticky'),
+      isWideWidth: z.boolean().optional().describe('Use the wide rectangular sticky variant'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateSticky(bridge, args)
+  );
+
+  // figma_set_sticky - Update a sticky's metadata
+  server.tool(
+    'figma_set_sticky',
+    'FigJam only: toggle a sticky note between square (240×240) and wide-rectangle variants. Use figma_set_text to change the body text. (Author name/visibility are read-only at runtime — Figma sets them from the active user.)',
+    {
+      nodeId: z.string().describe('The STICKY node ID'),
+      isWideWidth: z.boolean().optional().describe('Wide vs square sticky')
+    },
+    async (args) => handleSetSticky(bridge, args)
+  );
+
+  // figma_create_shape_with_text - Create a flowchart shape with embedded text
+  server.tool(
+    'figma_create_shape_with_text',
+    'FigJam only: create a flowchart shape with embedded text (process box, decision diamond, database cylinder, etc.). 30 shape types are available — use ROUNDED_RECTANGLE for processes, DIAMOND for decisions, ENG_DATABASE for data stores. cornerRadius is fixed and cannot be set.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(208).describe('Width in pixels'),
+      height: z.number().optional().default(208).describe('Height in pixels'),
+      shapeType: z.enum(SHAPE_TYPES).describe('Shape variety: SQUARE, ELLIPSE, ROUNDED_RECTANGLE, DIAMOND, TRIANGLE_UP/DOWN, PARALLELOGRAM_RIGHT/LEFT, ENG_DATABASE, ENG_QUEUE, ENG_FILE, ENG_FOLDER, TRAPEZOID, PREDEFINED_PROCESS, SHIELD, DOCUMENT_SINGLE/MULTIPLE, MANUAL_INPUT, HEXAGON, CHEVRON, PENTAGON, OCTAGON, STAR, PLUS, ARROW_LEFT/RIGHT, SUMMING_JUNCTION, OR, SPEECH_BUBBLE, INTERNAL_STORAGE'),
+      text: z.string().optional().describe('Embedded text content (font auto-loaded)'),
+      fills: colorSchema.optional().describe('Shape fill color'),
+      strokes: colorSchema.optional().describe('Shape stroke color'),
+      strokeWeight: z.number().optional().describe('Stroke weight in pixels'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateShapeWithText(bridge, args)
+  );
+
+  // figma_set_shape_type - Change the shape variant
+  server.tool(
+    'figma_set_shape_type',
+    'FigJam only: change the shape type of an existing shape-with-text node (e.g., turn a ROUNDED_RECTANGLE into a DIAMOND).',
+    {
+      nodeId: z.string().describe('The SHAPE_WITH_TEXT node ID'),
+      shapeType: z.enum(SHAPE_TYPES).describe('New shape type')
+    },
+    async (args) => handleSetShapeType(bridge, args)
+  );
+
+  // figma_create_connector - Create an arrow/connector between nodes
+  server.tool(
+    'figma_create_connector',
+    'FigJam only: create a connector (arrow line) between two nodes for flowcharts and diagrams. Endpoints can attach to nodes via magnets (AUTO recommended), to fixed positions on nodes, or be free-floating on the canvas. Default end cap is ARROW_EQUILATERAL so it looks like an arrow without configuration. ELBOWED is best for orthogonal flowcharts; STRAIGHT only supports CENTER/NONE magnets.',
+    {
+      start: connectorEndpointSchema.optional().describe('Start endpoint: { nodeId, magnet } | { nodeId, position } | { position }'),
+      end: connectorEndpointSchema.optional().describe('End endpoint: { nodeId, magnet } | { nodeId, position } | { position }'),
+      lineType: z.enum(CONNECTOR_LINE_TYPES).optional().default('ELBOWED').describe('Line routing: ELBOWED (right angles), STRAIGHT, or CURVED'),
+      startCap: z.enum(CONNECTOR_STROKE_CAPS).optional().default('NONE').describe('Decoration at start endpoint'),
+      endCap: z.enum(CONNECTOR_STROKE_CAPS).optional().default('ARROW_EQUILATERAL').describe('Decoration at end endpoint (default arrow)'),
+      text: z.string().optional().describe('Center label text on the connector'),
+      strokes: colorSchema.optional().describe('Line color'),
+      strokeWeight: z.number().optional().describe('Line thickness in pixels'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateConnector(bridge, args)
+  );
+
+  // figma_set_connector - Update an existing connector
+  server.tool(
+    'figma_set_connector',
+    'FigJam only: modify an existing connector\'s endpoints, line type, end caps, or label.',
+    {
+      nodeId: z.string().describe('The CONNECTOR node ID'),
+      start: connectorEndpointSchema.optional().describe('Replacement start endpoint'),
+      end: connectorEndpointSchema.optional().describe('Replacement end endpoint'),
+      lineType: z.enum(CONNECTOR_LINE_TYPES).optional().describe('New line routing type'),
+      startCap: z.enum(CONNECTOR_STROKE_CAPS).optional().describe('New start decoration'),
+      endCap: z.enum(CONNECTOR_STROKE_CAPS).optional().describe('New end decoration'),
+      text: z.string().optional().describe('Replacement label text')
+    },
+    async (args) => handleSetConnector(bridge, args)
+  );
+
+  // figma_create_section - Create a labeled section (works in Figma and FigJam)
+  server.tool(
+    'figma_create_section',
+    'Create a labeled section. Sections work in BOTH Figma design files and FigJam — use them to group flowcharts, diagrams, or design areas. Supports dev status (READY_FOR_DEV/COMPLETED) for handoff.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      width: z.number().optional().default(600).describe('Width in pixels'),
+      height: z.number().optional().default(400).describe('Height in pixels'),
+      name: z.string().optional().describe('Section label'),
+      fills: colorSchema.optional().describe('Section background fill'),
+      sectionContentsHidden: z.boolean().optional().describe('Visually collapse the section\'s contents'),
+      devStatus: z.enum(['READY_FOR_DEV', 'COMPLETED']).optional().describe('Dev Mode handoff status (only valid on sections directly under a page or another section)'),
+      devStatusDescription: z.string().optional().describe('Optional description shown with the dev status'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateSection(bridge, args)
+  );
+
+  // figma_set_section - Update a section
+  server.tool(
+    'figma_set_section',
+    'Update a section\'s name, dev status, or content visibility. Pass devStatus: null to clear.',
+    {
+      nodeId: z.string().describe('The SECTION node ID'),
+      name: z.string().optional().describe('New section label'),
+      sectionContentsHidden: z.boolean().optional().describe('Show or hide section contents'),
+      devStatus: z.enum(['READY_FOR_DEV', 'COMPLETED']).nullable().optional().describe('Set dev status, or null to clear'),
+      devStatusDescription: z.string().optional().describe('Description shown with dev status')
+    },
+    async (args) => handleSetSection(bridge, args)
+  );
+
+  // figma_create_table - Create a table
+  server.tool(
+    'figma_create_table',
+    'FigJam only: create a table for documentation or structured data. Optionally seed initial cell content via the cells array. Defaults to 2×2.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      numRows: z.number().int().min(1).optional().default(2).describe('Number of rows'),
+      numColumns: z.number().int().min(1).optional().default(2).describe('Number of columns'),
+      cells: z.array(z.object({
+        row: z.number().int().min(0).describe('Row index (0-based)'),
+        column: z.number().int().min(0).describe('Column index (0-based)'),
+        text: z.string().optional().describe('Cell text content'),
+        fills: colorSchema.optional().describe('Cell background fill')
+      })).optional().describe('Initial cell content. Cells outside the table bounds are silently ignored.'),
+      fills: colorSchema.optional().describe('Table background fill'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateTable(bridge, args)
+  );
+
+  // figma_set_table_cell - Set the text/fill of a table cell
+  server.tool(
+    'figma_set_table_cell',
+    'FigJam only: set the text and/or fill color of a single table cell.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      row: z.number().int().min(0).describe('Row index (0-based)'),
+      column: z.number().int().min(0).describe('Column index (0-based)'),
+      text: z.string().optional().describe('New cell text'),
+      fills: colorSchema.optional().describe('New cell background fill')
+    },
+    async (args) => handleSetTableCell(bridge, args)
+  );
+
+  // figma_insert_table_row - Insert a row before the given index
+  server.tool(
+    'figma_insert_table_row',
+    'FigJam only: insert a row at the given index (existing rows at and after the index shift down).',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      rowIndex: z.number().int().min(0).describe('Insert position (0 = top)')
+    },
+    async (args) => handleInsertTableRow(bridge, args)
+  );
+
+  // figma_insert_table_column - Insert a column before the given index
+  server.tool(
+    'figma_insert_table_column',
+    'FigJam only: insert a column at the given index (existing columns at and after the index shift right).',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      columnIndex: z.number().int().min(0).describe('Insert position (0 = leftmost)')
+    },
+    async (args) => handleInsertTableColumn(bridge, args)
+  );
+
+  // figma_remove_table_row - Remove a row
+  server.tool(
+    'figma_remove_table_row',
+    'FigJam only: remove the row at the given index.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      rowIndex: z.number().int().min(0).describe('Row to remove')
+    },
+    async (args) => handleRemoveTableRow(bridge, args)
+  );
+
+  // figma_remove_table_column - Remove a column
+  server.tool(
+    'figma_remove_table_column',
+    'FigJam only: remove the column at the given index.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      columnIndex: z.number().int().min(0).describe('Column to remove')
+    },
+    async (args) => handleRemoveTableColumn(bridge, args)
+  );
+
+  // figma_resize_table_row - Set row height
+  server.tool(
+    'figma_resize_table_row',
+    'FigJam only: set the height of a table row.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      rowIndex: z.number().int().min(0).describe('Row index'),
+      height: z.number().min(1).describe('New height in pixels')
+    },
+    async (args) => handleResizeTableRow(bridge, args)
+  );
+
+  // figma_resize_table_column - Set column width
+  server.tool(
+    'figma_resize_table_column',
+    'FigJam only: set the width of a table column.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      columnIndex: z.number().int().min(0).describe('Column index'),
+      width: z.number().min(1).describe('New width in pixels')
+    },
+    async (args) => handleResizeTableColumn(bridge, args)
+  );
+
+  // figma_move_table_row - Reorder rows
+  server.tool(
+    'figma_move_table_row',
+    'FigJam only: move a row from one index to another.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      fromIndex: z.number().int().min(0).describe('Source row index'),
+      toIndex: z.number().int().min(0).describe('Destination row index')
+    },
+    async (args) => handleMoveTableRow(bridge, args)
+  );
+
+  // figma_move_table_column - Reorder columns
+  server.tool(
+    'figma_move_table_column',
+    'FigJam only: move a column from one index to another.',
+    {
+      nodeId: z.string().describe('The TABLE node ID'),
+      fromIndex: z.number().int().min(0).describe('Source column index'),
+      toIndex: z.number().int().min(0).describe('Destination column index')
+    },
+    async (args) => handleMoveTableColumn(bridge, args)
+  );
+
+  // figma_create_code_block - Create a syntax-highlighted code block
+  server.tool(
+    'figma_create_code_block',
+    'FigJam only: create a syntax-highlighted code block for documentation. Code is a plain string property (no font loading required).',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      code: z.string().describe('The code text content'),
+      codeLanguage: z.enum(CODE_LANGUAGES).optional().default('PLAINTEXT').describe('Syntax highlighting language'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateCodeBlock(bridge, args)
+  );
+
+  // figma_set_code_block - Update a code block
+  server.tool(
+    'figma_set_code_block',
+    'FigJam only: update an existing code block\'s code text or language.',
+    {
+      nodeId: z.string().describe('The CODE_BLOCK node ID'),
+      code: z.string().optional().describe('New code text'),
+      codeLanguage: z.enum(CODE_LANGUAGES).optional().describe('New syntax-highlighting language')
+    },
+    async (args) => handleSetCodeBlock(bridge, args)
+  );
+
+  // figma_create_link_preview - Embed a URL (auto-detects iframe vs. card)
+  server.tool(
+    'figma_create_link_preview',
+    'FigJam only: create a rich link preview from a URL. Returns either an EMBED (iframe; works for OEmbed providers like YouTube/Spotify) or a LINK_UNFURL (rich card from OpenGraph/Twitter Card metadata) — the response includes nodeType so you know which.',
+    {
+      x: z.number().optional().default(0).describe('X position'),
+      y: z.number().optional().default(0).describe('Y position'),
+      url: z.string().describe('The URL to preview'),
+      parentId: z.string().optional().describe('Parent node ID (defaults to current page)')
+    },
+    async (args) => handleCreateLinkPreview(bridge, args)
+  );
+
+  // ---- Prototype tools ----
+
+  // figma_get_reactions - Read all reactions on a node
+  server.tool(
+    'figma_get_reactions',
+    'Prototype (Figma Design only): get all reactions (interactions) on a node. Returns the full reactions array with trigger and action details.',
+    {
+      nodeId: z.string().describe('Node ID to read reactions from')
+    },
+    async (args) => handleGetReactions(bridge, args)
+  );
+
+  // figma_add_reaction - Add a prototype interaction to a node
+  server.tool(
+    'figma_add_reaction',
+    'Prototype (Figma Design only): add a reaction (interaction) to a node. A reaction pairs a trigger with an action. Existing reactions are preserved.\n\nTrigger types: ON_CLICK, ON_HOVER, ON_PRESS, ON_DRAG, ON_MEDIA_END, AFTER_TIMEOUT, MOUSE_UP, MOUSE_DOWN, MOUSE_ENTER, MOUSE_LEAVE, ON_KEY_DOWN, ON_MEDIA_HIT.\n\nAction types: NODE (navigate/overlay/scroll — set navigation field), BACK, CLOSE, URL.\n\nFor NODE actions, navigation values: NAVIGATE (go to frame), SWAP (replace current frame), OVERLAY (open as overlay), SCROLL_TO (scroll to frame), CHANGE_TO (change component variant).',
+    {
+      nodeId: z.string().describe('Node ID to add the reaction to'),
+      trigger: z.object({
+        type: z.enum([
+          'ON_CLICK', 'ON_HOVER', 'ON_PRESS', 'ON_DRAG', 'ON_MEDIA_END',
+          'AFTER_TIMEOUT', 'MOUSE_UP', 'MOUSE_DOWN', 'MOUSE_ENTER', 'MOUSE_LEAVE',
+          'ON_KEY_DOWN', 'ON_MEDIA_HIT'
+        ]).describe('Trigger type'),
+        timeout: z.number().optional().describe('Delay in ms — required for AFTER_TIMEOUT'),
+        delay: z.number().optional().describe('Delay in ms — for MOUSE_UP, MOUSE_DOWN, MOUSE_ENTER, MOUSE_LEAVE'),
+        device: z.enum(['KEYBOARD', 'XBOX_ONE', 'PS4', 'SWITCH_PRO', 'UNKNOWN_CONTROLLER']).optional().describe('Input device — for ON_KEY_DOWN (default: KEYBOARD)'),
+        keyCodes: z.array(z.number()).optional().describe('Key codes — for ON_KEY_DOWN'),
+        mediaHitTime: z.number().optional().describe('Time in seconds — for ON_MEDIA_HIT')
+      }).describe('What triggers the reaction'),
+      action: z.object({
+        type: z.enum(['NODE', 'BACK', 'CLOSE', 'URL']).describe(
+          'Action type. NODE covers all navigation (use navigation field to specify NAVIGATE/OVERLAY/SCROLL_TO/SWAP/CHANGE_TO). BACK goes to previous frame. CLOSE closes overlay. URL opens a URL.'
+        ),
+        destinationId: z.string().optional().describe('Target frame/node ID — for NODE action'),
+        url: z.string().optional().describe('URL string — required for URL action'),
+        openInNewTab: z.boolean().optional().describe('Open URL in a new tab (default false) — for URL action'),
+        navigation: z.enum(['NAVIGATE', 'SWAP', 'OVERLAY', 'SCROLL_TO', 'CHANGE_TO']).optional().describe('Navigation type for NODE action (default: NAVIGATE)'),
+        transition: z.object({
+          type: z.enum(['DISSOLVE', 'SMART_ANIMATE', 'SCROLL_ANIMATE', 'MOVE_IN', 'MOVE_OUT', 'PUSH', 'SLIDE_IN', 'SLIDE_OUT']).describe('Transition type. DISSOLVE/SMART_ANIMATE/SCROLL_ANIMATE take no direction; MOVE_IN/MOVE_OUT/PUSH/SLIDE_IN/SLIDE_OUT require direction.'),
+          direction: z.enum(['LEFT', 'RIGHT', 'TOP', 'BOTTOM']).optional().describe('Direction — required for MOVE_IN, MOVE_OUT, PUSH, SLIDE_IN, SLIDE_OUT'),
+          matchLayers: z.boolean().optional().describe('Smart-match shared layers across frames during a directional transition (default false). Only used by directional types.'),
+          duration: z.number().optional().describe('Duration in seconds (default 0.3)'),
+          easing: z.object({
+            type: z.enum(['LINEAR', 'EASE_IN', 'EASE_OUT', 'EASE_IN_AND_OUT', 'EASE_IN_BACK', 'EASE_OUT_BACK', 'EASE_IN_AND_OUT_BACK', 'CUSTOM_CUBIC_BEZIER', 'GENTLE', 'QUICK', 'BOUNCY', 'SLOW', 'CUSTOM_SPRING']).describe('Easing type. GENTLE/QUICK/BOUNCY/SLOW are spring presets.'),
+            easingFunctionCubicBezier: z.object({
+              x1: z.number(), y1: z.number(), x2: z.number(), y2: z.number()
+            }).optional().describe('Cubic bezier control points — required for CUSTOM_CUBIC_BEZIER')
+          }).optional().describe('Easing curve (default: LINEAR)')
+        }).optional().describe('Transition animation — omit for no animation'),
+        preserveScrollPosition: z.boolean().optional().describe('Preserve scroll position on navigate (default false)'),
+        overlayRelativePosition: z.object({ x: z.number(), y: z.number() }).optional().describe('Overlay position offset — for OVERLAY navigation')
+      }).describe('What happens when the trigger fires')
+    },
+    async (args) => handleAddReaction(bridge, args)
+  );
+
+  // figma_remove_reaction - Remove a reaction by index
+  server.tool(
+    'figma_remove_reaction',
+    'Prototype (Figma Design only): remove a reaction from a node by its zero-based index in the reactions array. Use figma_get_reactions first to find the index.',
+    {
+      nodeId: z.string().describe('Node ID to remove the reaction from'),
+      index: z.number().int().min(0).describe('Zero-based index of the reaction to remove')
+    },
+    async (args) => handleRemoveReaction(bridge, args)
+  );
+
+  // figma_set_flow_starting_point - Set or clear a prototype flow starting point
+  server.tool(
+    'figma_set_flow_starting_point',
+    'Prototype (Figma Design only): set a top-level frame as a prototype flow starting point on the current page, or clear it. Flow starting points are page-level — Figma stores them as { nodeId, name } entries on the page.',
+    {
+      nodeId: z.string().describe('Frame node ID to set as flow starting point. Must be FRAME, COMPONENT, or COMPONENT_SET.'),
+      flowName: z.string().optional().describe('Name for the flow (defaults to "Flow 1" if omitted). If the frame is already a flow starting point, its name is updated.'),
+      clear: z.boolean().optional().describe('If true, remove the flow starting point for this frame from the page')
+    },
+    async (args) => handleSetFlowStartingPoint(bridge, args)
+  );
+}