Batch Apply Effect
batch_apply_effectApply one audio or video effect to selected clips, a track, or all compatible clips in Premiere Pro, with preflight checks and readback verification.
Instructions
Apply one audio or video effect to compatible selected clips, a compatible track, or all compatible clips. Every target is preflighted and then checked by component-count readback.
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": {
"effect_name": "<effect_name>",
"target": "<target>"
},
"name": "batch_apply_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Which clips to apply to: selected clips, all on a track, or all in sequence | |
| track_type | No | Track type (required when target is 'track') | |
| effect_name | Yes | Display name of the effect to apply (e.g., 'Gaussian Blur', 'Lumetri Color') | |
| track_index | No | Track index (required when target is 'track') |
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. |