← Back to ShaynCut

🤖 MCP Server Documentation

Connect Claude Desktop or Claude Code to ShaynCut for AI-powered video editing

shayntech-video-editor v1.0.0

What is MCP?

MCP (Model Context Protocol) lets Claude connect directly to ShaynCut's video engine. Instead of using the web editor manually, you tell Claude what to do in natural language and it processes the video for you.

Example: "Download this video, trim the first 30 seconds, speed it up 2x, and add background music" — Claude does it all in one command.

🔗 MCP URL: https://shayncut.tech/mcp
🖥️ Claude Desktop
⌨️ Claude Code
📝 JSON Config

Connect Claude Desktop

Follow these steps to connect ShaynCut to your Claude Desktop app:

⚙️
Step 1

Open Claude Settings

Click on your profile icon (top-right corner) → Settings

🔌
Step 2

Go to the Connector Section

In the left sidebar, click Connector (or Developer in older versions)

➕
Step 3

Add a Custom Connector

Click "Add Custom Connector" or the "+" button

✏️
Step 4

Fill in the Details

Enter the following:

➕ Add MCP Connector
ShaynCut
https://shayncut.tech/mcp
URL (Streamable HTTP)
✓ 11 tools will be auto-discovered
💾
Step 5

Save & Connect

Click Save or Connect. Claude will automatically discover 11 video editing tools.

🔨
Step 6

Start Editing

You'll see a hammer icon 🔨 in your chat — that means ShaynCut is connected!

Try: "Download https://example.com/video.mp4, trim from 0:30 to 1:15, and convert to GIF"

Connect Claude Code (CLI)

For developers using Claude Code in the terminal:

📁
Step 1

Navigate to Your Project

cd your-project

📄
Step 2

Create .mcp.json

Create a file named .mcp.json in your project root:

{
  "mcpServers": {
    "shayncut": {
      "url": "https://shayncut.tech/mcp"
    }
  }
}
▶️
Step 3

Run Claude Code

Start Claude Code in that directory — it will auto-detect the MCP server.

claude
🎬
Step 4

Edit Videos from CLI

Example: "Download this video URL, extract the audio as MP3, and save it"

Claude Desktop — JSON Config

Alternative method — edit the config file directly:

⚙️
Step 1

Open Claude Settings → Developer

Click your profile → Settings → Developer → Edit Config

📝
Step 2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shayncut": {
      "url": "https://shayncut.tech/mcp"
    }
  }
}
🔄
Step 3

Restart Claude

Close and reopen Claude Desktop. You'll see the 🔨 icon with 11 tools ready.

Available Tools (11 total)

Claude discovers these automatically when connected:

edit_video Smart editor — understands natural language prompts. Provide a URL + description.
promptvideo_urlaudio_urlimage_urls
trim_video Cut a segment by start time and duration.
input_pathstart_timeduration
merge_videos Join multiple clips into one video.
input_paths[]
add_audio Voiceover or background music at adjustable volume.
input_pathaudio_pathbg_music
change_speed 0.1x to 10x (slow motion / timelapse).
input_pathspeed
image_to_video Create slideshow from images with configurable timing.
image_paths[]duration_per_image
add_text_overlay Add captions/titles at any position.
input_pathtextposition
convert_format MP4, WebM, GIF, AVI, MOV, MP3, WAV.
input_pathoutput_format
extract_audio Extract audio track from any video.
input_pathformat
download_file Download a file from URL to the server for processing.
url
get_media_info Get codec, resolution, duration, and other metadata.
input_path

Example Workflow

You: "I have a raw video at https://example.com/raw.mp4.
Trim from 0:30 to 2:00, add background music from
https://example.com/bg.mp3 at 30% volume, and convert to GIF."

Claude:
1. Downloads raw.mp4 (via download_file)
2. Trims 0:30→2:00 (via trim_video)
3. Downloads bg.mp3 (via download_file)
4. Adds background music at 30% volume (via add_audio)
5. Converts to GIF (via convert_format)
6. Returns: https://shayncut.tech/output/result_xxx.gif

Server Information

MCP URLhttps://shayncut.tech/mcp
Health CheckGET /health
Max File Size500 MB
Max Duration10 minutes
Input FormatsMP4, AVI, MOV, MKV, WebM, GIF, images, audio
Output FormatsMP4, WebM, GIF, AVI, MOV, MP3, WAV