MCP ToolsDesign Layers
design_set_blend
Set blend mode and/or opacity on a design layer.
Set the blend mode and/or opacity on a design layer. You can update one or both values in a single call.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
sketchId | string | No | Target sketch ID. Defaults to the currently active sketch. |
layerId | string | Yes | The ID of the layer to update. |
blendMode | enum | No | One of: normal, multiply, screen, overlay, darken, lighten, color-dodge, color-burn, hard-light, soft-light, difference, exclusion, hue, saturation, color, luminosity. |
opacity | number | No | Layer opacity, 0–1. |
Output Shape
{
"layerId": "layer_f7e2d1",
"name": "Background Circle",
"blendMode": "screen",
"opacity": 0.6
}Side Effects
- The layer re-renders in the composite with the new blend mode and/or opacity.
- Visual output of layers above may change depending on the blend mode.
Error Cases
| Error | Cause |
|---|---|
SKETCH_NOT_FOUND | The specified sketchId does not exist or no sketch is active. |
LAYER_NOT_FOUND | No layer with the given layerId exists in the sketch. |
INVALID_BLEND_MODE | The blendMode is not one of the 16 supported values. |
INVALID_OPACITY | The opacity value is outside the 0–1 range. |
NO_CHANGES | Neither blendMode nor opacity was provided. |
Golden Path Example
Request
{
"layerId": "layer_f7e2d1",
"blendMode": "screen",
"opacity": 0.6
}Response
{
"layerId": "layer_f7e2d1",
"name": "Background Circle",
"blendMode": "screen",
"opacity": 0.6
}