Image Enhancement Tools
@avclabs.ai/image-mcp · Node.js >=18 · MIT License
Image Enhancement
This standalone package is not on npm yet; these tools are available today in the all-in-one package.
Synchronously enhance an image (blocks until completion). Supports 1–4x upscaling via scale. If the task does not finish within 45 seconds, the tool returns early with a task_id; keep polling with get_image_task_status.
Parameter
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| image_source | string | Yes | - | Image URL or local file path |
| type | string | No | url | Upload type: url / local |
| scale | integer | No | 2 | Upscale factor, integer 1–4 (2 = upscale to 2x) |
| poll_interval | number | No | 5 | Polling interval (seconds) |
| timeout | number | No | 45 | Synchronous wait timeout (seconds), returns early after exceeding |
Request Example
{
"image_source": "https://example.com/photo.jpg",
"type": "url",
"scale": 2,
"poll_interval": 5,
"timeout": 45
}Truncated return example (not completed within 45s)
{
"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_image_task_status with this task_id."
}Synchronously colorize a black-and-white photo (blocks until completion). Same parameters and 45-second truncation as enhance_image_sync, except there is no scale parameter.
Parameter
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| image_source | string | Yes | - | Image URL or local file path |
| type | string | No | url | Upload type: url / local |
| poll_interval | number | No | 5 | Polling interval (seconds) |
| timeout | number | No | 45 | Synchronous wait timeout (seconds), returns early after exceeding |
Request Example
{
"image_source": "https://example.com/old-photo.jpg",
"type": "url"
}Synchronously remove image noise and grain (blocks until completion). Same parameters and 45-second truncation as enhance_image_sync, except there is no scale parameter.
Parameter
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| image_source | string | Yes | - | Image URL or local file path |
| type | string | No | url | Upload type: url / local |
| poll_interval | number | No | 5 | Polling interval (seconds) |
| timeout | number | No | 45 | Synchronous wait timeout (seconds), returns early after exceeding |
Query image task status. status is one of processing / completed / failed; on completion the result contains image_url.
Parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Task ID |
Returns:
{
"success": true,
"task_id": "xxx",
"status": "completed",
"progress": 100,
"image_url": "https://..."
}Related tool pages: Video Enhancement · Image Segmentation (SAM3)
