Claude Code + ReelSDK $0.02 per compute minute, first $0.50 free
Give Claude Code a video editing skill and the ReelSDK MCP tools
Claude Code trims, captions and renders video through 6 ReelSDK MCP tools, with raw ffmpeg 8.1 at $0.02 per compute minute and no local ffmpeg. Add the server with one command and a 13-line SKILL.md, and the Bash tool, which stops a command after 2 min by default and 10 min at most, stays out of the encode.
- One claude mcp add command, or a shared .mcp.json
- A skill that keeps video work off the Bash tool
- Files saved to ./reelsdk-output, links kept 7 days
bash: line 1: ffmpeg: command not found
Source: Bash exit status
The same job as one call to ReelSDK
claude mcp add reelsdk --env REELSDK_KEY=rsdk_live_... -- npx -y github:bitgate/reelsdk-mcp
Why ffmpeg breaks here
A skill tells Claude when to reach for the tools
Claude Code runs shell commands through its Bash tool, which stops a command after 2 min by default and allows 10 min at most, and an encode only works if ffmpeg is installed on the machine. The ReelSDK MCP server gives Claude 6 tools instead: add_captions, make_slideshow, make_short, run_ffmpeg, get_job and upload_file. Each job runs ffmpeg 8.1 on ReelSDK for up to 10 min, and each tool call waits up to 50 s before it hands back a job id for get_job.
A skill is a folder in .claude/skills with a SKILL.md. Its description helps Claude decide when to load it, and Claude Code cuts the listing text at 1,536 characters, so the use case goes first. The 13-line skill below sends every trim, crop, caption, GIF or slideshow request to the MCP tools and keeps it off the Bash tool. Raw ffmpeg jobs cost $0.02 per compute minute, captions $0.03 per output minute.
Settings that matter for video work
| Setting | Default | Effect |
|---|---|---|
BASH_DEFAULT_TIMEOUT_MS | 120000 (2 min) | A Bash command stops here unless Claude asks for longer |
BASH_MAX_TIMEOUT_MS | 600000 (10 min) | The longest Bash timeout Claude can ask for |
MAX_MCP_OUTPUT_TOKENS | 25000 | Tool output past 10,000 tokens gets a warning |
| Skill description | 1,536 characters | Longer text is cut in the skill listing |
REELSDK_WAIT_S | 50 s, up to 300 | How long a ReelSDK tool waits before it returns a job id |
Claude Code limits from Claude Code environment variables, checked November 2026.
Set it up
A server, a skill, a request
Both pieces live in the project, so the whole team gets them from the repo. The server needs Node 20 or newer and git, and starts from GitHub with npx.
Add the MCP server
Run the command in the fix block with your key. To share the server with the team, add it with
--scope project: Claude Code writes a.mcp.jsonlike this at the project root, and${REELSDK_KEY}expands from each developer's environment. Without the variable, Claude Code warns and passes the literal text..mcp.json { "mcpServers": { "reelsdk": { "command": "npx", "args": ["-y", "github:bitgate/reelsdk-mcp"], "env": { "REELSDK_KEY": "${REELSDK_KEY}" } } } }Add the skill
Save this as
.claude/skills/video-editing/SKILL.mdin the project, or under~/.claude/skillsfor every project. Thedescriptionnames the edits that should go to ReelSDK; the body tells Claude which tool does what..claude/skills/video-editing/SKILL.md --- name: video-editing description: Edit video with the ReelSDK MCP tools instead of a local ffmpeg. Use when the user asks to trim, crop, resize, compress, convert or caption a video, extract its audio, make a GIF or a slideshow, or turn a topic into a short. --- Use the ReelSDK MCP tools for video work. Don't install ffmpeg or run it through Bash. - Captions: call add_captions with the file path or URL. - Any other edit: call run_ffmpeg. Name each input in `inputs`, refer to those names in `args` and list every file you write in `outputs`. No absolute paths and no URLs inside `args`. - Photos to video: make_slideshow. A topic or a script to a finished short: make_short. - If a tool says the job is still running, call get_job with the job id until it finishes. - Finished files land in ./reelsdk-output. Tell the user the paths. - A local file over 100 MiB is over the upload limit: ask for a URL instead.Ask for an edit
Ask Claude to caption a clip or cut a vertical teaser from it. For captions it calls
add_captions, which uploads the clip and returns a captioned video, a transcript, an srt and vtt and ass captions, saved to./reelsdk-output, in about 17 seconds for a 20-second clip.
FAQ
Video on Claude Code, answered
How do I give Claude Code video editing tools?
Add the ReelSDK MCP server with claude mcp add reelsdk --env REELSDK_KEY=rsdk_live_... -- npx -y github:bitgate/reelsdk-mcp, then add a SKILL.md in .claude/skills/video-editing that tells Claude to use those tools for video. Claude then has 6 tools: add_captions, make_slideshow, make_short, run_ffmpeg, get_job and upload_file.
Why does a long ffmpeg command stop in Claude Code?
Claude Code's Bash tool stops a command after 2 min by default and allows 10 min at most, set by BASH_DEFAULT_TIMEOUT_MS and BASH_MAX_TIMEOUT_MS. A ReelSDK tool call returns within 50 s by default, and a job that runs longer comes back with its id for get_job.
Do I need ffmpeg installed for this?
No. The tools run ffmpeg 8.1 on ReelSDK and save the results to ./reelsdk-output. The MCP server needs Node 20 or newer and git to install.
Can I share the setup with my team?
Yes. claude mcp add --scope project writes a .mcp.json at the project root, and ${REELSDK_KEY} in it expands from each developer's environment. Commit it with the .claude/skills folder and keep the key itself out of the repo.
What does video editing through ReelSDK cost?
Raw ffmpeg jobs cost $0.02 per compute minute, billed by the second, and failed jobs are free. Captions and slideshows cost $0.03 per output minute, and a short up to 60 s costs $0.30.
The same fix on other platforms
All integrationsReady to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
