unity-open-mcp 0.1.0

package/dist/tools/scene-save.js

@@ -0,0 +1,38 @@
+// M16 Plan 3 — typed scene save. Mutating: writes an opened scene back to
+// its .unity asset (or a new path). Runs the full gate path.
+export const sceneSave = {
+    name: "unity_open_mcp_scene_save",
+    description: "Save an opened scene back to its asset file, or to a new `.unity` path when `path` is " +
+        "provided. Mutating: runs the full gate path; `paths_hint` should be the destination `.unity` " +
+        "asset path. When `name` is omitted, saves the active scene. Returns { saved, name, path } " +
+        "with `saved: false` and a note when the scene was not dirty (idempotent). Prefer this over " +
+        "raw execute_csharp EditorSceneManager.SaveScene.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            name: {
+                type: "string",
+                description: "Opened scene name to save. Omit (or empty) to save the active scene. Use " +
+                    "scene_list_opened to enumerate opened scene names.",
+            },
+            path: {
+                type: "string",
+                description: "Optional destination `.unity` asset path (save-as). Omit to save back to the scene's " +
+                    "existing path. When provided, must end with '.unity'.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the destination `.unity` asset path (the scene's existing path when " +
+                    "`path` is omitted).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-save.js.map

package/dist/tools/scene-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-save.js","sourceRoot":"","sources":["../../src/tools/scene-save.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,wFAAwF;QACxF,+FAA+F;QAC/F,4FAA4F;QAC5F,6FAA6F;QAC7F,kDAAkD;IACpD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2EAA2E;oBAC3E,oDAAoD;aACvD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,uDAAuD;aAC1D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,uFAAuF;oBACvF,qBAAqB;aACxB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-set-active.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const sceneSetActive: Tool;

package/dist/tools/scene-set-active.js

@@ -0,0 +1,33 @@
+// M16 Plan 3 — typed scene set active. Mutating: marks an opened scene as
+// the active scene. Runs the full gate path.
+export const sceneSetActive = {
+    name: "unity_open_mcp_scene_set_active",
+    description: "Mark an opened scene as the editor's active scene (the scene new GameObjects are added to " +
+        "and the default for many operations). Mutating: runs the full gate path; `paths_hint` should " +
+        "be the scene's asset path. The target scene must already be opened (use scene_open first). " +
+        "Returns the post-set list of opened scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/" +
+        "isActive) so the agent can confirm which scene is now active. Prefer this over raw " +
+        "execute_csharp EditorSceneManager.SetActiveScene.",
+    inputSchema: {
+        type: "object",
+        required: ["name", "paths_hint"],
+        properties: {
+            name: {
+                type: "string",
+                description: "Name of the opened scene to mark as active. Must match an opened scene. Use " +
+                    "scene_list_opened to enumerate opened scene names.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene's asset path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-set-active.js.map

package/dist/tools/scene-set-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-set-active.js","sourceRoot":"","sources":["../../src/tools/scene-set-active.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,4FAA4F;QAC5F,+FAA+F;QAC/F,6FAA6F;QAC7F,8FAA8F;QAC9F,qFAAqF;QACrF,mDAAmD;IACrD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8EAA8E;oBAC9E,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0CAA0C;aACxD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-unload.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const sceneUnload: Tool;

package/dist/tools/scene-unload.js

@@ -0,0 +1,33 @@
+// M16 Plan 3 — typed scene unload. Mutating: removes an opened scene from
+// the editor (without saving). Runs the full gate path.
+export const sceneUnload = {
+    name: "unity_open_mcp_scene_unload",
+    description: "Unload an opened scene from the Unity Editor (without saving — call scene_save first if " +
+        "the scene has unsaved changes you want to keep). Mutating: runs the full gate path; " +
+        "`paths_hint` should be the scene's asset path. Returns the post-unload list of opened " +
+        "scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/isActive). Prefer this over raw " +
+        "execute_csharp SceneManager.UnloadSceneAsync.",
+    inputSchema: {
+        type: "object",
+        required: ["name", "paths_hint"],
+        properties: {
+            name: {
+                type: "string",
+                description: "Name of the opened scene to unload. Must match an opened scene. Use " +
+                    "scene_list_opened to enumerate opened scene names.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the unloaded scene's asset path (or its name when it is not yet " +
+                    "asset-backed).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-unload.js.map

package/dist/tools/scene-unload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,wFAAwF;QACxF,0FAA0F;QAC1F,+CAA+C;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;oBACtE,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/screenshot-camera.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const screenshotCamera: Tool;

package/dist/tools/screenshot-camera.js

@@ -0,0 +1,59 @@
+// M20 Plan 1 / T20.1.1 — arbitrary-pose screenshot. Renders from a transient
+// camera at the requested world-space pose without moving the scene/game
+// camera. Returns the saved PNG file path (use capture_inline for an inline
+// base64 image instead of a file).
+export const screenshotCamera = {
+    name: "unity_senses_screenshot_camera",
+    description: "Render a screenshot from an arbitrary world-space camera pose (position + " +
+        "rotation in degrees + field of view) without moving the scene or game " +
+        "camera. Uses a transient Camera positioned at the requested pose, so the " +
+        "live editor view is never disturbed. Returns the saved PNG file path. " +
+        "Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            position: {
+                type: "string",
+                default: "0,0,0",
+                description: "World-space camera position as \"x,y,z\" (e.g. \"5,10,-7\").",
+            },
+            rotation: {
+                type: "string",
+                default: "0,0,0",
+                description: "Camera rotation as Euler angles in degrees \"x,y,z\" (e.g. " +
+                    "\"30,-45,0\" for a 30° down-tilt facing south-east).",
+            },
+            fov: {
+                type: "number",
+                default: 60,
+                exclusiveMinimum: 0,
+                exclusiveMaximum: 180,
+                description: "Field of view in degrees. Must be strictly between 0 and 180.",
+            },
+            width: {
+                type: "integer",
+                default: 1280,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture width in pixels.",
+            },
+            height: {
+                type: "integer",
+                default: 720,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture height in pixels.",
+            },
+            background: {
+                type: "string",
+                enum: ["transparent", "solid", "skybox"],
+                default: "skybox",
+                description: "Background. 'skybox' = skybox (default), 'solid' = solid color, " +
+                    "'transparent' = alpha-clear. A nonexistent main camera falls back " +
+                    "to a sensible default culling mask / clip range.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=screenshot-camera.js.map

package/dist/tools/screenshot-camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-camera.js","sourceRoot":"","sources":["../../src/tools/screenshot-camera.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,4EAA4E;QAC5E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,8DAA8D;aACjE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,6DAA6D;oBAC7D,sDAAsD;aACzD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,gBAAgB,EAAE,CAAC;gBACnB,gBAAgB,EAAE,GAAG;gBACrB,WAAW,EAAE,+DAA+D;aAC7E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,0BAA0B;aACxC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,2BAA2B;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACxC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,kEAAkE;oBAClE,oEAAoE;oBACpE,kDAAkD;aACrD;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/screenshot-window.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const screenshotWindow: Tool;

package/dist/tools/screenshot-window.js

@@ -0,0 +1,54 @@
+// M20 Plan 1 / T20.1.2 — Editor window screenshot. Captures any EditorWindow
+// (Console, Hierarchy, Inspector, Project, Scene, Game, or a custom window).
+// Full-fidelity capture via the Win32 PrintWindow API is Windows-only; on
+// macOS/Linux a best-effort screen-rect readback is used and the response
+// carries platformLimited: true so the agent knows the capture may be partial
+// when the window is occluded. Returns the saved PNG file path.
+export const screenshotWindow = {
+    name: "unity_senses_screenshot_window",
+    description: "Capture a Unity Editor window (Console, Hierarchy, Inspector, Project, " +
+        "Scene, Game, or any custom EditorWindow) to a PNG file. Full-fidelity " +
+        "capture (occlusion-proof, no focus stealing) is Windows-only via the " +
+        "Win32 PrintWindow API; on macOS/Linux a best-effort screen-rect readback " +
+        "is used and the response carries platformLimited: true, so the capture " +
+        "may be partial or stale when the window is hidden behind others. Provide " +
+        "either window_title (visible tab text, e.g. \"Console\") or window_type " +
+        "(EditorWindow type name, e.g. \"UnityEditor.ConsoleWindow\"). Returns " +
+        "the saved PNG file path. Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            window_title: {
+                type: "string",
+                description: "Visible tab title of the target window (e.g. \"Console\", " +
+                    "\"Hierarchy\", \"Inspector\", \"Project\", \"Scene\", \"Game\"). " +
+                    "Common titles map to their built-in EditorWindow types; custom " +
+                    "titles match any open window with that title.",
+            },
+            window_type: {
+                type: "string",
+                description: "EditorWindow type name (simple or fully-qualified, e.g. " +
+                    "\"ConsoleWindow\" or \"UnityEditor.ConsoleWindow\"). Takes " +
+                    "precedence over window_title when both are given.",
+            },
+            width: {
+                type: "integer",
+                default: 1280,
+                minimum: 64,
+                maximum: 4096,
+                description: "Maximum capture width in pixels. The actual capture is clamped to " +
+                    "the window's on-screen width.",
+            },
+            height: {
+                type: "integer",
+                default: 720,
+                minimum: 64,
+                maximum: 4096,
+                description: "Maximum capture height in pixels. The actual capture is clamped to " +
+                    "the window's on-screen height.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=screenshot-window.js.map

package/dist/tools/screenshot-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-window.js","sourceRoot":"","sources":["../../src/tools/screenshot-window.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,2EAA2E;QAC3E,yEAAyE;QACzE,2EAA2E;QAC3E,0EAA0E;QAC1E,wEAAwE;QACxE,mEAAmE;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4DAA4D;oBAC5D,mEAAmE;oBACnE,iEAAiE;oBACjE,+CAA+C;aAClD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0DAA0D;oBAC1D,6DAA6D;oBAC7D,mDAAmD;aACtD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,oEAAoE;oBACpE,+BAA+B;aAClC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,qEAAqE;oBACrE,gCAAgC;aACnC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/screenshot.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const screenshot: Tool;

package/dist/tools/screenshot.js

@@ -0,0 +1,47 @@
+export const screenshot = {
+    name: "unity_senses_screenshot",
+    description: "Capture a screenshot from the Unity Editor. Supports three views: " +
+        "'scene' (the Scene view), 'game' (the main camera / Game view), and " +
+        "'isolated' (a clean 2x2 composite — Front/Right/Back/Top — of a single " +
+        "GameObject with layer culling and background choice). " +
+        "Returns the saved PNG file path. Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            view: {
+                type: "string",
+                enum: ["scene", "game", "isolated"],
+                default: "scene",
+                description: "Capture target. 'scene' = Scene view camera, 'game' = main game camera, " +
+                    "'isolated' = clean 2x2 composite of one GameObject.",
+            },
+            width: {
+                type: "integer",
+                default: 1280,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture width in pixels. For 'isolated', this is per-quadrant (full image is 2x).",
+            },
+            height: {
+                type: "integer",
+                default: 720,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture height in pixels. For 'isolated', this is per-quadrant (full image is 2x).",
+            },
+            object_path: {
+                type: "string",
+                description: "Required for 'isolated' view. Hierarchy path of the target GameObject " +
+                    "(e.g. \"Player\" or \"Enemies/Goblin\").",
+            },
+            background: {
+                type: "string",
+                enum: ["transparent", "solid", "skybox"],
+                default: "skybox",
+                description: "Background for 'isolated' view. Ignored for scene/game.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=screenshot.js.map

package/dist/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,oEAAoE;QACpE,sEAAsE;QACtE,yEAAyE;QACzE,wDAAwD;QACxD,2EAA2E;IAC7E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;gBACnC,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,0EAA0E;oBAC1E,qDAAqD;aACxD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,mFAAmF;aACtF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,oFAAoF;aACvF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wEAAwE;oBACxE,0CAA0C;aAC7C;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACxC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,yDAAyD;aACvE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/script-delete.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const scriptDelete: Tool;

package/dist/tools/script-delete.js

@@ -0,0 +1,37 @@
+// M16 Plan 6 — typed script delete. Mutating: deletes one or more .cs files
+// (and their .meta) from disk. Runs the full gate path with paths_hint scoped
+// to the deleted file(s). Deleting a script can break prefab/scene references,
+// which the gate surfaces.
+export const scriptDelete = {
+    name: "unity_open_mcp_script_delete",
+    description: "Delete one or more C# source (.cs) files (and their .meta) from the project. Mutating: " +
+        "removes the file, refreshes the asset database (which may trigger a recompile / domain " +
+        "reload), and runs the full gate path; `paths_hint` must list every .cs path you delete " +
+        "so the gate can surface fallout (a removed MonoBehaviour breaks prefab/scene references). " +
+        "Returns `file_not_found` per missing path; per-file errors are accumulated and do not " +
+        "abort the batch. Prefer this over execute_csharp File.Delete — schema-validated and the " +
+        "gate catches dangling script references.",
+    inputSchema: {
+        type: "object",
+        required: ["file_paths", "paths_hint"],
+        properties: {
+            file_paths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Project-relative .cs paths to delete (e.g. [\"Assets/Scripts/Old.cs\"]). Each " +
+                    "must end in .cs and live under the project root.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the same .cs paths you pass in file_paths.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=script-delete.js.map

package/dist/tools/script-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-delete.js","sourceRoot":"","sources":["../../src/tools/script-delete.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,yFAAyF;QACzF,yFAAyF;QACzF,yFAAyF;QACzF,4FAA4F;QAC5F,wFAAwF;QACxF,0FAA0F;QAC1F,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;QACtC,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,gFAAgF;oBAChF,kDAAkD;aACrD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/script-read.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const scriptRead: Tool;

package/dist/tools/script-read.js

@@ -0,0 +1,46 @@
+// M16 Plan 6 — typed script read. Read-only (gate-free). Reads a .cs file from
+// disk with optional line slicing so an agent can inspect a script without
+// invoking execute_csharp or the file system escape hatch. Token-bounded by a
+// line range + a soft character cap.
+export const scriptRead = {
+    name: "unity_open_mcp_script_read",
+    description: "Read a C# source (.cs) file from disk. Read-only and gate-free. Returns the file " +
+        "path, line count, and a `lines[]` array of numbered source lines, optionally " +
+        "sliced by start_line / end_line (1-based, inclusive). Use this to inspect a script " +
+        "before script_write, or to learn a type's implementation before invoke_method. " +
+        "Prefer this over execute_csharp with File.ReadAllText — schema-validated and " +
+        "token-bounded by the line range. The file must live under the project (Assets/, " +
+        "Packages/, or the project root); absolute paths outside the project are refused.",
+    inputSchema: {
+        type: "object",
+        required: ["file_path"],
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Project-relative path to the .cs file (e.g. \"Assets/Scripts/Player.cs\"). " +
+                    "Must end in .cs and live under the project root.",
+            },
+            start_line: {
+                type: "integer",
+                default: 1,
+                minimum: 1,
+                description: "First line to return (1-based, inclusive).",
+            },
+            end_line: {
+                type: "integer",
+                default: 0,
+                minimum: 0,
+                description: "Last line to return (1-based, inclusive). 0 = through end of file.",
+            },
+            max_lines: {
+                type: "integer",
+                default: 2000,
+                minimum: 1,
+                description: "Hard cap on the number of lines returned. Larger ranges are truncated and " +
+                    "reported via 'truncated' + 'totalLines'.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=script-read.js.map

package/dist/tools/script-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-read.js","sourceRoot":"","sources":["../../src/tools/script-read.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,qCAAqC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,mFAAmF;QACnF,+EAA+E;QAC/E,qFAAqF;QACrF,iFAAiF;QACjF,+EAA+E;QAC/E,kFAAkF;QAClF,kFAAkF;IACpF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6EAA6E;oBAC7E,kDAAkD;aACrD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,4CAA4C;aAC1D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,oEAAoE;aAClF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,4EAA4E;oBAC5E,0CAA0C;aAC7C;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/script-write.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const scriptWrite: Tool;

package/dist/tools/script-write.js

@@ -0,0 +1,56 @@
+// M16 Plan 6 — typed script write. Mutating: creates or overwrites a .cs file
+// under the project, after Roslyn pre-write validation. Runs the full gate path
+// with paths_hint scoped to the .cs path. Folds UMCP script-update-or-create
+// with the validation exposed as a return field rather than a separate tool.
+export const scriptWrite = {
+    name: "unity_open_mcp_script_write",
+    description: "Create or overwrite a C# source (.cs) file under the project. Mutating: writes the " +
+        "file, then Roslyn-validates it before persisting and refreshes the asset database " +
+        "(which may trigger a recompile / domain reload). Runs the full gate path; `paths_hint` " +
+        "must be scoped to the .cs path. By default the call refuses to overwrite an existing " +
+        "file unless `overwrite: true` is set. `validate: true` (default) runs a Roslyn parse " +
+        "compile of the source first and returns the diagnostics — a failed parse returns " +
+        "`validation_failed` and the file is not written. Set `validate: false` only when you " +
+        "intentionally want to write a fragment that is not a full compilation unit. Prefer " +
+        "this over execute_csharp File.WriteAllText — schema-validated, Roslyn-checked, and " +
+        "the gate surfaces any fallout (the new script can break prefab references).",
+    inputSchema: {
+        type: "object",
+        required: ["file_path", "content", "paths_hint"],
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Project-relative path to the .cs file (e.g. \"Assets/Scripts/Player.cs\"). Must " +
+                    "end in .cs and live under the project root.",
+            },
+            content: {
+                type: "string",
+                description: "The full C# source to write. Must be non-empty.",
+            },
+            overwrite: {
+                type: "boolean",
+                default: false,
+                description: "When false (default) the call refuses to overwrite an existing file. Set true " +
+                    "to overwrite.",
+            },
+            validate: {
+                type: "boolean",
+                default: true,
+                description: "When true (default) the source is Roslyn-compiled first; parse errors return " +
+                    "`validation_failed` and the file is not written. The diagnostics are echoed in " +
+                    "the response. Set false to skip validation (e.g. for partial fragments).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — [\"<the .cs path you are writing>\"].",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=script-write.js.map

package/dist/tools/script-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-write.js","sourceRoot":"","sources":["../../src/tools/script-write.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,qFAAqF;QACrF,oFAAoF;QACpF,yFAAyF;QACzF,uFAAuF;QACvF,uFAAuF;QACvF,mFAAmF;QACnF,uFAAuF;QACvF,qFAAqF;QACrF,qFAAqF;QACrF,6EAA6E;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC;QAChD,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kFAAkF;oBAClF,6CAA6C;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,gFAAgF;oBAChF,eAAe;aAClB;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,+EAA+E;oBAC/E,iFAAiF;oBACjF,0EAA0E;aAC7E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,wDAAwD;aACtE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/search-assets.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const searchAssets: Tool;

package/dist/tools/search-assets.js

@@ -0,0 +1,49 @@
+// M9 Plan 2 — compact asset search. Returns grouped, reason-tagged matches with
+// omission counts; each match lists why it matched (file-name/gameobject/
+// component/guid). Paths are compacted (Assets/ prefix dropped, EXT table
+// declared once). Offline-first (Plan 3): scans Assets/ on disk without a
+// running Editor.
+export const searchAssets = {
+    name: "unity_open_mcp_search_assets",
+    description: "Search the project for assets by file/GameObject/component/script/GUID. Returns compact, grouped, reason-tagged matches with omission counts. " +
+        "Each result tags why it matched (file-name / gameobject / component / guid) so the agent knows which drill-down to run next. " +
+        "Offline-first: scans Assets/ on disk (no Editor needed).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Substring filter on file name or GameObject name.",
+            },
+            component: {
+                type: "string",
+                description: "Substring filter on component or MonoBehaviour script name.",
+            },
+            guid: {
+                type: "string",
+                description: "Raw Unity GUID to find references to.",
+            },
+            type: {
+                type: "string",
+                description: "Comma-separated asset kinds (e.g. \"prefab,scene\"). Empty = search all YAML asset kinds.",
+            },
+            folder: {
+                type: "string",
+                default: "Assets",
+                description: "Folder to search under (default: Assets).",
+            },
+            object_limit: {
+                type: "integer",
+                default: 12,
+                description: "Max objects listed per result file; extras counted in 'moreObjectsHidden'.",
+            },
+            max_results: {
+                type: "integer",
+                default: 50,
+                description: "Max result files returned; extras counted in 'truncated'.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=search-assets.js.map

package/dist/tools/search-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-assets.js","sourceRoot":"","sources":["../../src/tools/search-assets.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,kBAAkB;AAClB,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,gJAAgJ;QAChJ,+HAA+H;QAC/H,0DAA0D;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,2CAA2C;aACzD;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,4EAA4E;aAC1F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,2DAA2D;aACzE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/selection-get.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const selectionGet: Tool;

package/dist/tools/selection-get.js

@@ -0,0 +1,28 @@
+// M16 Plan 5 — typed editor selection get. Read-only: reports the current
+// editor selection (active object + full selection array). Gate-free.
+// Complements the read-only addressing model used across the typed surface
+// (instance_id > path > name).
+export const selectionGet = {
+    name: "unity_open_mcp_selection_get",
+    description: "Read the current Unity Editor selection. Returns the active object " +
+        "(instanceId / name / type / assetPath when asset-backed) plus the full " +
+        "selection array when more than one object is selected. Read-only and " +
+        "gate-free. Use this to find what a human has clicked in the Hierarchy / " +
+        "Project window before mutating it, or to confirm selection_set took " +
+        "effect. Prefer this over raw execute_csharp Selection.activeObject — " +
+        "schema-validated and surfaces asset vs scene-backed objects uniformly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            max_results: {
+                type: "integer",
+                default: 50,
+                minimum: 1,
+                description: "Cap on the number of selected objects serialized. The active object " +
+                    "is always included regardless. Truncated count is reported.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=selection-get.js.map

package/dist/tools/selection-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-get.js","sourceRoot":"","sources":["../../src/tools/selection-get.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,qEAAqE;QACrE,yEAAyE;QACzE,uEAAuE;QACvE,0EAA0E;QAC1E,sEAAsE;QACtE,uEAAuE;QACvE,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,sEAAsE;oBACtE,6DAA6D;aAChE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/selection-set.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const selectionSet: Tool;