genart.dev
MCP ToolsDesign Layers

design_get_layer

Get full details of a single design layer.

Get full details of a single design layer, including its type, properties, transform, blend settings, and visibility state.

Input Schema

ParameterTypeRequiredDescription
sketchIdstringNoTarget sketch ID. Defaults to the currently active sketch.
layerIdstringYesThe ID of the layer to retrieve.

Output Shape

{
  "layerId": "layer_f7e2d1",
  "name": "Background Circle",
  "type": "shape",
  "index": 0,
  "visible": true,
  "locked": false,
  "opacity": 0.85,
  "blendMode": "multiply",
  "properties": {
    "shape": "ellipse",
    "fill": "#2a4365"
  },
  "transform": {
    "x": 400,
    "y": 300,
    "width": 500,
    "height": 500,
    "rotation": 0,
    "scaleX": 1,
    "scaleY": 1,
    "anchorX": 0.5,
    "anchorY": 0.5
  }
}

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.
LAYER_NOT_FOUNDNo layer with the given layerId exists in the sketch.

Golden Path Example

Request

{
  "layerId": "layer_f7e2d1"
}

Response

{
  "layerId": "layer_f7e2d1",
  "name": "Background Circle",
  "type": "shape",
  "index": 0,
  "visible": true,
  "locked": false,
  "opacity": 0.85,
  "blendMode": "multiply",
  "properties": {
    "shape": "ellipse",
    "fill": "#2a4365"
  },
  "transform": {
    "x": 400,
    "y": 300,
    "width": 500,
    "height": 500,
    "rotation": 0,
    "scaleX": 1,
    "scaleY": 1,
    "anchorX": 0.5,
    "anchorY": 0.5
  }
}