diff --git a/README.md b/README.md
index 6c556e46f..3784da0ab 100644
--- a/README.md
+++ b/README.md
@@ -259,7 +259,8 @@ lightcraft --control 7980 ~/Pictures/trip
 - **Command registry.** `engine.commands` lists the available commands; `develop.controls` lists every slider's
   range, default and current value.
 - **MCP server.** `lightcraft-cli mcp` exposes the command registry to Claude (or any MCP client), alongside
-  helpers for import, query, develop, mask, render (returned as an image) and export. It runs headless, or attached
+  helpers for import, query, develop, render (returned as an image) and export. Masks have no helper of their own:
+  create and edit them through `run_command` (e.g. `mask.add`). It runs headless, or attached
   to the running app with screenshots, clicks and gestures. See [docs/mcp.md](docs/mcp.md).
 
   ```sh
diff --git a/README.zh-hans.md b/README.zh-hans.md
index fa782ba10..d00a97cad 100644
--- a/README.zh-hans.md
+++ b/README.zh-hans.md
@@ -241,7 +241,7 @@ lightcraft --control 7980 ~/Pictures/trip
 - **命令注册表。** `engine.commands` 列出可用命令；`develop.controls` 列出每个滑块的范围、
   默认值和当前值。
 - **MCP 服务器。** `lightcraft-cli mcp` 把命令注册表开放给 Claude（或任何 MCP 客户端），
-  同时提供导入、查询、显影、蒙版、渲染（以图像返回）和导出的辅助工具。它既能无界面运行，也能附着
+  同时提供导入、查询、显影、渲染（以图像返回）和导出的辅助工具。蒙版没有专门的辅助工具，请通过 `run_command` 使用（例如 `mask.add`）。它既能无界面运行，也能附着
   到正在运行的应用上，支持截图、点击和手势。见 [docs/mcp.md](docs/mcp.md)。
 
   ```sh
diff --git a/README.zh-hant.md b/README.zh-hant.md
index 07ac908d2..2927b217f 100644
--- a/README.zh-hant.md
+++ b/README.zh-hant.md
@@ -240,7 +240,7 @@ lightcraft --control 7980 ~/Pictures/trip
 - **指令註冊表。** `engine.commands` 列出可用的指令；`develop.controls` 列出每個滑桿的範圍、
   預設值與目前值。
 - **MCP 伺服器。** `lightcraft-cli mcp` 把指令註冊表開放給 Claude（或任何 MCP 用戶端），
-  同時提供匯入、查詢、顯影、遮色片、算繪（以影像回傳）與匯出的輔助工具。它可以無介面執行，也可以附掛
+  同時提供匯入、查詢、顯影、算繪（以影像回傳）與匯出的輔助工具。遮色片沒有專屬的輔助工具，請透過 `run_command` 使用（例如 `mask.add`）。它可以無介面執行，也可以附掛
   到正在執行的應用程式上，支援截圖、點擊與手勢。詳見 [docs/mcp.md](docs/mcp.md)。
 
   ```sh