Edit title, caption and keywords
Set the title, caption or keywords of one or more photos.
MCP tool smugmug_write → update_photo_details
write
Applies the same values to every photo in photo_ids and returns the previous caption of each, so a mistake is one call away from undone. It does not send anything to other people, so it needs no confirmation. On a public gallery the new text is visible to visitors and to search. Filenames cannot be edited.
Parameters
| Name | Type | Description |
|---|---|---|
| photo_ids array required | array | Photo IDs from list_gallery_photos. |
| title string | string | New title for every photo in photo_ids. |
| caption string | string | Caption text, up to 65,000 characters. |
| caption_mode string | string | How to treat an existing caption: 'replace' (default), 'before' or 'after'. |
| keywords_add array | array | Keywords to add. Existing keywords stay. |
| keywords_remove array | array | Keywords to remove from these photos only. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "smugmug_write",
"arguments": {
"operation": "update_photo_details",
"arguments": {
"photo_ids": [
"Qm7xKd",
"Rt2nWc"
],
"caption": "Lakeview 10K, finish line.",
"caption_mode": "after",
"keywords_add": [
"running",
"lakeview",
"finish line"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"updated": 2,
"photos": [
{
"photo_id": "Qm7xKd",
"filename": "DSC_3025.jpg",
"caption": "Lakeview 10K, finish line.",
"keywords": [
"running",
"lakeview",
"finish line"
],
"previous_caption": ""
},
{
"photo_id": "Rt2nWc",
"filename": "DSC_3026.jpg",
"caption": "First dance Lakeview 10K, finish line.",
"keywords": [
"wedding",
"running",
"lakeview",
"finish line"
],
"previous_caption": "First dance"
}
]
},
"isError": false
}