remove_effect
Remove specific effects from Adobe Premiere Pro clips by specifying the clip ID and effect name, streamlining video editing workflows with precision.
Instructions
Removes an effect from a clip.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clipId | Yes | The ID of the clip | |
| effectName | Yes | The name of the effect to remove |
Implementation Reference
- src/tools/index.ts:1234-1280 (handler)The main handler function for the 'remove_effect' tool. It constructs an ExtendScript that finds the specified clip, iterates through its effects, removes the matching effect by name, and returns success/error status.private async removeEffect(clipId: string, effectName: string): Promise<any> { const script = ` try { var clip = app.project.getClipByID("${clipId}"); if (!clip) { JSON.stringify({ success: false, error: "Clip not found" }); return; } var effects = clip.getEffects(); var removed = false; for (var i = 0; i < effects.length; i++) { if (effects[i].displayName === "${effectName}") { clip.removeEffect(effects[i]); removed = true; break; } } if (!removed) { JSON.stringify({ success: false, error: "Effect not found on clip" }); return; } JSON.stringify({ success: true, message: "Effect removed successfully", clipId: "${clipId}", effectName: "${effectName}" }); } catch (e) { JSON.stringify({ success: false, error: e.toString() }); } `; return await this.bridge.executeScript(script); }
- src/tools/index.ts:201-207 (schema)Zod input schema for the 'remove_effect' tool, defining required parameters: clipId and effectName.name: 'remove_effect', description: 'Removes an effect from a clip.', inputSchema: z.object({ clipId: z.string().describe('The ID of the clip'), effectName: z.string().describe('The name of the effect to remove') }) },
- src/tools/index.ts:476-477 (registration)Registration and dispatch of the 'remove_effect' tool in the executeTool method's switch statement, calling the handler with parsed arguments.case 'remove_effect': return await this.removeEffect(args.clipId, args.effectName);
- src/tools/index.ts:201-207 (registration)Tool registration in the getAvailableTools() method, adding 'remove_effect' to the list of available MCP tools with description and schema.name: 'remove_effect', description: 'Removes an effect from a clip.', inputSchema: z.object({ clipId: z.string().describe('The ID of the clip'), effectName: z.string().describe('The name of the effect to remove') }) },