What you get
Once configured, Claude Code gains four native tools it calls automatically when a task involves video or images:
| Tool | What it does |
|---|---|
create_task | Submits an async video enhancement task (upscaling, quality enhancement) |
get_task_status | Polls task progress and returns the result URL when done |
enhance_video_sync | Synchronous enhancement for short clips (50s truncation limit) |
sam3_predict | SAM3 segmentation: text prompt → masks, boxes, confidence scores |
Setup in one command
Paste this into a Claude Code session and confirm:
Install @avclabs.ai/media-mcp as an MCP server
Or add it manually to ~/.claude.json (Windows: %USERPROFILE%\.claude.json):
{
"mcpServers": {
"video-enhancement": {
"command": "npx",
"args": ["-y", "@avclabs.ai/media-mcp@latest"],
"env": { "API_KEY": "your-api-key" }
}
}
}Requires Node.js ≥ 18 and an API key from the dashboard (free quota included, no credit card).
Example prompts
- "Upscale this video to 1080p: https://example.com/demo.mp4"
- "Enhance the quality of screen-recording.mp4 and notify me when it's done"
- "Find and mask all people in ./assets/group-photo.jpg"
Claude picks async mode for long videos automatically, polls the task, and hands you the result URL when processing finishes.
Why MCP instead of raw API calls
With a raw HTTP API you write the polling loop, error handling and file handling yourself. With the MCP server, Claude Code owns the workflow: it chooses sync vs async mode, retries with get_task_status when a call truncates, and chains segmentation results into the next step of your task — all from a single sentence.