save_image
Downloads a WhatsApp image from a chat and saves it to disk. Provide chatId and msgId from recent messages to get the image file path.
Instructions
Save a single WhatsApp image to disk. Pass the chatId + msgId from a get_recent_messages result. Default folder: /data/media//, named __.jpg. Returns the absolute path as a resource_link. On failure returns {ok:false, code, error} where code is one of: not_found, not_image, no_keys, media_expired, download_failed, disk_error, permission_denied, disk_full, timeout. The MCP response sets isError:true on failure.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chatId": "<chatId>",
"msgId": "<msgId>"
},
"name": "save_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| msgId | Yes | ||
| chatId | Yes | ||
| folder | No | Absolute path where the file should land. Defaults to <project>/data/media/<date>/. | |
| filename | No | Override the filename. Path separators not allowed. | |
| timeoutMs | No | Per-download timeout. Default 30s for images. | |
| skipIfExists | No | If a file with the same name already exists, return its path without re-downloading. |