Tools Overview

The VFX MCP Server provides 35+ professional video editing tools organized into logical categories. Each tool is designed for specific video manipulation tasks and can be used individually or combined for complex workflows.

🎯 Tool Categories

Basic Operations 4 tools

Essential video manipulation functions for common editing tasks.

• trim_video - Extract video segments
• get_video_info - Retrieve video metadata
• resize_video - Change video resolution
• concatenate_videos - Join multiple videos

View Details →

Audio Processing 4 tools

Complete audio manipulation and visualization capabilities.

• extract_audio - Extract audio tracks
• add_audio - Add or replace audio
• extract_audio_spectrum - Audio visualization
• merge_audio_tracks - Merge multiple audio tracks

View Details →

Effects & Filters 5 tools

Professional-grade enhancement and visual effects.

• apply_filter - Custom FFmpeg filters
• change_speed - Speed adjustment
• apply_color_grading - Color correction
• apply_motion_blur - Motion blur effects
• apply_video_stabilization - Stabilization

View Details →

Format Conversion 2 tools

File format and media conversion utilities.

• generate_thumbnail - Extract video frames
• convert_format - Format conversion

View Details →

Advanced Operations 10 tools

Sophisticated video production and composition tools.

• create_video_slideshow - Image slideshows
• create_video_mosaic - Multi-video layouts
• create_picture_in_picture - PiP overlays
• create_time_lapse - Time-lapse effects
• create_video_transitions - Smooth transitions
• + 5 more advanced tools

View Details →

Analysis & Extraction 4 tools

Video analysis and content extraction capabilities.

• extract_frames - Frame extraction
• detect_scene_changes - Scene detection
• extract_video_statistics - Technical analysis
• extract_dominant_colors - Color analysis

View Details →

Text & Graphics 2 tools

Text overlay and animation capabilities.

• add_text_overlay - Text overlays
• create_animated_text - Animated text

View Details →

Specialized Effects 4 tools

Professional VFX and cinematic effects.

• create_green_screen_effect - Chroma key
• create_particle_system - Particle effects
• apply_3d_transforms - 3D transforms
• apply_lens_effects - Lens simulation

View Details →

🔧 Common Tool Patterns

Input/Output Pattern

All tools follow a consistent pattern:

tool_name(
    input_path: str,        # Source video file
    output_path: str,       # Destination file
    # Tool-specific parameters...
    ctx: Context = None     # Optional progress reporting
)

Progress Reporting

Tools support optional context for progress updates:

await session.call_tool("trim_video", {
    "input_path": "long_video.mp4",
    "output_path": "trimmed.mp4",
    "start_time": 0,
    "duration": 60
    # Progress updates will be streamed back
})

Error Handling

All tools provide comprehensive error handling:

• Input validation: File existence and format checks
• FFmpeg errors: Detailed error messages with suggestions
• Resource management: Automatic cleanup of temporary files

📊 Resource Endpoints

In addition to tools, the server provides resource endpoints for file discovery:

videos://list

Lists all video files in the current working directory:

{
  "videos": [
    {
      "name": "sample.mp4",
      "size": "15.2 MB",
      "duration": 45.3,
      "resolution": "1920x1080"
    }
  ]
}

videos://{filename}/metadata

Returns detailed metadata for a specific video:

{
  "format": "mp4",
  "duration": 45.3,
  "width": 1920,
  "height": 1080,
  "fps": 30.0,
  "video_codec": "h264",
  "audio_codec": "aac",
  "bitrate": 2500000,
  "file_size": "15.2 MB"
}

tools://advanced

Provides information about advanced tool capabilities and usage patterns.

🎬 Tool Usage Philosophy

Single Responsibility

Each tool has a focused purpose:

• Basic tools handle fundamental operations
• Advanced tools combine multiple operations
• Analysis tools extract information without modification

Composability

Tools are designed to work together:

# Extract → Process → Combine workflow
extract_frames("video.mp4", "frames/")
# Process frames individually
create_video_slideshow("frames/", "processed.mp4")

Performance Optimization

• Copy mode: Tools use FFmpeg copy when possible (no re-encoding)
• Chunked processing: Large files are processed in manageable chunks
• Concurrent operations: Multi-threaded processing where applicable

🚀 Getting Started with Tools

1. Basic Video Info

# Always start by understanding your video
info = await session.call_tool("get_video_info", {
    "video_path": "input.mp4"
})

2. Simple Edits

# Trim to essential content
result = await session.call_tool("trim_video", {
    "input_path": "input.mp4",
    "output_path": "trimmed.mp4",
    "start_time": 10,
    "duration": 60
})

3. Enhancement

# Apply color grading for better visuals
result = await session.call_tool("apply_color_grading", {
    "input_path": "trimmed.mp4",
    "output_path": "enhanced.mp4",
    "brightness": 0.1,
    "contrast": 1.2,
    "saturation": 1.1
})

4. Advanced Composition

# Create picture-in-picture effect
result = await session.call_tool("create_picture_in_picture", {
    "main_video": "enhanced.mp4",
    "overlay_video": "webcam.mp4",
    "output_path": "final.mp4",
    "position": "top-right",
    "scale": 0.3
})

📚 Next Steps

Ready to dive deeper? Explore the detailed documentation for each tool category:

Basic Operations

Start with essential video editing functions

Advanced Operations

Complex video composition and effects

Common Workflows

Learn typical video editing patterns

API Reference

Complete technical documentation

---

Questions about specific tools? Each category page includes detailed examples, parameter references, and use case scenarios.