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
What a Bash command gets on a machine without ffmpeg (exit code 127)

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
claude mcp get reelsdk reports Status: Connected, Type: stdioTry it

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

Settings that matter for video work
SettingDefaultEffect
BASH_DEFAULT_TIMEOUT_MS120000 (2 min)A Bash command stops here unless Claude asks for longer
BASH_MAX_TIMEOUT_MS600000 (10 min)The longest Bash timeout Claude can ask for
MAX_MCP_OUTPUT_TOKENS25000Tool output past 10,000 tokens gets a warning
Skill description1,536 charactersLonger text is cut in the skill listing
REELSDK_WAIT_S50 s, up to 300How 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.

  1. 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.json like 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}" }
        }
      }
    }
    
  2. Add the skill

    Save this as .claude/skills/video-editing/SKILL.md in the project, or under ~/.claude/skills for every project. The description names 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.
    
  3. 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.

All integrations

Ready to build?

Ship video from your app today

Your first $0.50 is free, and one key covers every endpoint.

Moonlit lake with a lit cabin under the mountains