x

apps/mcp-server/README.md

@@ -129,11 +129,16 @@ th, en, ja, zh, vi, ko, lo, it
 LLM agents should use this workflow for category edits:
 
 1. `list_categories` with `lang: "all"` to discover category IDs and current translations
-2. `create_category`, `update_category`, `update_category_translations`, or `delete_category` with `dryRun: true`
+2. `create_category`, `update_category`, `update_category_media`, `update_category_translations`, or `delete_category` with `dryRun: true`
 3. Review the preview and product counts
 4. Apply only after the intended change is clear
 5. Run `list_categories` again to verify
 
+Category media uses semantic roles: `thumbnail`, `hero_desktop`, `hero_mobile`,
+`card_portrait`, and `social_share`. `update_category_media` replaces the complete
+media set, so omitted roles are removed. `update_category_image` remains available
+only as a legacy thumbnail compatibility tool.
+
 Backend category support currently covers:
 
 - base `name`