tag_image
Manage persistent tags for indexed images within a scratchpad session: add, remove, list, show, or clear tags on targets like p1, v2, filenames, or absolute paths.
Instructions
Manage persistent tags for indexed images through the configured image server.
Examples:
{ "action": "add_tag", "target": "p1", "tags": ["favorite"] }
{ "action": "remove_tag", "target": ["p1", "v2", "/absolute/path/image.png"], "tags": ["favorite", "reviewed"] }
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": {
"scratchpadFolder": "<scratchpadFolder>",
"action": "<action>"
},
"name": "tag_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tags to add or remove. Use an array for multiple tags. | |
| action | Yes | list_tags lists all indexed tags; show_tag lists current tags; add_tag adds tags; remove_tag removes named tags; remove_all_tags clears every tag from each target. | |
| target | No | One or more indexed image references: vN, iN, pN, a filename in the scratchpad folder, or an absolute image path. Use an array for multiple targets. | |
| scratchpadFolder | Yes | Required scratchpad session folder. Obtain this value with get_scratchpad_folder. |