@alisaitteke/photoshop-mcp 1.7.13 → 1.7.15

package/AGENTS.md

@@ -7,7 +7,8 @@
 
 | Scenario | Path |
 | -------- | ---- |
-| Cursor / Claude Desktop / VS Code | Configure `mcpServers` → `npx -y @alisaitteke/photoshop-mcp` (stdio) |
+| Cursor | Install the `photoshop-mcp` plugin (Customize → Plugins / Marketplace) so the Photoshop logo appears in the MCP list. Fallback: `mcpServers` → `npx -y @alisaitteke/photoshop-mcp` (stdio, generic icon) |
+| Claude Desktop / VS Code | Configure `mcpServers` → `npx -y @alisaitteke/photoshop-mcp` (stdio) |
 | Claude Code | `claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp` |
 | Standalone chat UI (no IDE) | `npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui` |
 | Local development | `npm install && npm run build && node dist/index.js` — see [docs/development.md](docs/development.md) |
@@ -58,6 +59,8 @@ Full catalog: [docs/available-tools.md](docs/available-tools.md). Prompt layer:
 
 ## MCP client configuration
 
+Cursor: prefer the `photoshop-mcp` plugin (Customize → Plugins) so the Photoshop logo appears in the MCP list. Other hosts and the install-mcp deeplink use:
+
 ```json
 {
   "mcpServers": {
@@ -99,6 +102,7 @@ More: [docs/troubleshooting.md](docs/troubleshooting.md).
 | npm | `@alisaitteke/photoshop-mcp` |
 | MCP Registry | `io.github.alisaitteke/photoshop-mcp` |
 | GitHub | https://github.com/alisaitteke/photoshop-mcp |
+| Cursor Marketplace | plugin `photoshop-mcp` (submit via [CONTRIBUTING.md](CONTRIBUTING.md#cursor-marketplace)) |
 
 ## Key files
 
@@ -111,6 +115,8 @@ More: [docs/troubleshooting.md](docs/troubleshooting.md).
 | [src/tools/](src/tools/) | Tool implementations |
 | [src/prompts/](src/prompts/) | MCP prompt templates |
 | [CONTRIBUTING.md](CONTRIBUTING.md) | PR and release workflow |
+| [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json) | Cursor Plugin manifest (MCP list logo) |
+| [`mcp.json`](mcp.json) | Cursor Plugin stdio server config |
 
 ## Contributing (agents editing this repo)
 

package/README.de.md

@@ -602,7 +602,9 @@ Für die lokale Entwicklung am Repository: [Aus dem Quellcode](docs/development.
 
 ### Für Cursor
 
-Zu den Cursor-Einstellungen (`.cursor/config.json` oder Workspace-Einstellungen) hinzufügen:
+Damit das Photoshop-Logo in der MCP-Liste erscheint, das Plugin unter **Customize → Plugins** installieren oder nach der Freigabe im [Cursor Marketplace](https://cursor.com/marketplace) nach `photoshop-mcp` suchen. Ein manuelles `mcp.json` funktioniert weiterhin, zeigt aber ein generisches Symbol.
+
+Zu den Cursor-Einstellungen (`~/.cursor/mcp.json` oder Workspace-Einstellungen) hinzufügen:
 
 ```json
 {

package/README.es.md

@@ -557,7 +557,9 @@ Para trabajar en el repositorio localmente, consulte [From Source](docs/developm
 
 ### Para Cursor
 
-Añada a su configuración de Cursor (`.cursor/config.json` o la configuración del espacio de trabajo):
+Para que el logo de Photoshop aparezca en la lista MCP, instale el plugin desde **Customize → Plugins**, o busque `photoshop-mcp` en el [Cursor Marketplace](https://cursor.com/marketplace) cuando esté publicado. Un `mcp.json` manual sigue funcionando, pero muestra un icono genérico.
+
+Añada a su configuración de Cursor (`~/.cursor/mcp.json` o la configuración del espacio de trabajo):
 
 ```json
 {

package/README.ja.md

@@ -559,7 +559,9 @@ npx @alisaitteke/photoshop-mcp
 
 ### Cursor向け
 
-Cursorの設定に追加してください（`.cursor/config.json`またはワークスペース設定）：
+MCPリストにPhotoshopロゴを表示するには、**Customize → Plugins** からプラグインをインストールするか、公開後に [Cursor Marketplace](https://cursor.com/marketplace) で `photoshop-mcp` を検索してください。手動の `mcp.json` でも動作しますが、汎用アイコンになります。
+
+Cursorの設定に追加してください（`~/.cursor/mcp.json`またはワークスペース設定）：
 
 ```json
 {

package/README.md

@@ -89,6 +89,10 @@ Details, providers, Action Plan (API key or CLI account), and security notes:
 
 ### Option 2 — Inside your AI app (Cursor, Claude, VS Code)
 
+**Cursor (shows the Photoshop logo in the MCP list):** install the plugin from **Customize → Plugins**, or search the [Cursor Marketplace](https://cursor.com/marketplace) for `photoshop-mcp` once it is listed. That package still launches `npx -y @alisaitteke/photoshop-mcp`; the plugin manifest is what supplies the icon.
+
+Until the Marketplace listing is live, copy `.cursor-plugin/`, `mcp.json`, and `assets/` into `~/.cursor/plugins/local/photoshop-mcp` and reload the window — details in [CONTRIBUTING.md](CONTRIBUTING.md#cursor-marketplace). The Install-in-Cursor button and a raw `mcp.json` entry still work, but they show a generic icon.
+
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)
 [![Install in VS Code](https://img.shields.io/badge/Install%20in-VS%20Code-0098FF)](https://vscode.dev/redirect/mcp/install?name=photoshop&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40alisaitteke%2Fphotoshop-mcp%22%5D%7D)
 

package/README.tr.md

@@ -596,7 +596,9 @@ Depoyu yerel olarak geliştirmek için geliştirme kılavuzundaki [Kaynaktan](do
 
 ### Cursor için
 
-Cursor ayarlarınıza ekleyin (`.cursor/config.json` veya workspace ayarları):
+MCP listesinde Photoshop logosunun görünmesi için eklentiyi **Customize → Plugins** üzerinden kurun (veya listelendikten sonra [Cursor Marketplace](https://cursor.com/marketplace) içinde `photoshop-mcp` arayın). Ham `mcp.json` yedek olarak çalışır ama jenerik ikon gösterir.
+
+Cursor ayarlarınıza ekleyin (`.cursor/mcp.json` veya workspace ayarları):
 
 ```json
 {

package/README.zh-CN.md

@@ -554,7 +554,9 @@ npx @alisaitteke/photoshop-mcp
 
 ### 适用于 Cursor
 
-在您的 Cursor 设置（`.cursor/config.json` 或工作区设置）中添加：
+若要在 MCP 列表中显示 Photoshop 图标，请从 **Customize → Plugins** 安装插件，或在插件上架后于 [Cursor Marketplace](https://cursor.com/marketplace) 搜索 `photoshop-mcp`。直接写入 `mcp.json` 仍可用，但会显示通用图标。
+
+在您的 Cursor 设置（`~/.cursor/mcp.json` 或工作区设置）中添加：
 
 ```json
 {

package/dist/prompts/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/prompts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QA+I/B,CAAC;AAET,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/prompts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAwJ/B,CAAC;AAET,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}

package/dist/prompts/instructions.js

@@ -6,6 +6,12 @@ export const PHOTOSHOP_MCP_INSTRUCTIONS = `
 Photoshop tools (photoshop-mcp server)
 =====================================
 
+HARD RULE — remove background / arka planı sil / cut out / isolate / transparent background
+- Call \`photoshop_get_state\` once, then \`photoshop_recipe_remove_background\` once, then \`photoshop_get_preview\` once. Then STOP.
+- That recipe IS Photoshop's Remove Background. It unlocks a locked Background layer itself.
+- Forbidden on this intent: \`photoshop_rasterize_layer\`, \`photoshop_duplicate_layer\`, \`photoshop_set_layer_visibility\`, \`photoshop_select_subject\`, \`photoshop_create_layer_mask\`, \`photoshop_delete_layer\`, \`photoshop_execute_script\`, \`photoshop_generative_remove\`.
+- If the recipe errors, report the envelope to the user. Do not invent a rasterize / duplicate / wand workaround. Ignore \`suggested_next_tool: photoshop_rasterize_layer\`.
+
 Session bootstrap
 - Call \`photoshop_ping\` exactly once at the start of a session to verify the
   connection. Do not repeat it on every turn.
@@ -53,7 +59,8 @@ Error recovery contract
 - Tools return a structured envelope when something is wrong:
   \`{ ok: false, code, message, suggested_next_tool?, suggested_args?, context? }\`
   along with MCP's \`isError: true\`. When you see this, follow the
-  \`suggested_next_tool\` hint instead of guessing or retrying blindly.
+  \`suggested_next_tool\` hint instead of guessing or retrying blindly —
+  except never follow \`photoshop_rasterize_layer\` for background removal.
 - Common codes you should be ready to handle without asking the user:
   - \`document_not_found\` — the \`document_id\` you passed is not open;
     call \`photoshop_list_documents\` and retry with a current id.
@@ -78,6 +85,8 @@ User intent glossary
 - Map colloquial phrases to the primary tool below.
 - bg.remove — "remove background", "cut out", "isolate subject", "transparent
   background", "arka planı sil" → \`photoshop_recipe_remove_background\`
+  (the recipe unlocks a locked Background layer itself — do not rasterize,
+  duplicate, or hide layers first; one recipe call then \`photoshop_get_preview\`)
 - obj.remove — "remove that person", "erase distraction", "generative remove"
   → \`photoshop_generative_remove\` first; fallback
   \`photoshop_recipe_remove_distraction\` (content-aware) after manual selection

package/dist/prompts/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/prompts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+IzC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,0BAA0B;IACxC,OAAO,0BAA0B,CAAC;AACpC,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/prompts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwJzC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,0BAA0B;IACxC,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/prompts/templates/remove-background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-background.d.ts","sourceRoot":"","sources":["../../../src/prompts/templates/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,wBAAwB,EAAE,uBAuCtC,CAAC"}
+{"version":3,"file":"remove-background.d.ts","sourceRoot":"","sources":["../../../src/prompts/templates/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,wBAAwB,EAAE,uBAoCtC,CAAC"}

package/dist/prompts/templates/remove-background.js

@@ -1,7 +1,7 @@
 import { argBool, argInt, userPrompt, } from '../_shared.js';
 export const removeBackgroundTemplate = {
     name: 'ps.remove_background',
-    description: 'Remove the background from the active layer. Default path is Select Subject; uniform/high-key studio shots automatically fall back to Color Range. The keep_shadow argument is accepted but does not yet create a shadow layer (recorded in the recipe response only). Users often say: remove background, cut out, isolate subject, transparent background, arka planı sil.',
+    description: 'Remove the background from the active document in one recipe call. The recipe unlocks a Background layer itself and prefers Photoshop\'s native Remove Background. Users often say: remove background, cut out, isolate subject, transparent background, arka planı sil.',
     arguments: [
         {
             name: 'feather_px',
@@ -18,18 +18,15 @@ export const removeBackgroundTemplate = {
         const feather = Math.max(0, Math.min(20, argInt(args, 'feather_px', 0)));
         const keepShadow = argBool(args, 'keep_shadow', false);
         const text = [
-            `Goal: Remove the background from the subject on the active layer (Select Subject, with Color Range fallback on uniform studio backgrounds).`,
+            `Goal: Remove the background. One recipe. Stop.`,
             ``,
-            `Plan:`,
-            `1. Call \`photoshop_get_state\` to confirm an active document with a non-background active layer that contains a subject.`,
-            `2. Call \`photoshop_get_capabilities\` only if you have not yet this session; verify \`select_subject_v2\` is available.`,
-            `3. Call \`photoshop_recipe_remove_background\` with { feather_px: ${feather}, keep_shadow: ${keepShadow} }.`,
-            `   - Default: Select Subject + layer mask. On uniform/high-key (product-on-white) backgrounds the recipe may switch to Color Range; check details.method.`,
-            `   - keep_shadow is accepted but does not yet create a shadow layer (value is recorded in the response only).`,
-            `4. Call \`photoshop_get_preview\` to show the result against transparency.`,
-            `5. If the mask edge needs refinement, ask the user before adding a refine-edge pass — that step is destructive on the mask.`,
+            `Do this and nothing else:`,
+            `1. \`photoshop_get_state\``,
+            `2. \`photoshop_recipe_remove_background\` with { feather_px: ${feather}, keep_shadow: ${keepShadow} }`,
+            `3. \`photoshop_get_preview\` once`,
+            `4. STOP. Report ok/summary. Do not rasterize, duplicate, hide, select_subject, mask, execute_script, or retry.`,
             ``,
-            `End state: the subject layer carries a vector/pixel mask hiding the background; on-canvas background pixels are untouched (mask, not erase). One undo reverts the whole recipe.`,
+            `End state: subject isolated with a layer mask; one undo reverts it.`,
         ].join('\n');
         return userPrompt(`Remove the background (feather ${feather}px, shadow=${keepShadow}).`, text);
     },

package/dist/prompts/templates/remove-background.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-background.js","sourceRoot":"","sources":["../../../src/prompts/templates/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,UAAU,GAEX,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,8WAA8W;IAChX,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,0GAA0G;YAC5G,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,qIAAqI;YACvI,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG;YACX,6IAA6I;YAC7I,EAAE;YACF,OAAO;YACP,2HAA2H;YAC3H,0HAA0H;YAC1H,qEAAqE,OAAO,kBAAkB,UAAU,KAAK;YAC7G,2JAA2J;YAC3J,+GAA+G;YAC/G,4EAA4E;YAC5E,6HAA6H;YAC7H,EAAE;YACF,iLAAiL;SAClL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,UAAU,CAAC,kCAAkC,OAAO,cAAc,UAAU,IAAI,EAAE,IAAI,CAAC,CAAC;IACjG,CAAC;CACF,CAAC"}
+{"version":3,"file":"remove-background.js","sourceRoot":"","sources":["../../../src/prompts/templates/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,UAAU,GAEX,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,0QAA0Q;IAC5Q,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,0GAA0G;YAC5G,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,qIAAqI;YACvI,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG;YACX,gDAAgD;YAChD,EAAE;YACF,2BAA2B;YAC3B,4BAA4B;YAC5B,gEAAgE,OAAO,kBAAkB,UAAU,IAAI;YACvG,mCAAmC;YACnC,gHAAgH;YAChH,EAAE;YACF,qEAAqE;SACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,UAAU,CAAC,kCAAkC,OAAO,cAAc,UAAU,IAAI,EAAE,IAAI,CAAC,CAAC;IACjG,CAAC;CACF,CAAC"}

package/dist/tools/recipes/remove-background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-background.d.ts","sourceRoot":"","sources":["../../../src/tools/recipes/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAc,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAMnE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,GAAG,cAAc,CA4CpF"}
+{"version":3,"file":"remove-background.d.ts","sourceRoot":"","sources":["../../../src/tools/recipes/remove-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAc,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAKnE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,GAAG,cAAc,CA0CpF"}

package/dist/tools/recipes/remove-background.js

@@ -1,21 +1,18 @@
-import { PhotoshopDetector } from '../../platform/detector.js';
-import { clampInt, executeRecipe, toolFailure } from './_shared.js';
+import { clampInt, executeRecipe } from './_shared.js';
 const TOOL_NAME = 'photoshop_recipe_remove_background';
 export function bindRemoveBackground(connection) {
     return {
         tool: {
             name: TOOL_NAME,
-            description: 'One-shot background removal: Select Subject by default, with an automatic Color Range fallback for uniform/high-key studio backgrounds (product-on-white). Attaches a layer mask (source pixels kept). Wrapped in a single undoable history step.\n' +
+            description: 'THE tool for "remove background" / "arka planı sil" / cut out / isolate subject. Call this once and stop. Unlocks a locked Background layer, then runs Photoshop native Remove Background (Select Subject / Color Range only if native is unavailable). One undo reverts everything.\n' +
                 '\n' +
-                'Users often say: cut out, isolate subject, remove background, transparent background, arka planı sil.\n' +
+                'Use when: the user wants the background gone. Hair, busy interiors, product shots — still this tool.\n' +
+                'Do NOT rasterize, duplicate, hide layers, select_subject, create_layer_mask, or execute_script instead of this recipe.\n' +
                 '\n' +
-                'Use when: the user wants the subject isolated from the background non-destructively.\n' +
-                'Do NOT use when: the subject is extremely fine-edged (hair against a busy background) — propose a manual Refine Edge pass afterwards.\n' +
+                'Returns: { ok, summary, undo_history_states_consumed, details.method = remove_background | remove_layer_background | select_subject | color_range_fallback }.\n' +
                 '\n' +
-                'Returns: { ok, summary, undo_history_states_consumed, details.method = select_subject | color_range_fallback }.\n' +
-                '\n' +
-                'Preconditions: PS ≥ 23 (Select Subject v2) for the default path; Color Range fallback still runs on uniform studio shots if Select Subject is loose or empty.\n' +
-                'Side effects: attaches a pixel mask to the active layer; no pixels destroyed; one undo reverts everything.',
+                'Preconditions: an active document. Native Remove Background needs a current Photoshop; Select Subject fallback needs PS ≥ 23.\n' +
+                'Side effects: may unlock/rename the Background layer; attaches a pixel mask; no pixels destroyed; one undo reverts everything.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -46,23 +43,22 @@ async function runRemoveBackground(connection, args) {
     const feather = clampInt(args.feather_px, 0, 20, 0);
     const keepShadow = args.keep_shadow === true;
     await connection.ping().catch(() => undefined);
-    const info = connection.getPhotoshopInfo();
-    if (info) {
-        const detector = new PhotoshopDetector();
-        if (!detector.supportsSelectSubjectV2(info.version)) {
-            return toolFailure({
-                ok: false,
-                code: 'version_unsupported',
-                message: `Select Subject v2 requires Photoshop 23.0+; detected version ${info.version}. Upgrade Photoshop or remove the background manually.`,
-                suggested_next_tool: 'photoshop_get_capabilities',
-            });
-        }
-    }
     const body = `
     var doc = app.activeDocument;
     var layer = doc.activeLayer;
+    var convertedBackground = false;
     if (layer.isBackgroundLayer) {
-      return { ok: false, code: 'no_active_layer', message: 'Active layer is the Background layer — convert it to a normal layer first.', suggested_next_tool: 'photoshop_rasterize_layer' };
+      try {
+        var previousName = String(layer.name);
+        layer.isBackgroundLayer = false;
+        convertedBackground = true;
+        layer = doc.activeLayer;
+        if (previousName === 'Background' || layer.name === 'Background' || layer.name === 'Layer 0') {
+          layer.name = 'Subject';
+        }
+      } catch (eBg) {
+        return { ok: false, code: 'no_active_layer', message: 'Could not unlock the Background layer.', suggested_next_tool: 'photoshop_get_state' };
+      }
     }
 
     app.displayDialogs = DialogModes.NO;
@@ -180,6 +176,70 @@ async function runRemoveBackground(connection, args) {
       }
     }
 
+    function __mcp_hasMask() {
+      try {
+        var maskRef = new ActionReference();
+        maskRef.putEnumerated(stringIDToTypeID('layer'), stringIDToTypeID('ordinal'), stringIDToTypeID('targetEnum'));
+        var maskDesc = executeActionGet(maskRef);
+        return maskDesc.hasKey(stringIDToTypeID('userMaskEnabled'));
+      } catch (eMask) {
+        return false;
+      }
+    }
+
+    function __mcp_tryNativeRemoveBackground() {
+      try {
+        executeAction(stringIDToTypeID('removeBackground'), new ActionDescriptor(), DialogModes.NO);
+        return __mcp_hasMask();
+      } catch (eNative) {
+        return false;
+      }
+    }
+
+    function __mcp_tryRemoveLayerBackground() {
+      try {
+        var rlDesc = new ActionDescriptor();
+        var rlRef = new ActionReference();
+        rlRef.putEnumerated(stringIDToTypeID('layer'), stringIDToTypeID('ordinal'), stringIDToTypeID('targetEnum'));
+        rlDesc.putReference(stringIDToTypeID('null'), rlRef);
+        executeAction(stringIDToTypeID('removeLayerBackground'), rlDesc, DialogModes.NO);
+        return __mcp_hasMask();
+      } catch (eLayerBg) {
+        return false;
+      }
+    }
+
+    if (__mcp_tryNativeRemoveBackground()) {
+      return {
+        ok: true,
+        summary: 'Background removed via native Remove Background + layer mask',
+        undo_history_states_consumed: 1,
+        next_suggested_tool: 'photoshop_get_preview',
+        details: {
+          feather_px: ${feather},
+          keep_shadow: ${keepShadow ? 'true' : 'false'},
+          layer_name: layer.name,
+          method: 'remove_background',
+          converted_background: convertedBackground
+        }
+      };
+    }
+    if (__mcp_tryRemoveLayerBackground()) {
+      return {
+        ok: true,
+        summary: 'Background removed via Remove Layer Background + layer mask',
+        undo_history_states_consumed: 1,
+        next_suggested_tool: 'photoshop_get_preview',
+        details: {
+          feather_px: ${feather},
+          keep_shadow: ${keepShadow ? 'true' : 'false'},
+          layer_name: layer.name,
+          method: 'remove_layer_background',
+          converted_background: convertedBackground
+        }
+      };
+    }
+
     var studio = __mcp_detectStudio();
     var method = 'select_subject';
     var subjectOk = __mcp_trySelectSubject();
@@ -227,7 +287,8 @@ async function runRemoveBackground(connection, args) {
         feather_px: ${feather},
         keep_shadow: ${keepShadow ? 'true' : 'false'},
         layer_name: layer.name,
-        method: method
+        method: method,
+        converted_background: convertedBackground
       }
     };
   `;

package/dist/tools/recipes/remove-background.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-background.js","sourceRoot":"","sources":["../../../src/tools/recipes/remove-background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,UAA+B;IAClE,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EACT,qPAAqP;gBACrP,IAAI;gBACJ,yGAAyG;gBACzG,IAAI;gBACJ,wFAAwF;gBACxF,yIAAyI;gBACzI,IAAI;gBACJ,mHAAmH;gBACnH,IAAI;gBACJ,iKAAiK;gBACjK,4GAA4G;YAC9G,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,0GAA0G;wBAC5G,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,CAAC;qBACX;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,yGAAyG;wBAC3G,OAAO,EAAE,KAAK;qBACf;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,6FAA6F;wBAC/F,OAAO,EAAE,KAAK;qBACf;iBACF;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,UAA+B,EAC/B,IAA6B;IAE7B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IAE7C,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,gBAAgB,EAAE,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,OAAO,WAAW,CAAC;gBACjB,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,gEAAgE,IAAI,CAAC,OAAO,wDAAwD;gBAC7I,mBAAmB,EAAE,4BAA4B;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyJL,OAAO;oCACmB,OAAO;;;;;;;;8EAQmC,OAAO,yBAAyB,OAAO;;;;sBAI/F,OAAO;uBACN,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;GAKjD,CAAC;IAEF,OAAO,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"remove-background.js","sourceRoot":"","sources":["../../../src/tools/recipes/remove-background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,UAA+B;IAClE,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EACT,wRAAwR;gBACxR,IAAI;gBACJ,wGAAwG;gBACxG,0HAA0H;gBAC1H,IAAI;gBACJ,iKAAiK;gBACjK,IAAI;gBACJ,iIAAiI;gBACjI,gIAAgI;YAClI,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,0GAA0G;wBAC5G,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,CAAC;qBACX;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,yGAAyG;wBAC3G,OAAO,EAAE,KAAK;qBACf;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,6FAA6F;wBAC/F,OAAO,EAAE,KAAK;qBACf;iBACF;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,UAA+B,EAC/B,IAA6B;IAE7B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IAE7C,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6KS,OAAO;yBACN,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;;;;;;;;;;wBAc9B,OAAO;yBACN,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAuC5C,OAAO;oCACmB,OAAO;;;;;;;;8EAQmC,OAAO,yBAAyB,OAAO;;;;sBAI/F,OAAO;uBACN,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;;GAMjD,CAAC;IAEF,OAAO,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisaitteke/photoshop-mcp",
-  "version": "1.7.13",
+  "version": "1.7.15",
   "description": "MCP server for Adobe Photoshop — 116 tools (generative AI + recipes), standalone web UI. Control Photoshop from Cursor, Claude, or natural language.",
   "main": "dist/index.js",
   "type": "module",