figma-console-mcp Server

{
  "type": "object",
  "properties": {
    "nodeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 500,
      "description": "Array of node IDs to arrange (max 500)"
    },
    "layout": {
      "type": "string",
      "enum": [
        "grid",
        "horizontal",
        "vertical"
      ],
      "default": "grid",
      "description": "Layout type: grid, horizontal, or vertical"
    },
    "spacing": {
      "type": "number",
      "default": 40,
      "description": "Spacing between nodes in pixels"
    },
    "columns": {
      "type": "number",
      "description": "Number of columns for grid layout (defaults to sqrt of node count)"
    }
  },
  "required": [
    "nodeIds"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 50000,
      "description": "The code content"
    },
    "language": {
      "type": "string",
      "description": "Programming language (e.g., 'JAVASCRIPT', 'PYTHON', 'TYPESCRIPT', 'JSON', 'HTML', 'CSS')"
    },
    "x": {
      "type": "number",
      "description": "X position on canvas"
    },
    "y": {
      "type": "number",
      "description": "Y position on canvas"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "startNodeId": {
      "type": "string",
      "description": "Node ID of the start element"
    },
    "endNodeId": {
      "type": "string",
      "description": "Node ID of the end element"
    },
    "label": {
      "type": "string",
      "maxLength": 5000,
      "description": "Optional text label on the connector"
    },
    "startMagnet": {
      "type": "string",
      "enum": [
        "AUTO",
        "TOP",
        "BOTTOM",
        "LEFT",
        "RIGHT"
      ],
      "default": "AUTO",
      "description": "Magnet position on the start node"
    },
    "endMagnet": {
      "type": "string",
      "enum": [
        "AUTO",
        "TOP",
        "BOTTOM",
        "LEFT",
        "RIGHT"
      ],
      "default": "AUTO",
      "description": "Magnet position on the end node"
    }
  },
  "required": [
    "startNodeId",
    "endNodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 500,
      "description": "Section name/title"
    },
    "x": {
      "type": "number",
      "description": "X position on canvas"
    },
    "y": {
      "type": "number",
      "description": "Y position on canvas"
    },
    "width": {
      "type": "number",
      "minimum": 1,
      "maximum": 20000,
      "default": 1000,
      "description": "Section width in pixels"
    },
    "height": {
      "type": "number",
      "minimum": 1,
      "maximum": 20000,
      "default": 800,
      "description": "Section height in pixels"
    },
    "fillColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Fill color as hex"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text label for the shape"
    },
    "shapeType": {
      "type": "string",
      "enum": [
        "ROUNDED_RECTANGLE",
        "DIAMOND",
        "ELLIPSE",
        "TRIANGLE_UP",
        "TRIANGLE_DOWN",
        "PARALLELOGRAM_RIGHT",
        "PARALLELOGRAM_LEFT",
        "ENG_DATABASE",
        "ENG_QUEUE",
        "ENG_FILE",
        "ENG_FOLDER"
      ],
      "description": "Shape type"
    },
    "x": {
      "type": "number",
      "description": "X position on canvas"
    },
    "y": {
      "type": "number",
      "description": "Y position on canvas"
    },
    "width": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000,
      "description": "Width in pixels"
    },
    "height": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000,
      "description": "Height in pixels"
    },
    "fillColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Fill color as hex (e.g., '#E1F5EE')"
    },
    "strokeColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Stroke/border color as hex"
    },
    "fontSize": {
      "type": "number",
      "minimum": 1,
      "maximum": 200,
      "description": "Text font size in pixels"
    },
    "strokeDashPattern": {
      "type": "string",
      "description": "Dash pattern as comma-separated numbers (e.g., '10,5' for dashed)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "stickies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 5000,
            "description": "Text content"
          },
          "color": {
            "type": "string",
            "enum": [
              "YELLOW",
              "BLUE",
              "GREEN",
              "PINK",
              "ORANGE",
              "PURPLE",
              "RED",
              "LIGHT_GRAY",
              "GRAY"
            ],
            "description": "Sticky color"
          },
          "x": {
            "type": "number",
            "description": "X position"
          },
          "y": {
            "type": "number",
            "description": "Y position"
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false
      },
      "maxItems": 200,
      "description": "Array of sticky note specifications (max 200)"
    }
  },
  "required": [
    "stickies"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text content for the sticky note"
    },
    "color": {
      "type": "string",
      "enum": [
        "YELLOW",
        "BLUE",
        "GREEN",
        "PINK",
        "ORANGE",
        "PURPLE",
        "RED",
        "LIGHT_GRAY",
        "GRAY"
      ],
      "description": "Sticky color"
    },
    "x": {
      "type": "number",
      "description": "X position on canvas"
    },
    "y": {
      "type": "number",
      "description": "Y position on canvas"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "description": "Number of rows (1-100)"
    },
    "columns": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Number of columns (1-50)"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 5000
        }
      },
      "description": "2D array of cell text content (row-major order)"
    },
    "x": {
      "type": "number",
      "description": "X position on canvas"
    },
    "y": {
      "type": "number",
      "description": "Y position on canvas"
    }
  },
  "required": [
    "rows",
    "columns"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeTypes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "STICKY",
          "SHAPE_WITH_TEXT",
          "CONNECTOR",
          "TABLE",
          "CODE_BLOCK",
          "SECTION",
          "FRAME",
          "TEXT"
        ]
      },
      "description": "Filter by node types. Omit for all."
    },
    "maxNodes": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000,
      "default": 500,
      "description": "Maximum nodes to return (1-1000, default: 500)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The component or component set node ID"
    },
    "propertyName": {
      "type": "string",
      "description": "Name for the new property (e.g., 'Show Icon', 'Button Label', 'Content')"
    },
    "type": {
      "type": "string",
      "enum": [
        "BOOLEAN",
        "TEXT",
        "INSTANCE_SWAP",
        "VARIANT",
        "SLOT"
      ],
      "description": "Property type: BOOLEAN for toggles, TEXT for strings, INSTANCE_SWAP for component swaps, VARIANT for variant selection, SLOT for freeform slot areas"
    },
    "defaultValue": {
      "type": [
        "string",
        "number",
        "boolean"
      ],
      "description": "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": {
      "type": "string",
      "description": "Property description (SLOT properties only)"
    },
    "preferredValues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "COMPONENT",
              "COMPONENT_SET"
            ]
          },
          "key": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "key"
        ],
        "additionalProperties": false
      },
      "description": "Preferred components (INSTANCE_SWAP and SLOT only)"
    }
  },
  "required": [
    "nodeId",
    "propertyName",
    "type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "description": "The collection ID to add the mode to (e.g., 'VariableCollectionId:123:456'). Get this from figma_get_variables."
    },
    "modeName": {
      "type": "string",
      "description": "The name for the new mode (e.g., 'Dark', 'Mobile', 'High Contrast')."
    }
  },
  "required": [
    "collectionId",
    "modeName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    },
    "shapeType": {
      "type": "string",
      "enum": [
        "RECTANGLE",
        "ELLIPSE"
      ],
      "description": "Shape type"
    },
    "x": {
      "type": "number",
      "description": "X position"
    },
    "y": {
      "type": "number",
      "description": "Y position"
    },
    "width": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000,
      "description": "Width in pixels"
    },
    "height": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000,
      "description": "Height in pixels"
    },
    "fillColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "default": "#CCCCCC",
      "description": "Hex color e.g. '#FF5733'"
    }
  },
  "required": [
    "slideId",
    "shapeType",
    "x",
    "y",
    "width",
    "height"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "COMPONENT or COMPONENT_SET node ID"
    },
    "propertyName": {
      "type": "string",
      "description": "Slot property name (e.g. 'Content')"
    },
    "frameNodeId": {
      "type": "string",
      "description": "Frame node ID to bind as the slot content area"
    },
    "description": {
      "type": "string",
      "description": "Slot property description (SLOT-only)"
    },
    "preferredValues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "COMPONENT",
              "COMPONENT_SET"
            ],
            "description": "Type of preferred value"
          },
          "key": {
            "type": "string",
            "description": "Component or component set key"
          }
        },
        "required": [
          "type",
          "key"
        ],
        "additionalProperties": false
      },
      "description": "Preferred components for slot content (SLOT-only)"
    }
  },
  "required": [
    "nodeId",
    "propertyName",
    "frameNodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    },
    "text": {
      "type": "string",
      "maxLength": 10000,
      "description": "The text content"
    },
    "x": {
      "type": "number",
      "default": 100,
      "description": "X position"
    },
    "y": {
      "type": "number",
      "default": 100,
      "description": "Y position"
    },
    "fontSize": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000,
      "default": 24,
      "description": "Font size in pixels"
    },
    "fontFamily": {
      "type": "string",
      "default": "Inter",
      "description": "Font family (e.g., 'Manrope', 'IBM Plex Sans')"
    },
    "fontStyle": {
      "type": "string",
      "default": "Regular",
      "description": "Font style/weight (e.g., 'Bold', 'SemiBold', 'Medium')"
    },
    "color": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Text fill color as hex (e.g., '#FFFFFF')"
    },
    "textAlign": {
      "type": "string",
      "enum": [
        "LEFT",
        "CENTER",
        "RIGHT"
      ],
      "description": "Horizontal text alignment"
    },
    "width": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000,
      "description": "Text box width for wrapping. When set, enables text wrapping."
    },
    "lineHeight": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "description": "Line height in pixels"
    },
    "letterSpacing": {
      "type": "number",
      "description": "Letter spacing in pixels"
    },
    "textCase": {
      "type": "string",
      "enum": [
        "ORIGINAL",
        "UPPER",
        "LOWER",
        "TITLE"
      ],
      "description": "Text case transformation"
    }
  },
  "required": [
    "slideId",
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "COMPONENT_SET node ID (the parent of all variants, e.g., '214:274')"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slotId": {
      "type": "string",
      "description": "Direct SlotNode ID (from figma_get_slots)"
    },
    "instanceId": {
      "type": "string",
      "description": "Instance ID — use with slotName when slotId is unknown"
    },
    "slotName": {
      "type": "string",
      "description": "Slot layer name on the instance (e.g. 'Content')"
    },
    "sourceNodeId": {
      "type": "string",
      "description": "Node to clone into the slot (default: clone=true)"
    },
    "nodeType": {
      "type": "string",
      "enum": [
        "FRAME",
        "RECTANGLE",
        "ELLIPSE",
        "TEXT",
        "LINE",
        "POLYGON",
        "STAR",
        "VECTOR"
      ],
      "description": "Create a new node in the slot instead of cloning"
    },
    "properties": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number"
        ]
      },
      "description": "Properties for created nodes: name, text, width, height"
    },
    "clone": {
      "type": "boolean",
      "default": true,
      "description": "When using sourceNodeId, clone the node (default true). Set false to move."
    },
    "clearExisting": {
      "type": "boolean",
      "default": false,
      "description": "Remove existing slot children before appending"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "componentSetId": {
      "type": "string",
      "description": "Node ID of the component set to arrange. If not provided, will look for a selected component set."
    },
    "componentSetName": {
      "type": "string",
      "description": "Name of the component set to find. Used if componentSetId not provided."
    },
    "options": {
      "type": "object",
      "properties": {
        "gap": {
          "type": "number",
          "default": 24,
          "description": "Gap between grid cells in pixels (default: 24)"
        },
        "cellPadding": {
          "type": "number",
          "default": 20,
          "description": "Padding inside each cell around the variant (default: 20)"
        },
        "columnProperty": {
          "type": "string",
          "description": "Property to use for columns (default: auto-detect last property, usually 'State')"
        }
      },
      "additionalProperties": false,
      "description": "Layout options"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Node ID of a COMPONENT_SET, COMPONENT, or INSTANCE to audit. Falls back to current selection if omitted."
    },
    "targetSize": {
      "type": "number",
      "description": "Minimum touch target size in px (default: 24 per WCAG 2.5.8). Use 44 for iOS or 48 for Android guidelines."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. If not provided, uses the currently active file."
    },
    "format": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "'summary' (default) — bounded readable report: overall + category scores + non-pass findings + remediation. 'full' — complete scored JSON (examples/locations clamped); prefer per-category calls over 'full' when working interactively."
    },
    "category": {
      "type": "string",
      "enum": [
        "naming-semantics",
        "token-architecture",
        "component-metadata",
        "accessibility",
        "consistency",
        "coverage"
      ],
      "description": "Return full findings (including passes, examples, locations) for ONE category — the chunked drill-down path after a summary call."
    },
    "forceRefresh": {
      "type": "boolean",
      "default": false,
      "description": "Bypass the 5-minute audit cache and re-crawl the file. Only needed after editing the file."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "description": "Collection ID to create all variables in (e.g., 'VariableCollectionId:123:456')"
    },
    "variables": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Variable name (e.g., 'primary-blue')"
          },
          "resolvedType": {
            "type": "string",
            "enum": [
              "COLOR",
              "FLOAT",
              "STRING",
              "BOOLEAN"
            ],
            "description": "Variable type"
          },
          "description": {
            "type": "string",
            "description": "Optional description"
          },
          "valuesByMode": {
            "type": "object",
            "additionalProperties": {
              "type": [
                "string",
                "number",
                "boolean"
              ]
            },
            "description": "Values by mode ID. For COLOR: hex like '#FF0000'. Example: { '1:0': '#FF0000' }"
          }
        },
        "required": [
          "name",
          "resolvedType"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 100,
      "description": "Array of variables to create (1-100)"
    }
  },
  "required": [
    "collectionId",
    "variables"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "variableId": {
            "type": "string",
            "description": "Variable ID (e.g., 'VariableID:123:456')"
          },
          "modeId": {
            "type": "string",
            "description": "Mode ID (e.g., '1:0')"
          },
          "value": {
            "type": [
              "string",
              "number",
              "boolean"
            ],
            "description": "New value. COLOR: hex like '#FF0000'. FLOAT: number. STRING: text. BOOLEAN: true/false."
          }
        },
        "required": [
          "variableId",
          "modeId",
          "value"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 100,
      "description": "Array of updates to apply (1-100)"
    }
  },
  "required": [
    "updates"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "node_id": {
      "type": "string",
      "description": "The parent node ID to inspect (typically a COMPONENT_SET). If omitted, falls back to the first node in the current Figma selection."
    },
    "target_component_property": {
      "type": "string",
      "description": "A componentPropertyDefinitions key (e.g. 'Disabled#1:2') — find when this property was first added to the node."
    },
    "target_child_node_id": {
      "type": "string",
      "description": "A descendant node ID — find when this child was first added under node_id."
    },
    "start_version": {
      "type": "string",
      "default": "current",
      "description": "Version to walk backward from. Default 'current' (HEAD)."
    },
    "max_versions_to_walk": {
      "type": "integer",
      "minimum": 2,
      "maximum": 500,
      "default": 200,
      "description": "Lookback cap. Binary search probes ~log2(N) of these. Default 200, max 500."
    },
    "include_autosaves": {
      "type": "boolean",
      "default": true,
      "description": "Include auto-saved versions in the search range. Default true (better attribution accuracy; most autosaves carry the real human user)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "ID of the node to capture (e.g., '1:234'). If not provided, captures the current page."
    },
    "format": {
      "type": "string",
      "enum": [
        "PNG",
        "JPG",
        "SVG"
      ],
      "default": "PNG",
      "description": "Image format (default: PNG). Use JPG for photographic or gradient-heavy content."
    },
    "scale": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 4,
      "default": 1,
      "description": "Scale factor (default: 1). The plugin automatically caps the effective scale so the exported image does not exceed 1568px on its longest side (the AI vision processing ceiling)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "nodeId": {
      "type": "string",
      "description": "Component node ID (e.g., '695:313')"
    },
    "codeSpec": {
      "type": "object",
      "properties": {
        "filePath": {
          "type": "string",
          "description": "Path to the component source file"
        },
        "visual": {
          "type": "object",
          "properties": {
            "backgroundColor": {
              "type": "string"
            },
            "borderColor": {
              "type": "string"
            },
            "borderWidth": {
              "type": "number"
            },
            "borderRadius": {
              "type": [
                "number",
                "string"
              ]
            },
            "opacity": {
              "type": "number"
            },
            "fills": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "color": {
                    "type": "string"
                  },
                  "opacity": {
                    "type": "number"
                  }
                },
                "additionalProperties": false
              }
            },
            "strokes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "color": {
                    "type": "string"
                  },
                  "width": {
                    "type": "number"
                  }
                },
                "additionalProperties": false
              }
            },
            "effects": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string"
                  },
                  "offset": {
                    "type": "object",
                    "properties": {
                      "x": {
                        "type": "number"
                      },
                      "y": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "x",
                      "y"
                    ],
                    "additionalProperties": false
                  },
                  "blur": {
                    "type": "number"
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            }
          },
          "additionalProperties": false,
          "description": "Visual properties from code (colors, borders, effects)"
        },
        "spacing": {
          "type": "object",
          "properties": {
            "paddingTop": {
              "type": "number"
            },
            "paddingRight": {
              "type": "number"
            },
            "paddingBottom": {
              "type": "number"
            },
            "paddingLeft": {
              "type": "number"
            },
            "gap": {
              "type": "number"
            },
            "width": {
              "type": [
                "number",
                "string"
              ]
            },
            "height": {
              "type": [
                "number",
                "string"
              ]
            },
            "minWidth": {
              "type": "number"
            },
            "minHeight": {
              "type": "number"
            },
            "maxWidth": {
              "type": "number"
            },
            "maxHeight": {
              "type": "number"
            },
            "layoutDirection": {
              "type": "string",
              "enum": [
                "horizontal",
                "vertical"
              ]
            }
          },
          "additionalProperties": false,
          "description": "Spacing and layout properties from code"
        },
        "typography": {
          "type": "object",
          "properties": {
            "fontFamily": {
              "type": "string"
            },
            "fontSize": {
              "type": "number"
            },
            "fontWeight": {
              "type": [
                "number",
                "string"
              ]
            },
            "lineHeight": {
              "type": [
                "number",
                "string"
              ]
            },
            "letterSpacing": {
              "type": "number"
            },
            "textAlign": {
              "type": "string"
            },
            "textDecoration": {
              "type": "string"
            },
            "textTransform": {
              "type": "string"
            }
          },
          "additionalProperties": false,
          "description": "Typography properties from code"
        },
        "tokens": {
          "type": "object",
          "properties": {
            "usedTokens": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "hardcodedValues": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "property": {
                    "type": "string"
                  },
                  "value": {
                    "type": [
                      "string",
                      "number"
                    ]
                  }
                },
                "required": [
                  "property",
                  "value"
                ],
                "additionalProperties": false
              }
            },
            "tokenPrefix": {
              "type": "string"
            }
          },
          "additionalProperties": false,
          "description": "Design token usage in code"
        },
        "componentAPI": {
          "type": "object",
          "properties": {
            "props": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "defaultValue": {
                    "type": [
                      "string",
                      "number",
                      "boolean"
                    ]
                  },
                  "description": {
                    "type": "string"
                  },
                  "values": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "name",
                  "type"
                ],
                "additionalProperties": false
              }
            },
            "events": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "slots": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false,
          "description": "Component API (props, events, slots)"
        },
        "accessibility": {
          "type": "object",
          "properties": {
            "role": {
              "type": "string"
            },
            "ariaLabel": {
              "type": "string"
            },
            "ariaRequired": {
              "type": "boolean"
            },
            "keyboardInteractions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "contrastRatio": {
              "type": "number"
            },
            "focusVisible": {
              "type": "boolean"
            },
            "semanticElement": {
              "type": "string",
              "description": "Semantic HTML element (e.g., 'button', 'a', 'input')"
            },
            "supportsDisabled": {
              "type": "boolean",
              "description": "Whether code supports disabled/aria-disabled state"
            },
            "supportsError": {
              "type": "boolean",
              "description": "Whether code supports aria-invalid/error state"
            },
            "renderedSize": {
              "type": "array",
              "items": {
                "type": "number"
              },
              "minItems": 2,
              "maxItems": 2,
              "description": "Rendered size [width, height] in px"
            }
          },
          "additionalProperties": false,
          "description": "Accessibility properties from code. Tip: use figma_scan_code_accessibility with mapToCodeSpec:true to auto-generate this from component HTML."
        },
        "metadata": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "description": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "version": {
              "type": "string"
            },
            "tags": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false,
          "description": "Component metadata from code"
        }
      },
      "additionalProperties": false,
      "description": "Structured code-side component data. Read the component source code first, then fill in the relevant sections."
    },
    "canonicalSource": {
      "type": "string",
      "enum": [
        "design",
        "code"
      ],
      "default": "design",
      "description": "Which source is the canonical truth. Fixes will target the other side. Default: 'design'"
    },
    "enrich": {
      "type": "boolean",
      "default": true,
      "description": "Enable token coverage and enrichment analysis. Default: true"
    }
  },
  "required": [
    "nodeId",
    "codeSpec"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to clone"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "parentId": {
      "type": "string",
      "description": "The parent node ID"
    },
    "nodeType": {
      "type": "string",
      "enum": [
        "RECTANGLE",
        "ELLIPSE",
        "FRAME",
        "TEXT",
        "LINE"
      ],
      "description": "Type of node to create"
    },
    "properties": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name for the new node"
        },
        "x": {
          "type": "number",
          "description": "X position within parent"
        },
        "y": {
          "type": "number",
          "description": "Y position within parent"
        },
        "width": {
          "type": "number",
          "description": "Width (default: 100)"
        },
        "height": {
          "type": "number",
          "description": "Height (default: 100)"
        },
        "fills": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "SOLID"
              },
              "color": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "color"
            ],
            "additionalProperties": false
          },
          "description": "Fill colors (hex strings)"
        },
        "text": {
          "type": "string",
          "description": "Text content (for TEXT nodes only)"
        }
      },
      "additionalProperties": false,
      "description": "Properties for the new node"
    }
  },
  "required": [
    "parentId",
    "nodeType"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "baseComponentId": {
      "type": "string",
      "description": "Node ID of an existing COMPONENT to use as the base. Cloned per property combination; becomes the set's first variant (keeps its node ID, so placed instances survive). Mutually exclusive with componentIds."
    },
    "properties": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "description": "Variant property axes — required with baseComponentId. Example: { State: ['default','hover','disabled'], Size: ['sm','lg'] } creates 6 variants. Max 100 combinations. Names and values must not contain '=' or ','."
    },
    "componentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Node IDs of existing COMPONENT nodes to combine as variants. Mutually exclusive with baseComponentId. Components already inside a component set are rejected."
    },
    "variantProperties": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "description": "Only with componentIds: one property map per component, aligned by index — e.g. [{ State: 'default' }, { State: 'hover' }]. Each component is renamed to 'Prop=Value, ...' before combining. Without this, existing names are kept (names lacking '=' become 'Property 1=<name>')."
    },
    "name": {
      "type": "string",
      "description": "Name for the component set (e.g., 'Button'). Defaults to Figma's derived name."
    },
    "parentId": {
      "type": "string",
      "description": "Node ID of the container (frame/section) to create the set in. Defaults to the current page."
    },
    "position": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y"
      ],
      "additionalProperties": false,
      "description": "Position of the set within its parent."
    },
    "autoArrange": {
      "type": "boolean",
      "default": false,
      "description": "If true, arrange the new set in a labeled grid (columns = last property, rows = other properties) inside a white container — same in-place layout as figma_arrange_component_set."
    },
    "arrangeOptions": {
      "type": "object",
      "properties": {
        "gap": {
          "type": "number",
          "description": "Gap between grid cells in pixels (default: 24)"
        },
        "cellPadding": {
          "type": "number",
          "description": "Padding inside each cell around the variant (default: 20)"
        },
        "columnProperty": {
          "type": "string",
          "description": "Property to use for columns (default: last property)"
        }
      },
      "additionalProperties": false,
      "description": "Grid layout options, used when autoArrange is true."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "row": {
      "type": "integer",
      "minimum": 0,
      "description": "Row index in the slide grid (0-based)"
    },
    "col": {
      "type": "integer",
      "minimum": 0,
      "description": "Column index in the slide grid (0-based)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The COMPONENT node ID to add a slot to"
    },
    "name": {
      "type": "string",
      "description": "Slot layer name (e.g. 'Content', 'Footer')"
    },
    "width": {
      "type": "number",
      "description": "Initial slot width in pixels"
    },
    "height": {
      "type": "number",
      "description": "Initial slot height in pixels"
    },
    "layoutMode": {
      "type": "string",
      "enum": [
        "NONE",
        "HORIZONTAL",
        "VERTICAL"
      ],
      "description": "Auto-layout mode for the slot (GRID is not supported)"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the new variable (e.g., 'primary-blue')"
    },
    "collectionId": {
      "type": "string",
      "description": "The collection ID to create the variable in (e.g., 'VariableCollectionId:123:456'). Get this from figma_get_variables."
    },
    "resolvedType": {
      "type": "string",
      "enum": [
        "COLOR",
        "FLOAT",
        "STRING",
        "BOOLEAN"
      ],
      "description": "The variable type: COLOR, FLOAT, STRING, or BOOLEAN"
    },
    "description": {
      "type": "string",
      "description": "Optional description for the variable"
    },
    "valuesByMode": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Optional initial values by mode ID. Example: { '1:0': '#FF0000', '1:1': '#0000FF' }"
    }
  },
  "required": [
    "name",
    "collectionId",
    "resolvedType"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the new collection (e.g., 'Brand Colors')"
    },
    "initialModeName": {
      "type": "string",
      "description": "Name for the initial mode (default mode is created automatically). Example: 'Light'"
    },
    "additionalModes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Additional mode names to create. Example: ['Dark', 'High Contrast']"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "comment_id": {
      "type": "string",
      "description": "The ID of the comment to delete. Get IDs from figma_get_comments."
    }
  },
  "required": [
    "comment_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The component or component set node ID"
    },
    "propertyName": {
      "type": "string",
      "description": "The full property name with suffix (e.g., 'Show Icon#123:456')"
    }
  },
  "required": [
    "nodeId",
    "propertyName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to delete"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide to delete"
    }
  },
  "required": [
    "slideId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "variableId": {
      "type": "string",
      "description": "The variable ID to delete (e.g., 'VariableID:123:456'). Get this from figma_get_variables."
    }
  },
  "required": [
    "variableId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "description": "The collection ID to delete (e.g., 'VariableCollectionId:123:456'). Get this from figma_get_variables."
    }
  },
  "required": [
    "collectionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "Include the raw structured state alongside the human-readable report."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "from_version": {
      "type": "string",
      "description": "The earlier version_id to compare from. Get from figma_get_file_versions."
    },
    "to_version": {
      "type": "string",
      "description": "The later version_id to compare to. Use 'current' for HEAD."
    },
    "component_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Node IDs (typically COMPONENT_SETs) to diff in detail. If omitted, falls back to the current Figma selection. If neither is available, only the page-structure diff is returned. Use figma_get_design_system_kit or figma_search_components to discover IDs explicitly."
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "detailed"
      ],
      "default": "standard",
      "description": "Output verbosity. summary=counts only, standard=names+counts (default), detailed=full property/binding details."
    }
  },
  "required": [
    "from_version",
    "to_version"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "targets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "App root directories to analyze. Absolute paths strongly recommended (the MCP server's working directory is not the project). Multiple targets = cross-app extraction: the inventory merges and duplicate components across apps are flagged."
    },
    "outDir": {
      "type": "string",
      "description": "Directory where the design-system package will be generated (manifests persist under <outDir>/.extraction/). Default: '<first target>/design-system'."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Substring filters on relative paths — when set, only matching files are scanned (e.g. ['src/', 'app/'])."
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Substring filters on relative paths to skip (node_modules, dist, .next etc. are always skipped)."
    },
    "maxFiles": {
      "type": "number",
      "minimum": 100,
      "maximum": 20000,
      "default": 5000,
      "description": "Hard cap on files scanned per target (default 5000)."
    }
  },
  "required": [
    "targets"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The outDir used in figma_ds_analyze (manifest is read from it)."
    },
    "component": {
      "type": "string",
      "description": "Component name from the inventory (see figma_ds_analyze topByUsage, or the analysis manifest for the full list)."
    }
  },
  "required": [
    "outDir",
    "component"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The outDir used in figma_ds_analyze (reads .extraction/analysis.json from it). Default: '<first target of the analysis run>/design-system' — pass explicitly when in doubt."
    },
    "targets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Override: scan these app roots instead of the analysis manifest's targets (rarely needed)."
    },
    "formats": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dtcg",
          "css-vars",
          "tailwind-v4",
          "tailwind-v3",
          "scss",
          "ts-module",
          "json-nested",
          "json-flat",
          "tokens-studio",
          "style-dictionary-v3"
        ]
      },
      "default": [
        "dtcg",
        "css-vars"
      ],
      "description": "Token file formats to write under <outDir>/tokens/. 'dtcg' (canonical) is always written. Match the app's styling method — e.g. add 'tailwind-v4' for a Tailwind app, 'scss' for SCSS."
    },
    "dtcgDialect": {
      "type": "string",
      "enum": [
        "legacy",
        "2025"
      ],
      "default": "legacy",
      "description": "DTCG dialect: 'legacy' hex-string colors (max compatibility) or '2025' DTCG 2025.10 object colors/dimensions."
    },
    "minFrequency": {
      "type": "number",
      "minimum": 2,
      "maximum": 100,
      "default": 4,
      "description": "How often a raw (undeclared) value must recur to be promoted to a token (default 4). Values below the threshold are listed in the report for review."
    },
    "write": {
      "type": "boolean",
      "default": true,
      "description": "Write token files to <outDir>/tokens/ (default true). False returns the DTCG document inline instead (dry run)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The outDir used in figma_ds_analyze / figma_ds_extract_tokens."
    },
    "packageName": {
      "type": "string",
      "description": "npm package name for the design system (e.g. '@acme/design-system'). Default: '@extracted/design-system'."
    },
    "framework": {
      "type": "string",
      "enum": [
        "react",
        "next",
        "astro",
        "angular",
        "web-components",
        "vue",
        "svelte"
      ],
      "description": "Override the scaffold framework. Default: the first framework detected by figma_ds_analyze. Note: Storybook has no .astro renderer — 'astro' scaffolds a react-vite workshop whose stories mirror the component markup."
    },
    "formats": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dtcg",
          "css-vars",
          "tailwind-v4",
          "tailwind-v3",
          "scss",
          "ts-module",
          "json-nested",
          "json-flat",
          "tokens-studio",
          "style-dictionary-v3"
        ]
      },
      "default": [
        "dtcg",
        "css-vars"
      ],
      "description": "Token formats to (re)generate under tokens/."
    },
    "dtcgDialect": {
      "type": "string",
      "enum": [
        "legacy",
        "2025"
      ],
      "default": "legacy",
      "description": "DTCG dialect for dtcg/json outputs."
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Overwrite existing scaffold files (token files always refresh)."
    }
  },
  "required": [
    "outDir"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The design-system package dir (same outDir as figma_ds_analyze) containing the freshly-initialized .storybook/."
    }
  },
  "required": [
    "outDir"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The outDir used in figma_ds_analyze."
    },
    "update": {
      "type": "object",
      "properties": {
        "component": {
          "type": "string",
          "description": "Component name from the inventory."
        },
        "status": {
          "type": "string",
          "enum": [
            "pending",
            "in-progress",
            "ported",
            "skipped"
          ],
          "description": "New porting status."
        },
        "notes": {
          "type": "string",
          "description": "Why skipped / consolidation decisions / gotchas."
        },
        "storyFile": {
          "type": "string",
          "description": "Relative path of the story file, once written."
        }
      },
      "required": [
        "component",
        "status"
      ],
      "additionalProperties": false,
      "description": "Status update to record. Omit to just read progress."
    }
  },
  "required": [
    "outDir"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "outDir": {
      "type": "string",
      "description": "The design-system package dir (same outDir as figma_ds_analyze)."
    }
  },
  "required": [
    "outDir"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide to duplicate"
    }
  },
  "required": [
    "slideId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The component or component set node ID"
    },
    "propertyName": {
      "type": "string",
      "description": "The full property name with suffix (e.g., 'Show Icon#123:456')"
    },
    "newValue": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "New name for the property"
        },
        "defaultValue": {
          "type": [
            "string",
            "number",
            "boolean"
          ],
          "description": "New default value"
        },
        "preferredValues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "COMPONENT",
                  "COMPONENT_SET"
                ],
                "description": "Type of preferred value"
              },
              "key": {
                "type": "string",
                "description": "Component or component set key"
              }
            },
            "required": [
              "type",
              "key"
            ],
            "additionalProperties": false
          },
          "description": "Preferred values (INSTANCE_SWAP only)"
        }
      },
      "additionalProperties": false,
      "description": "Object with the values to update"
    }
  },
  "required": [
    "nodeId",
    "propertyName",
    "newValue"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "JavaScript code to execute. Has access to the 'figma' global object. Example: 'const rect = figma.createRectangle(); rect.resize(100, 100); return { id: rect.id };'"
    },
    "timeout": {
      "type": "number",
      "default": 5000,
      "description": "Execution timeout in milliseconds (default: 5000, max: 30000)"
    },
    "fileKey": {
      "type": "string",
      "description": "Local Mode only. Run against this specific connected file instead of the active file. Does not change the active file or target lock. Get connected fileKeys from figma_list_open_files. Rejected in Cloud Mode, which pairs with a single plugin instance."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "JavaScript code to execute in each targeted file. Has access to the 'figma' global object, same as figma_execute. Example: 'return { pageCount: figma.root.children.length };'"
    },
    "fileKeys": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which connected files to target, by fileKey. Get fileKeys from figma_list_open_files. Required unless allFiles is true."
    },
    "allFiles": {
      "type": "boolean",
      "default": false,
      "description": "Run against EVERY currently connected file. Opt-in on purpose: this executes the code in files the user may be actively working in, including any file pinned by target lock. Prefer naming fileKeys explicitly for anything that writes."
    },
    "timeout": {
      "type": "number",
      "default": 10000,
      "description": "Per-file execution timeout in milliseconds (default: 10000, max: 30000). Applies independently to each file — one slow/unresponsive file does not delay the others."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "file",
        "collection"
      ],
      "description": "Whether to export the entire file's variables ('file', default) or just specific collections via collectionIds."
    },
    "collectionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific Figma collection IDs to export. Required when scope is 'collection'. Use figma_get_variables to enumerate available collections."
    },
    "modes": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "string",
          "const": "all"
        }
      ],
      "description": "Modes to include in the output. 'all' (default) exports every mode in every collection. Pass an array like ['Light', 'Dark'] to filter."
    },
    "format": {
      "type": "string",
      "enum": [
        "dtcg",
        "tokens-studio",
        "css-vars",
        "tailwind-v4",
        "tailwind-v3",
        "scss",
        "less",
        "ts-module",
        "json-flat",
        "json-nested",
        "style-dictionary-v3"
      ],
      "description": "Specific output format to emit. When omitted, formats come from tokens.config.json's generated.formats list. Common starting choices: 'dtcg' for the canonical JSON, 'css-vars' for runtime CSS custom properties, 'tailwind-v4' for Tailwind v4 @theme blocks."
    },
    "outputPath": {
      "type": "string",
      "description": "Filesystem path to write the output file(s) to. Relative paths resolve against the project root (the directory containing tokens.config.json) or cwd if no config. When omitted, the output is returned inline in the response (suitable for the AI to inspect or write via its own file tools)."
    },
    "configPath": {
      "type": "string",
      "description": "Explicit path to a tokens.config.json file. When omitted, the tool walks up from cwd looking for one — typical case is zero-arg."
    },
    "strategy": {
      "type": "string",
      "enum": [
        "merge",
        "replace",
        "dry-run"
      ],
      "description": "How to handle existing output files. 'merge' (default) diffs against current contents and writes only changed tokens, preserving code-only additions. 'replace' wipes and rewrites. 'dry-run' computes the diff and reports what would change without writing."
    },
    "prefix": {
      "type": "string",
      "description": "Prefix prepended to every output token name (e.g. 'ds-', 'al-'). Only affects formatters that emit named tokens — DTCG and JSON outputs use unmodified paths."
    },
    "resolveAliases": {
      "type": "boolean",
      "description": "If true, alias references are resolved to literal values in the output. Default is false for JSON formats (preserves alias semantics) and true for CSS/SCSS/Tailwind/etc. (which can't natively express aliases)."
    },
    "splitByMode": {
      "type": "boolean",
      "description": "Emit one file per mode (e.g. tokens-light.css, tokens-dark.css). Default false (single file with all modes)."
    },
    "splitByCollection": {
      "type": "boolean",
      "description": "Emit one file per Figma collection. Default false. Useful when collections map to different runtime themes."
    },
    "dtcgDialect": {
      "type": "string",
      "enum": [
        "legacy",
        "2025"
      ],
      "description": "DTCG dialect for dtcg/json-flat/json-nested outputs. legacy (default): hex-string colors, maximum compatibility (Style Dictionary v4, Tokens Studio). 2025: DTCG 2025.10 object colors/dimensions (Style Dictionary v5+). Other formats (css-vars, scss, tailwind, ts-module) render final code and ignore this option."
    },
    "colorFormat": {
      "type": "string",
      "enum": [
        "hex",
        "hex8",
        "rgba",
        "oklch",
        "hsl"
      ],
      "description": "Color value format in the output. Default: 'hex'. Use 'oklch' for modern Tailwind v4 charts."
    },
    "sizeUnit": {
      "type": "string",
      "enum": [
        "px",
        "rem",
        "pt",
        "dp"
      ],
      "description": "Unit for dimension tokens. Default: 'rem' for web outputs, 'pt' for iOS, 'dp' for Android."
    },
    "remBase": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Base font size in pixels for px→rem conversion. Default: 16."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide to focus"
    }
  },
  "required": [
    "slideId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "from_version": {
      "type": "string",
      "description": "The earlier version_id. Get from figma_get_file_versions."
    },
    "to_version": {
      "type": "string",
      "description": "The later version_id. Use 'current' for HEAD."
    },
    "component_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Node IDs to include in the per-component changelog section. If omitted, falls back to the current Figma selection."
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "detailed"
      ],
      "default": "standard",
      "description": "Output verbosity. summary=one-liner, standard=sectioned with counts (default), detailed=full per-property/per-binding bullets."
    }
  },
  "required": [
    "from_version",
    "to_version"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "nodeId": {
      "type": "string",
      "description": "Component node ID (e.g., '695:313')"
    },
    "codeInfo": {
      "type": "object",
      "properties": {
        "props": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "defaultValue": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "type"
            ],
            "additionalProperties": false
          },
          "description": "Component props"
        },
        "events": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "payload": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "description": "Events emitted by the component"
        },
        "slots": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "description": "Named slots"
        },
        "importStatement": {
          "type": "string",
          "description": "Import statement for the component"
        },
        "usageExamples": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "language": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "code"
            ],
            "additionalProperties": false
          },
          "description": "Usage examples"
        },
        "changelog": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "version": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "changes": {
                "type": "string"
              }
            },
            "required": [
              "version",
              "date",
              "changes"
            ],
            "additionalProperties": false
          },
          "description": "Changelog entries"
        },
        "filePath": {
          "type": "string",
          "description": "Component file path"
        },
        "packageName": {
          "type": "string",
          "description": "Package name"
        },
        "variantDefinition": {
          "type": "string",
          "description": "CVA or variant definition code block"
        },
        "subComponents": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "element": {
                "type": "string",
                "description": "HTML element rendered (e.g., 'div', 'span')"
              },
              "dataSlot": {
                "type": "string",
                "description": "data-slot attribute value"
              },
              "props": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "required": {
                      "type": "boolean"
                    },
                    "defaultValue": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "type"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "description": "Sub-components that compose this component (e.g., AlertTitle, AlertDescription)"
        },
        "sourceFiles": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "role": {
                "type": "string"
              },
              "variants": {
                "type": "number"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "role"
            ],
            "additionalProperties": false
          },
          "description": "All source files related to this component"
        },
        "baseComponent": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "description": {
              "type": "string"
            }
          },
          "required": [
            "name"
          ],
          "additionalProperties": false,
          "description": "Base component this extends (e.g., shadcn/ui Alert)"
        }
      },
      "additionalProperties": false,
      "description": "Code-side documentation info. Read the component source code first, then fill in relevant sections. Include variantDefinition for CVA/variant code, subComponents for composable sub-parts, sourceFiles for all related files, and baseComponent for attribution."
    },
    "sections": {
      "type": "object",
      "properties": {
        "overview": {
          "type": "boolean",
          "default": true
        },
        "anatomy": {
          "type": "boolean",
          "default": true
        },
        "statesAndVariants": {
          "type": "boolean",
          "default": true
        },
        "visualSpecs": {
          "type": "boolean",
          "default": true
        },
        "typography": {
          "type": "boolean",
          "default": true
        },
        "contentGuidelines": {
          "type": "boolean",
          "default": true
        },
        "behavior": {
          "type": "boolean",
          "default": false
        },
        "implementation": {
          "type": "boolean",
          "default": true
        },
        "accessibility": {
          "type": "boolean",
          "default": true
        },
        "designAnnotations": {
          "type": "boolean",
          "default": true
        },
        "relatedComponents": {
          "type": "boolean",
          "default": false
        },
        "changelog": {
          "type": "boolean",
          "default": true
        },
        "parity": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false,
      "description": "Toggle which sections to include"
    },
    "outputPath": {
      "type": "string",
      "description": "Suggested output file path"
    },
    "systemName": {
      "type": "string",
      "description": "Design system name for headers"
    },
    "enrich": {
      "type": "boolean",
      "default": true,
      "description": "Enable enrichment for token data"
    },
    "includeFrontmatter": {
      "type": "boolean",
      "default": true,
      "description": "Include YAML frontmatter metadata"
    },
    "history": {
      "type": "object",
      "properties": {
        "figma": {
          "type": "boolean",
          "default": false,
          "description": "Pull design history from Figma version history, scoped to this component. Costs roughly one API call per version walked."
        },
        "git": {
          "type": "boolean",
          "default": false,
          "description": "Pull code history via `git log` for the component's source files. Local mode only."
        },
        "versions": {
          "type": "integer",
          "minimum": 1,
          "maximum": 20,
          "default": 5,
          "description": "How many Figma versions to walk back. Default 5, max 20."
        },
        "includeAutosaves": {
          "type": "boolean",
          "default": false,
          "description": "Include unlabeled Figma auto-saves. Default false — autosaves are noisy and often unattributed."
        },
        "mode": {
          "type": "string",
          "enum": [
            "summary",
            "standard",
            "detailed"
          ],
          "default": "standard",
          "description": "Design-history verbosity. detailed names individual properties and variable bindings."
        },
        "gitLimit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 50,
          "default": 10,
          "description": "How many commits to list. Default 10, max 50."
        },
        "gitPaths": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Explicit paths to log commits for. Defaults to codeInfo.filePath plus codeInfo.sourceFiles[].path."
        },
        "repoPath": {
          "type": "string",
          "description": "Repo directory to run git in. Defaults to the server's working directory."
        }
      },
      "additionalProperties": false,
      "description": "Pull an ongoing changelog from Figma version history and/or git. When enabled, replaces the manual '## Changelog' section with a richer '## History' section. Both sources are off by default so existing callers are unaffected."
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Node ID to read annotations from (e.g., '695:313')"
    },
    "include_children": {
      "type": "boolean",
      "default": false,
      "description": "Also read annotations from child nodes. Useful for getting all annotations within a component tree."
    },
    "depth": {
      "type": "number",
      "default": 1,
      "description": "How many levels deep to traverse when include_children is true (default: 1, max recommended: 5)"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "since_version": {
      "type": "string",
      "description": "The version_id to compare against the current HEAD."
    },
    "component_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Node IDs to diff in detail. If omitted, falls back to the current Figma selection. Same semantics as figma_diff_versions otherwise."
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "detailed"
      ],
      "default": "standard"
    }
  },
  "required": [
    "since_version"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "as_md": {
      "type": "boolean",
      "default": false,
      "description": "Return comment message bodies as markdown. Default: false"
    },
    "include_resolved": {
      "type": "boolean",
      "default": false,
      "description": "Include resolved (completed) comment threads. Default: false (only active comments)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). Auto-detected from WebSocket Desktop Bridge connection. Only required if not connected."
    },
    "nodeId": {
      "type": "string",
      "description": "Component node ID (e.g., '123:456')"
    },
    "format": {
      "type": "string",
      "enum": [
        "metadata",
        "reconstruction"
      ],
      "default": "metadata",
      "description": "Export format: 'metadata' (default) for comprehensive documentation, 'reconstruction' for node tree specification compatible with Figma Component Reconstructor plugin"
    },
    "enrich": {
      "type": "boolean",
      "description": "Set to true when user asks for: design token coverage, hardcoded value analysis, or component quality metrics. Adds token coverage analysis and hardcoded value detection. Default: false. Only applicable for metadata format."
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "componentKey": {
      "type": "string",
      "description": "The component key (preferred for exact match)"
    },
    "componentName": {
      "type": "string",
      "description": "The component name (used if key not provided)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). REQUIRED unless figma_navigate was already called."
    },
    "nodeId": {
      "type": "string",
      "description": "Component node ID to get data for (e.g., '695:313')"
    },
    "includeImage": {
      "type": "boolean",
      "default": true,
      "description": "Include rendered image for visual reference (default: true)"
    },
    "codebasePath": {
      "type": "string",
      "description": "Path to target codebase components directory (e.g., '/Users/me/project/src/components'). When provided, scans for existing components and includes a registry in the response to prevent recreating components that already exist. Strongly recommended for design-to-code workflows."
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Component node ID to extract (e.g., '695:313')"
    },
    "depth": {
      "type": "number",
      "default": 10,
      "description": "Maximum tree depth to traverse (default: 10, max: 20). Use higher values for deeply nested components."
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). Auto-detected from WebSocket Desktop Bridge connection. Only required if not connected."
    },
    "nodeId": {
      "type": "string",
      "description": "Component node ID to render as image (e.g., '695:313')"
    },
    "scale": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 4,
      "default": 2,
      "description": "Image scale factor (0.01-4, default: 2 for high quality)"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "jpg",
        "svg",
        "pdf"
      ],
      "default": "png",
      "description": "Image format (default: png)"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "default": 100,
      "description": "Number of recent logs to retrieve"
    },
    "level": {
      "type": "string",
      "enum": [
        "log",
        "info",
        "warn",
        "error",
        "debug",
        "all"
      ],
      "default": "all",
      "description": "Filter by log level"
    },
    "since": {
      "type": "number",
      "description": "Only logs after this timestamp (Unix ms)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "since": {
      "type": "number",
      "description": "Only return changes after this Unix timestamp (ms). Useful for incremental polling."
    },
    "count": {
      "type": "number",
      "description": "Maximum number of change events to return (chronological order, oldest to newest; returns the last N events)"
    },
    "clear": {
      "type": "boolean",
      "default": false,
      "description": "Clear the change buffer after reading. Set to true for polling workflows."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileKey": {
      "type": "string",
      "description": "Figma file key. If omitted, extracted from the current browser URL."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "tokens",
          "components",
          "styles"
        ]
      },
      "default": [
        "tokens",
        "components",
        "styles"
      ],
      "description": "Which sections to include. Defaults to all."
    },
    "componentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of specific component node IDs to include. If omitted, all published components are returned."
    },
    "includeImages": {
      "type": "boolean",
      "default": false,
      "description": "Include image URLs for components (adds latency). Default false."
    },
    "format": {
      "type": "string",
      "enum": [
        "full",
        "summary",
        "compact"
      ],
      "default": "full",
      "description": "'full' returns complete data with visual specs and resolved values. 'summary' strips variant-level visual specs (medium payload). 'compact' returns only names, types, and property definitions (smallest payload, best for large design systems). Auto-compresses if response exceeds safe size regardless of format setting."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "forceRefresh": {
      "type": "boolean",
      "default": false,
      "description": "Force refresh the cached data (use sparingly - extraction can take minutes for large files)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "version_id": {
      "type": "string",
      "description": "The version ID to snapshot (from figma_get_file_versions)."
    },
    "node_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: snapshot only these node IDs instead of the full file. Reduces payload significantly for targeted inspection."
    },
    "depth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How deep into the document tree to recurse. Lower is cheaper. Default: full depth (no limit)."
    }
  },
  "required": [
    "version_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). Auto-detected from WebSocket Desktop Bridge connection. Only required if not connected."
    },
    "depth": {
      "type": "number",
      "minimum": 0,
      "maximum": 3,
      "default": 1,
      "description": "How many levels of children to include (default: 1, max: 3). Start with 1 to prevent context exhaustion. Use 0 for full tree only when absolutely necessary."
    },
    "verbosity": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ],
      "default": "summary",
      "description": "Controls payload size: 'summary' (IDs/names/types only, ~90% smaller - RECOMMENDED), 'standard' (essential properties, ~50% smaller), 'full' (everything). Default: summary for token efficiency."
    },
    "nodeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific node IDs to retrieve (optional)"
    },
    "enrich": {
      "type": "boolean",
      "description": "Set to true when user asks for: file statistics, health metrics, design system audit, or quality analysis. Adds statistics, health scores, and audit summaries. Default: false"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). REQUIRED unless figma_navigate was already called."
    },
    "depth": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "default": 2,
      "description": "How many levels of children to include (default: 2, max: 5). Higher depths are safe here due to filtering."
    },
    "nodeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific node IDs to retrieve (optional)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "include_autosaves": {
      "type": "boolean",
      "default": false,
      "description": "Include auto-saved versions (those without a label). Default: false."
    },
    "max_versions": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Hard cap on returned versions. Default 50, max 200."
    },
    "cursor": {
      "type": "string",
      "description": "Version ID returned as pagination.next_cursor on a previous call. Pass to continue from where the last call stopped."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "componentKey": {
      "type": "string",
      "minLength": 1,
      "description": "The component key (40-char hex string from search results, e.g., '806826503bbd2ab15d0ff77d076a9406a5a83197'). Works for both COMPONENT_SET and standalone COMPONENT keys."
    },
    "includeVisualSpecs": {
      "type": "boolean",
      "default": true,
      "description": "Include per-variant visual specs (fills, strokes, padding, typography). Default true. Auto-stripped if response exceeds 500KB."
    },
    "format": {
      "type": "string",
      "enum": [
        "full",
        "summary"
      ],
      "default": "full",
      "description": "'full' returns properties + variants + visual specs. 'summary' returns properties + variant names only (no visualSpec). Auto-downgrades to 'summary' on large responses."
    }
  },
  "required": [
    "componentKey"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "libraryFileUrl": {
      "type": "string",
      "description": "The URL of the library file (e.g., https://www.figma.com/design/abc123/My-Design-System). Either this or libraryFileKey is required."
    },
    "libraryFileKey": {
      "type": "string",
      "description": "The file key of the library file (e.g., 'abc123'). Either this or libraryFileUrl is required."
    },
    "query": {
      "type": "string",
      "description": "Search query to filter components by name (e.g., 'Button', 'Card'). Leave empty to get all components."
    },
    "limit": {
      "type": "number",
      "default": 25,
      "description": "Maximum results to return (default: 25, max: 100)"
    },
    "offset": {
      "type": "number",
      "default": 0,
      "description": "Offset for pagination"
    },
    "includeVariants": {
      "type": "boolean",
      "default": false,
      "description": "Include individual variant components (default: false, only returns component sets)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "libraryName": {
      "type": "string",
      "description": "Optional: filter by library name (case-insensitive substring match). E.g., 'Northright' or 'Altitude'."
    },
    "collectionName": {
      "type": "string",
      "description": "Optional: filter by collection name within a library (case-insensitive substring match). E.g., 'Colors' or 'Spacing'."
    },
    "resolvedType": {
      "type": "string",
      "enum": [
        "COLOR",
        "FLOAT",
        "STRING",
        "BOOLEAN"
      ],
      "description": "Optional: filter by variable type. Useful when you only need color tokens or only spacing values."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "If true, fetches additional details (fills, strokes, styles) for each selected node via figma_execute"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide, e.g. '1:23'"
    }
  },
  "required": [
    "slideId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    }
  },
  "required": [
    "slideId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "COMPONENT, COMPONENT_SET, or INSTANCE node ID"
    }
  },
  "required": [
    "nodeId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "probe": {
      "type": "boolean",
      "description": "When true, sends a live roundtrip command to the plugin to verify the connection is actually responsive (not just TCP-open). Returns probeResult with success/latency. Recommended for health checks."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). Auto-detected from WebSocket Desktop Bridge connection. Only required if not connected."
    },
    "verbosity": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ],
      "default": "standard",
      "description": "Controls payload size: 'summary' (names/types only, ~85% smaller), 'standard' (essential properties, ~40% smaller), 'full' (everything). Default: standard"
    },
    "enrich": {
      "type": "boolean",
      "description": "Set to true when user asks for: CSS/Sass/Tailwind code, export formats, usage information, code examples, or design system exports. Adds resolved values, usage analysis, and export format examples. Default: false for backward compatibility"
    },
    "include_usage": {
      "type": "boolean",
      "description": "Include component usage information (requires enrich=true)"
    },
    "include_exports": {
      "type": "boolean",
      "description": "Include export format examples (requires enrich=true)"
    },
    "export_formats": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "css",
          "sass",
          "tailwind",
          "typescript",
          "json"
        ]
      },
      "description": "Which code formats to generate examples for. Use when user mentions specific formats like 'CSS', 'Tailwind', 'SCSS', 'TypeScript', etc. Automatically enables enrichment. Default: all formats"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "colors",
        "spacing",
        "all"
      ],
      "default": "all",
      "description": "Type of tokens to retrieve"
    },
    "filter": {
      "type": "string",
      "description": "Filter token names (e.g., 'primary' to get all primary colors)"
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Maximum tokens to return (default: 50)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL (e.g., https://figma.com/design/abc123). Auto-detected from WebSocket Desktop Bridge connection. Only required if not connected."
    },
    "includePublished": {
      "type": "boolean",
      "default": true,
      "description": "Include published variables from libraries"
    },
    "verbosity": {
      "type": "string",
      "enum": [
        "inventory",
        "summary",
        "standard",
        "full"
      ],
      "default": "standard",
      "description": "Controls payload size: 'inventory' (names/IDs only, ~95% smaller, use with filtered), 'summary' (names/values only, ~80% smaller), 'standard' (essential properties, ~45% smaller), 'full' (everything). Default: standard"
    },
    "enrich": {
      "type": "boolean",
      "description": "Set to true when user asks for: CSS/Sass/Tailwind exports, code examples, design tokens, usage information, dependencies, or any export format. Adds resolved values, dependency graphs, and usage analysis. Default: false"
    },
    "include_usage": {
      "type": "boolean",
      "description": "Include usage in styles and components (requires enrich=true)"
    },
    "include_dependencies": {
      "type": "boolean",
      "description": "Include variable dependency graph (requires enrich=true)"
    },
    "include_exports": {
      "type": "boolean",
      "description": "Include export format examples (requires enrich=true)"
    },
    "export_formats": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "css",
          "sass",
          "tailwind",
          "typescript",
          "json"
        ]
      },
      "description": "Which code formats to generate examples for. Use when user mentions specific formats like 'CSS', 'Tailwind', 'SCSS', 'TypeScript', etc. Automatically enables enrichment."
    },
    "format": {
      "type": "string",
      "enum": [
        "summary",
        "filtered",
        "full"
      ],
      "description": "Response format: 'summary' (~2K tokens with overview and names only), 'filtered' (apply collection/name/mode filters), 'full' (complete dataset from cache or fetch). Default: summary (token-efficient). When format is omitted, filter params (collection/namePattern/mode) auto-select 'filtered', and enrichment/export/resolveAliases/returnAsLinks params auto-select 'full'. Full format returns all data but may be auto-summarized if >25K tokens."
    },
    "collection": {
      "type": "string",
      "description": "Filter variables by collection name or ID. Case-insensitive substring match. Only applies when format='filtered'. Example: 'Primitives' or 'VariableCollectionId:123'"
    },
    "namePattern": {
      "type": "string",
      "description": "Filter variables by name using regex pattern or substring. Case-insensitive. Only applies when format='filtered'. Example: 'color/brand' or '^typography'"
    },
    "mode": {
      "type": "string",
      "description": "Filter variables by mode name or ID. Only returns variables that have values for this mode. Only applies when format='filtered'. Example: 'Light' or 'Dark'"
    },
    "returnAsLinks": {
      "type": "boolean",
      "default": false,
      "description": "Return variables as resource_link references instead of full data. Drastically reduces payload size (100+ variables = ~20KB vs >1MB). Recommended for large variable sets — combine with format='filtered' + namePattern/collection/mode to fetch only the variables you need. Default: false"
    },
    "refreshCache": {
      "type": "boolean",
      "default": false,
      "description": "Force refresh cache by fetching fresh data from Figma. Use when data may have changed since last fetch. Default: false (use cached data if available and fresh)"
    },
    "useConsoleFallback": {
      "type": "boolean",
      "default": true,
      "description": "DEPRECATED — has no effect. The console-snippet workflow was removed in the Phase 3 CDP cleanup; the Desktop Bridge plugin now handles all non-REST variable extraction automatically. Kept for parameter compatibility only — safe to ignore."
    },
    "parseFromConsole": {
      "type": "boolean",
      "default": false,
      "description": "DEPRECATED — setting this to true now raises an explicit error. The Puppeteer-based console parser no longer exists. Open the Figma Console MCP Desktop Bridge plugin in Figma Desktop and call figma_get_variables() without parseFromConsole; the plugin returns full variable data through the WebSocket bridge."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "Page number for paginated results (1-based). Use when response is too large (>1MB). Each page returns up to 50 variables."
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50,
      "description": "Number of variables per page (1-100). Default: 50. Smaller values reduce response size."
    },
    "resolveAliases": {
      "type": "boolean",
      "default": false,
      "description": "Automatically resolve variable aliases to their final values (hex colors, numbers, etc.). When true, each variable will include a 'resolvedValuesByMode' field with the actual values instead of just alias references. Useful for getting color hex values without manual resolution. Default: false."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "variableKey": {
      "type": "string",
      "minLength": 1,
      "description": "The variable key from figma_get_library_variables (collections[].variables[].key). Distinct from the variable's local id."
    }
  },
  "required": [
    "variableKey"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "auto",
        "dtcg",
        "tokens-studio",
        "css-vars",
        "tailwind-v4",
        "tailwind-v3-config",
        "scss",
        "style-dictionary-v3",
        "json-flat",
        "json-nested"
      ],
      "description": "Format of the input payload. 'auto' (default) detects from payload shape or file extension. Pass an explicit format if auto-detection misfires."
    },
    "payload": {
      "type": "string",
      "description": "Single-file content to import. Use this for one-shot imports without setting up tokens.config.json. Mutually exclusive with `files` and `configPath`."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Relative or absolute filesystem path."
          },
          "content": {
            "type": "string",
            "description": "File contents."
          }
        },
        "required": [
          "path",
          "content"
        ],
        "additionalProperties": false
      },
      "description": "Multi-file import (used for Tokens Studio's split-set format, or for projects with many DTCG source files). Mutually exclusive with `payload` and `configPath`."
    },
    "configPath": {
      "type": "string",
      "description": "Explicit path to tokens.config.json. When omitted, the tool autodiscovers and uses the config's source.dir to find files. Mutually exclusive with `payload` and `files`."
    },
    "strategy": {
      "type": "string",
      "enum": [
        "merge",
        "replace",
        "dry-run"
      ],
      "description": "How to apply changes. 'merge' (default) diffs against current Figma state and applies only deltas, preserving Figma-only variables. 'replace' wipes the target collections and rewrites. 'dry-run' computes the diff and reports without touching Figma."
    },
    "collectionMapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Map input token set names to Figma collection names. Example: {'primitives': 'Primitive Tokens'}. When omitted, set names map 1:1 to collection names."
    },
    "modeMapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Map input mode names to Figma mode names. Useful when source uses 'light'/'dark' and Figma uses 'Light'/'Dark'. Defaults to 1:1 mapping with case preservation."
    },
    "prefix": {
      "type": "string",
      "description": "Prefix to strip from input token names on import. E.g. with prefix 'ds-', a token named '--ds-color-primary' becomes 'color/primary'."
    },
    "onConflict": {
      "type": "string",
      "enum": [
        "ask",
        "figma-wins",
        "code-wins",
        "skip"
      ],
      "description": "How to resolve true two-sided conflicts (both Figma and code changed the same token since last sync). 'ask' (default) surfaces the conflict and writes nothing. 'figma-wins' / 'code-wins' apply the corresponding side. 'skip' leaves conflicted tokens alone but proceeds with the rest."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Shorthand for strategy: 'dry-run'. Computes the diff and returns a preview without applying any changes to Figma."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "componentKey": {
      "type": "string",
      "description": "The component key from search results. Pass this WITH nodeId for automatic fallback."
    },
    "nodeId": {
      "type": "string",
      "description": "The node ID from search results. ALWAYS pass this alongside componentKey - most local components need it."
    },
    "variant": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Variant properties to set (e.g., { Type: 'Simple', State: 'Active' })"
    },
    "overrides": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Property overrides (e.g., { 'Button Label': 'Click Me' })"
    },
    "position": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y"
      ],
      "additionalProperties": false,
      "description": "Position on canvas (default: 0, 0)"
    },
    "parentId": {
      "type": "string",
      "description": "Parent node ID to append the instance to"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Node ID to lint (defaults to current page)"
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Rule filter. Default (omitted) = ['wcag','design-system','layout'] — real WCAG conformance plus quality checks, with best-practice hints excluded. Groups: ['wcag'] (10 conformance rules), ['best-practice'] (text-size, line-height, letter-spacing, paragraph-spacing), ['all'] (everything incl. best-practice), ['design-system'], ['layout']. Or specific rule IDs like ['wcag-contrast', 'wcag-focus-indicator', 'wcag-disabled-no-context']."
    },
    "maxDepth": {
      "type": "number",
      "description": "Maximum tree depth to traverse (default: 10)"
    },
    "maxFindings": {
      "type": "number",
      "description": "Maximum findings before stopping (default: 100)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to move"
    },
    "x": {
      "type": "number",
      "description": "New X position"
    },
    "y": {
      "type": "number",
      "description": "New Y position"
    }
  },
  "required": [
    "nodeId",
    "x",
    "y"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Figma URL to navigate to (e.g., https://www.figma.com/design/abc123)"
    },
    "lock": {
      "type": "boolean",
      "description": "Pin this file as the active target so connections, reconnects, and user interaction in other files won't move it. Defaults to false."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "fileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Figma file URL. Uses current URL if omitted."
    },
    "message": {
      "type": "string",
      "description": "The comment message text. Supports basic formatting."
    },
    "node_id": {
      "type": "string",
      "description": "Node ID to pin the comment to (e.g., '695:313'). Comment appears on that element in Figma."
    },
    "x": {
      "type": "number",
      "description": "X coordinate for comment placement (absolute canvas position). Used with node_id."
    },
    "y": {
      "type": "number",
      "description": "Y coordinate for comment placement (absolute canvas position). Used with node_id."
    },
    "reply_to_comment_id": {
      "type": "string",
      "description": "ID of an existing comment to reply to. Creates a threaded reply instead of a new top-level comment."
    }
  },
  "required": [
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "clearConsole": {
      "type": "boolean",
      "default": true,
      "description": "Clear console logs before reload"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "description": "The collection ID containing the mode (e.g., 'VariableCollectionId:123:456'). Get this from figma_get_variables."
    },
    "modeId": {
      "type": "string",
      "description": "The mode ID to rename (e.g., '123:0'). Get this from the collection's modes array in figma_get_variables."
    },
    "newName": {
      "type": "string",
      "description": "The new name for the mode (e.g., 'Dark Theme', 'Tablet')."
    }
  },
  "required": [
    "collectionId",
    "modeId",
    "newName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to rename"
    },
    "newName": {
      "type": "string",
      "description": "The new name for the node"
    }
  },
  "required": [
    "nodeId",
    "newName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "variableId": {
      "type": "string",
      "description": "The variable ID to rename (e.g., 'VariableID:123:456'). Get this from figma_get_variables."
    },
    "newName": {
      "type": "string",
      "description": "The new name for the variable. Can include slashes for grouping (e.g., 'colors/primary/background')."
    }
  },
  "required": [
    "variableId",
    "newName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "grid": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 50
        },
        "maxItems": 50
      },
      "maxItems": 50,
      "description": "2D array of slide IDs representing the new order, e.g. [['1:2','1:3'],['1:4']]"
    }
  },
  "required": [
    "grid"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slotId": {
      "type": "string",
      "description": "Direct SlotNode ID"
    },
    "instanceId": {
      "type": "string",
      "description": "Instance ID — use with slotName when slotId is unknown"
    },
    "slotName": {
      "type": "string",
      "description": "Slot layer name on the instance"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to resize"
    },
    "width": {
      "type": "number",
      "description": "New width in pixels"
    },
    "height": {
      "type": "number",
      "description": "New height in pixels"
    },
    "withConstraints": {
      "type": "boolean",
      "default": true,
      "description": "Whether to apply child constraints during resize (default: true)"
    }
  },
  "required": [
    "nodeId",
    "width",
    "height"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "HTML string to scan. Can be a full document or a component fragment (will be wrapped in a valid document)."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "WCAG tag filter. Examples: ['wcag2a'], ['wcag2aa'], ['wcag21aa'], ['wcag22aa'], ['best-practice']. Defaults to all structural rules if omitted."
    },
    "context": {
      "type": "string",
      "description": "CSS selector to scope the scan to a specific element (e.g., '#my-component', '.card'). Scans entire document if omitted."
    },
    "includePassingRules": {
      "type": "boolean",
      "description": "If true, includes count of passing and incomplete rules in the response (default: false)."
    },
    "mapToCodeSpec": {
      "type": "boolean",
      "description": "If true, includes a codeSpec.accessibility object auto-extracted from the HTML + scan results. Pass this directly into figma_check_design_parity's codeSpec.accessibility field for automated design-to-code a11y parity checking."
    }
  },
  "required": [
    "html"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "default": "",
      "description": "Search query to match component names or descriptions"
    },
    "category": {
      "type": "string",
      "description": "Filter by category (e.g., 'Button', 'Input', 'Card')"
    },
    "libraryFileKey": {
      "type": "string",
      "description": "File key of a published library to search in (for cross-file library access). Overrides local search."
    },
    "libraryFileUrl": {
      "type": "string",
      "description": "URL of a published library file to search in (e.g., https://www.figma.com/design/abc123/...). Alternative to libraryFileKey."
    },
    "limit": {
      "type": "number",
      "default": 10,
      "description": "Maximum results to return (default: 10, max: 25)"
    },
    "offset": {
      "type": "number",
      "default": 0,
      "description": "Offset for pagination"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Node ID to write annotations to (e.g., '695:313')"
    },
    "annotations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "description": "Plain text annotation label"
          },
          "labelMarkdown": {
            "type": "string",
            "description": "Rich text annotation label with markdown formatting. Supports bold, italic, links, lists, code, and headers."
          },
          "properties": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "width",
                    "height",
                    "maxWidth",
                    "minWidth",
                    "maxHeight",
                    "minHeight",
                    "fills",
                    "strokes",
                    "effects",
                    "strokeWeight",
                    "cornerRadius",
                    "textStyleId",
                    "textAlignHorizontal",
                    "fontFamily",
                    "fontStyle",
                    "fontSize",
                    "fontWeight",
                    "lineHeight",
                    "letterSpacing",
                    "itemSpacing",
                    "padding",
                    "layoutMode",
                    "alignItems",
                    "opacity",
                    "mainComponent",
                    "gridRowGap",
                    "gridColumnGap",
                    "gridRowCount",
                    "gridColumnCount",
                    "gridRowAnchorIndex",
                    "gridColumnAnchorIndex",
                    "gridRowSpan",
                    "gridColumnSpan"
                  ],
                  "description": "Design property to pin (e.g., 'fills', 'width', 'fontSize')"
                }
              },
              "required": [
                "type"
              ],
              "additionalProperties": false
            },
            "description": "Design properties to pin to this annotation (e.g., fills, width, fontSize)"
          },
          "categoryId": {
            "type": "string",
            "description": "Annotation category ID. Use figma_get_annotation_categories to list available categories."
          }
        },
        "additionalProperties": false
      },
      "description": "Array of annotations to set. Each annotation can have a label (plain or markdown), pinned properties, and a category. Pass an empty array [] to clear all annotations."
    },
    "mode": {
      "type": "string",
      "enum": [
        "replace",
        "append"
      ],
      "default": "replace",
      "description": "'replace' (default) overwrites all existing annotations. 'append' adds new annotations while keeping existing ones."
    }
  },
  "required": [
    "nodeId",
    "annotations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID of the component or style to update (e.g., '123:456')"
    },
    "description": {
      "type": "string",
      "description": "The plain text description to set"
    },
    "descriptionMarkdown": {
      "type": "string",
      "description": "Optional rich text description using markdown formatting"
    }
  },
  "required": [
    "nodeId",
    "description"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to modify"
    },
    "fills": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "SOLID",
            "description": "Fill type (currently only SOLID supported)"
          },
          "color": {
            "type": "string",
            "description": "Hex color string (e.g., '#FF0000', '#FF000080' for transparency). Optional when variableId is provided."
          },
          "opacity": {
            "type": "number",
            "description": "Opacity 0-1 (default: 1)"
          },
          "variableId": {
            "type": "string",
            "description": "Bind this fill's color to a Figma variable by id (e.g. 'VariableID:1:23' from figma_get_variables). When set, the variable drives the color. Import library variables first via figma_import_library_variable."
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Array of fill objects"
    }
  },
  "required": [
    "nodeId",
    "fills"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of node IDs to apply the image fill to"
    },
    "imageData": {
      "type": "string",
      "description": "Base64-encoded image data (JPEG/PNG)"
    },
    "scaleMode": {
      "type": "string",
      "enum": [
        "FILL",
        "FIT",
        "CROP",
        "TILE"
      ],
      "description": "How the image fills the node (default: FILL)"
    }
  },
  "required": [
    "nodeIds",
    "imageData"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "ID of the INSTANCE node to update (e.g., '1:234'). Must be a component instance, not a regular frame."
    },
    "properties": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "boolean"
        ]
      },
      "description": "Properties to set. Keys are property names (e.g., 'Label', 'Show Icon', 'Size'). Values are strings for TEXT/VARIANT properties, booleans for BOOLEAN properties. The tool automatically handles the #nodeId suffix for TEXT/BOOLEAN/INSTANCE_SWAP properties."
    }
  },
  "required": [
    "nodeId",
    "properties"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    },
    "color": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Background color as hex (e.g., '#181818')"
    }
  },
  "required": [
    "slideId",
    "color"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    },
    "style": {
      "type": "string",
      "enum": [
        "NONE",
        "DISSOLVE",
        "SLIDE_FROM_LEFT",
        "SLIDE_FROM_RIGHT",
        "SLIDE_FROM_TOP",
        "SLIDE_FROM_BOTTOM",
        "PUSH_FROM_LEFT",
        "PUSH_FROM_RIGHT",
        "PUSH_FROM_TOP",
        "PUSH_FROM_BOTTOM",
        "MOVE_FROM_LEFT",
        "MOVE_FROM_RIGHT",
        "MOVE_FROM_TOP",
        "MOVE_FROM_BOTTOM",
        "SLIDE_OUT_TO_LEFT",
        "SLIDE_OUT_TO_RIGHT",
        "SLIDE_OUT_TO_TOP",
        "SLIDE_OUT_TO_BOTTOM",
        "MOVE_OUT_TO_LEFT",
        "MOVE_OUT_TO_RIGHT",
        "MOVE_OUT_TO_TOP",
        "MOVE_OUT_TO_BOTTOM",
        "SMART_ANIMATE"
      ],
      "description": "Transition style"
    },
    "duration": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 10,
      "default": 0.4,
      "description": "Duration in seconds (0.01 to 10)"
    },
    "curve": {
      "type": "string",
      "enum": [
        "LINEAR",
        "EASE_IN",
        "EASE_OUT",
        "EASE_IN_AND_OUT",
        "GENTLE",
        "QUICK",
        "BOUNCY",
        "SLOW"
      ],
      "default": "EASE_IN_AND_OUT",
      "description": "Easing curve"
    }
  },
  "required": [
    "slideId",
    "style"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "grid",
        "single-slide"
      ],
      "description": "View mode"
    }
  },
  "required": [
    "mode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The node ID to modify"
    },
    "strokes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "SOLID",
            "description": "Stroke type"
          },
          "color": {
            "type": "string",
            "description": "Hex color string. Optional when variableId is provided."
          },
          "opacity": {
            "type": "number",
            "description": "Opacity 0-1"
          },
          "variableId": {
            "type": "string",
            "description": "Bind this stroke's color to a Figma variable by id (e.g. 'VariableID:1:23' from figma_get_variables). When set, the variable drives the color."
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Array of stroke objects"
    },
    "strokeWeight": {
      "type": "number",
      "description": "Stroke thickness in pixels"
    }
  },
  "required": [
    "nodeId",
    "strokes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "The text node ID"
    },
    "text": {
      "type": "string",
      "description": "The new text content"
    },
    "fontSize": {
      "type": "number",
      "description": "Optional font size to set"
    },
    "fontFamily": {
      "type": "string",
      "description": "Optional font family to apply (e.g., 'Inter')"
    },
    "fontStyle": {
      "type": "string",
      "description": "Optional font style/weight to apply (e.g., 'Bold', 'Semi Bold'). No-space variants like 'SemiBold' are auto-corrected."
    }
  },
  "required": [
    "nodeId",
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "collectionName": {
      "type": "string",
      "description": "Name for the token collection (e.g., 'Brand Tokens')"
    },
    "modes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 4,
      "description": "Mode names (first becomes default). Example: ['Light', 'Dark']"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Token name (e.g., 'color/primary')"
          },
          "resolvedType": {
            "type": "string",
            "enum": [
              "COLOR",
              "FLOAT",
              "STRING",
              "BOOLEAN"
            ],
            "description": "Token type"
          },
          "description": {
            "type": "string",
            "description": "Optional description"
          },
          "values": {
            "type": "object",
            "additionalProperties": {
              "type": [
                "string",
                "number",
                "boolean"
              ]
            },
            "description": "Values keyed by mode NAME (not ID). Example: { 'Light': '#FFFFFF', 'Dark': '#000000' }. A string value wrapped in braces is an ALIAS reference resolved to another variable: '{color.blue.600}' matches variable name 'color/blue/600' — first among variables created in THIS call, then existing local variables (exact match, then case-insensitive). Set-qualified references ('{primitives.color.blue.600}') strip the leading collection name. Unresolvable references skip that value and surface in the response's warnings[]."
          }
        },
        "required": [
          "name",
          "resolvedType",
          "values"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 100,
      "description": "Token definitions (1-100)"
    }
  },
  "required": [
    "collectionName",
    "modes",
    "tokens"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slideId": {
      "type": "string",
      "maxLength": 50,
      "description": "The node ID of the slide"
    },
    "skip": {
      "type": "boolean",
      "description": "True to skip the slide, false to include it"
    }
  },
  "required": [
    "slideId",
    "skip"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Optional node ID to screenshot (e.g., '123:456'). If omitted, uses the node-id from the Desktop Bridge plugin's reported file URL when present. To screenshot what the user is currently looking at on the canvas, prefer figma_capture_screenshot (uses the plugin's exportAsync and reflects the current state)."
    },
    "scale": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 4,
      "default": 2,
      "description": "Image scale factor (0.01-4, default: 2 for high quality)"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "jpg",
        "svg",
        "pdf"
      ],
      "default": "png",
      "description": "Image format (default: png)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "variableId": {
      "type": "string",
      "description": "The variable ID to update (e.g., 'VariableID:123:456'). Get this from figma_get_variables."
    },
    "modeId": {
      "type": "string",
      "description": "The mode ID to update the value in (e.g., '1:0'). Required when updating a value. Get this from the variable's collection modes."
    },
    "value": {
      "type": [
        "string",
        "number",
        "boolean"
      ],
      "description": "The new value (requires modeId). For COLOR: hex string like '#FF0000'. For FLOAT: number. For STRING: text. For BOOLEAN: true/false."
    },
    "description": {
      "type": "string",
      "description": "Set the variable's description (the 'How to use this variable' field; exported as DTCG $description). Pass an empty string to clear it."
    }
  },
  "required": [
    "variableId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "duration": {
      "type": "number",
      "default": 30,
      "description": "How long to watch in seconds"
    },
    "level": {
      "type": "string",
      "enum": [
        "log",
        "info",
        "warn",
        "error",
        "debug",
        "all"
      ],
      "default": "all",
      "description": "Filter by log level"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}