genart.dev
MCP ToolsDesign Layers

design_capture_composite

Get info about the design layer composite.

Get information about the design layer composite for the active sketch. Returns a summary of the composite state including canvas dimensions, layer count, and the current render status.

Input Schema

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

Output Shape

{
  "sketchId": "sketch_x1y2z3",
  "canvasWidth": 800,
  "canvasHeight": 600,
  "layerCount": 3,
  "visibleLayerCount": 2,
  "compositeStatus": "ready",
  "layers": [
    {
      "layerId": "layer_f7e2d1",
      "name": "Background Circle",
      "type": "shape",
      "visible": true,
      "blendMode": "multiply"
    },
    {
      "layerId": "layer_a3c4e5",
      "name": "Title Text",
      "type": "text",
      "visible": true,
      "blendMode": "normal"
    },
    {
      "layerId": "layer_b6d7f8",
      "name": "Grain",
      "type": "filter",
      "visible": false,
      "blendMode": "overlay"
    }
  ]
}

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.
COMPOSITE_NOT_READYThe design composite has not finished initializing.

Golden Path Example

Request

{}

Response

{
  "sketchId": "sketch_x1y2z3",
  "canvasWidth": 800,
  "canvasHeight": 600,
  "layerCount": 3,
  "visibleLayerCount": 2,
  "compositeStatus": "ready",
  "layers": [
    {
      "layerId": "layer_f7e2d1",
      "name": "Background Circle",
      "type": "shape",
      "visible": true,
      "blendMode": "multiply"
    },
    {
      "layerId": "layer_a3c4e5",
      "name": "Title Text",
      "type": "text",
      "visible": true,
      "blendMode": "normal"
    },
    {
      "layerId": "layer_b6d7f8",
      "name": "Grain",
      "type": "filter",
      "visible": false,
      "blendMode": "overlay"
    }
  ]
}