blender_vse
Manage video strips, apply transitions, trim, cut, and render videos in Blender's Video Sequence Editor through a unified interface.
Instructions
PORTMANTEAU PATTERN RATIONALE: Consolidates 20 VSE operations into a single interface. Prevents tool explosion while providing full video editing: strip management, timeline editing, effects, and rendering. Follows FastMCP 3.x best practices.
Blender's built-in Video Sequence Editor (VSE) exposed as MCP tools. Add video/audio/image strips, apply transitions, trim, cut, move, and render to video.
Strip Creation (7 operations):
add_movie: Add a video/MP4 file as a movie strip
add_sound: Add an audio file (WAV, MP3, etc.) as a sound strip
add_image_sequence: Add a folder of images as an image sequence strip
add_scene: Add a 3D scene as a strip (compositing)
add_color: Add a solid color matte strip
add_text: Add a text overlay strip
add_effect: Add a transition/filter effect between strips
Strip Editing (6 operations):
delete_strip: Remove a strip by name
cut_strip: Cut a strip at a specific frame
trim_strip: Set strip start/end frames (trim handles)
move_strip: Move a strip to a different channel or frame
mute_strip: Mute or unmute a strip
lock_strip: Lock or unlock a strip
Properties (3 operations):
set_speed: Change playback speed (creates speed effect strip)
set_blend: Set blend mode and opacity (ALPHA_OVER, CROSS, ADD, etc.)
set_transform: Set position, scale, rotation of a strip
Information (2 operations):
list_strips: List all strips in the timeline with properties
get_timeline_info: Get timeline frame range, FPS, strip count, channels
Rendering (1 operation):
render_video: Render the VSE timeline to a video file (H264/MPEG4)
Cleanup (1 operation):
clear_vse: Remove all strips from the timeline
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | No | The VSE operation to perform. | list_strips |
| filepath | No | Path to video or audio file. Required for: add_movie, add_sound. | |
| directory | No | Directory path for image sequences. Required for: add_image_sequence. | |
| strip_name | No | Target strip name for editing operations. Required for most edit ops. | |
| strip1_name | No | First strip name for effect creation. Required for: add_effect. | |
| strip2_name | No | Second strip name for effect creation. Required for: add_effect. | |
| channel | No | VSE channel number (higher = on top). Default: 1. | |
| frame | No | Frame number for placement/cutting. Default: 1. | |
| length | No | Strip duration in frames. Default: 120. Used for: add_color, add_text, add_effect. | |
| frame_start | No | Start frame for trim or render range. Default: 1. | |
| frame_end | No | End frame for render range. Default: 250. | |
| text | No | Text content. Required for: add_text. | |
| font_size | No | Font size in points. Default: 48. Used for: add_text. | |
| color_r | No | ||
| color_g | No | ||
| color_b | No | ||
| effect_type | No | Effect type. Options: CROSS, WIPE, GLOW, TRANSFORM, SPEED, ADJUSTMENT, GAUSSIAN_BLUR, TEXT, COLOR, MULTICAM. Default: CROSS. | CROSS |
| cut_type | No | Cut type. SOFT (preserves handles) or HARD (snaps). Default: SOFT. | SOFT |
| mute | No | True to mute, False to unmute. Default: True. Used for: mute_strip. | |
| lock | No | True to lock, False to unlock. Default: True. Used for: lock_strip. | |
| speed_factor | No | Playback speed multiplier. 2.0 = double speed, 0.5 = half speed. Default: 1.0. | |
| blend_type | No | Blend mode. Options: ALPHA_OVER, CROSS, ADD, SUBTRACT, MULTIPLY, SCREEN, OVERLAY, DARKEN, LIGHTEN, etc. Default: ALPHA_OVER. | ALPHA_OVER |
| blend_alpha | No | Opacity 0.0-1.0. Default: 1.0. | |
| position_x | No | ||
| position_y | No | ||
| scale_x | No | ||
| scale_y | No | ||
| rotation | No | Strip rotation in degrees. Used for: set_transform. | |
| scene_name | No | Source 3D scene name. Required for: add_scene. | |
| fit_method | No | How to fit media. FIT (maintains aspect), FILL (crops), STRETCH. Default: FIT. | FIT |
| include_audio | No | Include audio track from video. Default: True. Used for: add_movie. | |
| resolution_x | No | ||
| resolution_y | No | ||
| output_path | No | Output file path (.mp4 recommended). Required for: render_video. | |
| container | No | Video container format. Options: MPEG4, AVI, QUICKTIME, OGG, MKV. Default: MPEG4. | MPEG4 |
| codec | No | Video codec. Options: H264, H265, THEORA, AV1. Default: H264. | H264 |
| quality | No | Encoding quality. Options: BEST, GOOD, MEDIUM. Default: MEDIUM. Used for: render_video. | MEDIUM |
| fps | No | Frames per second. Default: 30. Used for: render_video. | |
| audio_codec | No | Audio codec. Options: AAC, MP3, PCM, VORBIS, FLAC. Default: AAC. Used for: render_video. | AAC |
| audio_bitrate | No | Audio bitrate in kbps. Default: 192. Used for: render_video. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |