genart.dev
MCP ToolsDesign Layers

design_list_layers

List all design layers with types, visibility, and key properties.

List all design layers in the active sketch. Returns a summary of each layer including its type, visibility, lock state, and key properties.

Input Schema

ParameterTypeRequiredDescription
sketchIdstringNoTarget sketch ID. Defaults to the currently active sketch.

Output Shape

{
  "layers": [
    {
      "layerId": "layer_f7e2d1",
      "name": "Background Circle",
      "type": "shape",
      "index": 0,
      "visible": true,
      "locked": false,
      "opacity": 0.85,
      "blendMode": "multiply"
    },
    {
      "layerId": "layer_a3c4e5",
      "name": "Title Text",
      "type": "text",
      "index": 1,
      "visible": true,
      "locked": false,
      "opacity": 1,
      "blendMode": "normal"
    }
  ],
  "count": 2
}

Side Effects

  • None. This is a read-only operation.

Error Cases

ErrorCause
SKETCH_NOT_FOUNDThe specified sketchId does not exist or no sketch is active.

Golden Path Example

Request

{}

Response

{
  "layers": [
    {
      "layerId": "layer_f7e2d1",
      "name": "Background Circle",
      "type": "shape",
      "index": 0,
      "visible": true,
      "locked": false,
      "opacity": 0.85,
      "blendMode": "multiply"
    },
    {
      "layerId": "layer_a3c4e5",
      "name": "Title Text",
      "type": "text",
      "index": 1,
      "visible": true,
      "locked": false,
      "opacity": 1,
      "blendMode": "normal"
    },
    {
      "layerId": "layer_b6d7f8",
      "name": "Grain",
      "type": "filter",
      "index": 2,
      "visible": false,
      "locked": true,
      "opacity": 0.3,
      "blendMode": "overlay"
    }
  ],
  "count": 3
}