AVCLabs Media MCP

"Improve the quality of /Users/me/Desktop/video.mp4 to 2k"

"Colorize this black-and-white photo: /Users/me/Desktop/old_photo.png"

"Remove noise from this image: C:\Users\xxx\noisy.jpg"

"Analyze this image and find all objects: C:\Users\xxx\photo.png"

"Use SAM3 to segment this image, prompt: 'find all cars'"

The agent will automatically choose sync or async tools based on task complexity.

Create an asynchronous video enhancement task.

Recommended for most use cases.Ideal for longer videos (over 10 seconds) to avoid timeouts and blocking the connection.

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

The returnedstatusfield can be:processing,completed, orfailed. Ifstatusisprocessing, you need to wait a few seconds and call this tool again.

{ "success": true, "task_id": "xxx", "status": "completed", "progress": 100, "video_url": "https://...", "message": "Task is still processing, please check again later" }

Themessagefield only appears whenstatusisprocessing, prompting the Agent to continue waiting.

Synchronously enhance video (blocks until completion).

Best for short videos (estimated processing time < 1 minute).If the task is not completed within 50 seconds, the tool returns early with atask_id, and you need to useget_task_statusto continue querying.

Truncated return example (not completed within 50s):

{ "success": true, "status": "processing", "task_id": "xxx", "message": "Task is still processing (waited 50 seconds). Please use get_task_status to continue polling.", "note": "The synchronous wait for this long-running task has been truncated. Switch to get_task_status polling." }

Three image processing tools are provided, each targeting a specific use case:

All three tools share the same parameters and behavior pattern. They aresynchronous— the tool blocks until the image is processed or the timeout is reached.

Supported image formats: PNG, JPG, JPEG, BMP, WebP, etc.
- URL upload: provide a publicly accessible image URL (type: "url")
- Local upload: provide a local file path, the MCP Server auto-uploads to TOS object storage (type: "local", max file size: 100MB)

Synchronously enhance an image to improve quality and optimize faces.

The tool internally creates a task and polls for the result. If processing completes within the timeout (default 50s), the result is returned directly. If not, the tool returns early with atask_id— useget_image_task_statusto continue polling.

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

Truncated return (not completed within 50s):

{ "success": true, "status": "processing", "task_id": "xxx", "message": "Task is still processing (waited 50 seconds). Please use get_image_task_status to continue polling.", "note": "The synchronous wait for this long-running task has been truncated. Switch to get_image_task_status polling." }

Synchronously colorize a black-and-white photo with AI.

Best for old black-and-white photos. The AI will add realistic colors to the image. Supports the same parameters and return format asenhance_image_sync.

Returns:Same format asenhance_image_sync.

Synchronously remove noise from an image.

Best for grainy/noisy photos taken in low-light conditions or with high ISO settings. Supports the same parameters and return format asenhance_image_sync.

Returns:Same format asenhance_image_sync.

Query image processing task status. Used to poll for results when a sync tool times out.

The returnedstatusfield can be:processing,completed, orfailed. Ifstatusisprocessing, wait a few seconds and call this tool again.

{ "success": true, "task_id": "xxx", "status": "completed", "progress": 100, "image_url": "https://...", "message": "Task is still processing, please check again later" }

Themessagefield only appears whenstatusisprocessing, prompting the Agent to continue waiting.
- For most images: Callenhance_image_sync/colorize_image_sync/denoise_image_syncdirectly — the tool handles everything and returns the result
- If truncated: The tool returns atask_id, then useget_image_task_statusto poll untilstatusbecomescompletedorfailed
- If failed: Check theerror_messagefield for details

Analyze an image using the SAM3 segmentation API to generate inference results (masks, boxes, scores).

Image input (choose one, must provide exactly one):

-

imagePath(string): Absolute path of a local image file. Supports common formats (PNG, JPG, JPEG).

- Example:"C:\\Users\\xxx\\photo.png","/home/user/images/cat.jpg"
- Use when: The user explicitly provides a local file path

imageUrl(string): Publicly accessible URL of the image.

- Example:"https://example.com/photo.jpg"
- Use when: The image is already online and the user provides a link
- Note: The URL must be publicly accessible. Links requiring login or signatures are not supported

imageBase64(string): Base64-encoded image data.

- Example:"iVBORw0KGgoAAAANSUhEUgAA..."
- Use when: The user drags or uploads an image attachment, and the Agent encodes it as base64
- Note: Large images will produce very large base64 strings, which may slow transmission

- prompt(string, required): English text prompt specifying the target object to segment. Since the SAM3 model only accepts English prompts, provide an English description. If the user provides Chinese or other non-English text, the Agent will automatically translate it before calling the tool.

After inference completes, returns a JSON string containing three fields:

-

masks: 2D array. Each element is a binary mask (values 0 or 1) with the same dimensions as the input image, marking the pixel-level location of detected objects. The i-th mask corresponds to the i-th detected object instance.