Video Enhancement Tools

@avclabs.ai/video-mcp · Node.js >=18 · MIT License

Video Enhancement

Package:@avclabs.ai/video-mcp· 3 toolsComing soon

This standalone package is not on npm yet; these tools are available today in the all-in-one package.

The following MCP Tools are provided:

<>create_taskCreate a video enhancement task (supports URL or local file upload)

Create a video enhancement task (async).

Parameter

Parameter	Type	Required	Default	Description
video_source	string	Yes	-	Video URL or local file path
type	string	No	url	Upload type: url / local
resolution	string	No	720p	Target resolution: 480p, 540p, 720p, 1080p, 2k

Request Example

json

{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p"
}

Response Example

json

{
  "success": true,
  "task_id": "xxx",
  "status": "processing"
}

<>get_task_statusQuery task status

Query video enhancement task status. The status field in the return value may be: processing, completed, or failed. If status is processing, you need to wait a few seconds and call this tool again to poll.

Parameter

Parameter	Type	Required	Description
task_id	string	Yes	Task ID

Returns:

json

{
  "success": true,
  "task_id": "xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://..."
}

<>enhance_video_syncSynchronously enhance video (block until completion, default 45s truncation)

Synchronously enhance video (block until completion). Only suitable for short videos (estimated processing time < 1 minute). If the task is not completed within 45 seconds, the tool will return early and include task_id. You need to use get_task_status to continue querying.

Parameter

Parameter	Type	Required	Default	Description
video_source	string	Yes	-	Video URL or local file path
type	string	No	url	Upload type: url / local
resolution	string	No	720p	Target resolution: 480p, 540p, 720p, 1080p, 2k
poll_interval	number	No	5	Polling interval (seconds)
timeout	number	No	45	Synchronous wait timeout (seconds), returns early after exceeding

Request Example

json

{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p",
  "poll_interval": 5,
  "timeout": 45
}

Truncated return example (not completed within 45s)

json

{
  "success": true,
  "status": "processing",
  "task_id": "xxx",
  "message": "Task is still processing (waited 45 seconds, 3 status queries).",
  "note": "The synchronous wait was truncated; the task keeps running. Poll get_task_status with this task_id."
}

Image Segmentation (SAM3) → sam3_predict