Apply Effect
apply_effectApply a video effect to a clip by specifying its node ID and effect name, so editors can run structured edits without manual UI steps.
Instructions
Apply a video effect to a clip. Experimental QE DOM catalog lookup includes an exact-name probe when enumeration is empty. A component-list readback does not verify rendered pixels.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"node_id": "<node_id>",
"effect_name": "<effect_name>"
},
"name": "apply_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node_id | Yes | Node ID of the clip to apply the effect to | |
| effect_name | Yes | Name of the effect (e.g., 'Gaussian Blur', 'Lumetri Color') |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. |