unity-open-mcp 0.7.0 → 0.8.3

package/dist/tools/lod-group-configure.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const lodGroupConfigure: Tool;
+export declare const lodGroupConfigure: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/lod-group-configure.js

@@ -1,3 +1,4 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M20 Plan 3 / T20.3.3 — Constraints & LOD domain tool. Configure a LODGroup
 // on a host GameObject. Built-in engine module. Mutating: runs the full gate
 // path; paths_hint is the host scene path. Idempotent — re-using an existing
@@ -16,49 +17,36 @@ const targetSchema = {
         type: "string",
         description: "Host GameObject name (first match). Lowest priority resolver.",
     },
-    paths_hint: {
-        type: "array",
-        items: { type: "string" },
-        description: "Mutation scope — the host scene path. No whole-project fallback.",
-    },
-    gate: {
-        enum: ["enforce", "warn", "off"],
-        default: "enforce",
-    },
+    paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the host scene path. No whole-project fallback." },
+    gate: { ...GATE_PROP },
 };
-export const lodGroupConfigure = {
-    name: "unity_open_mcp_lod_group_configure",
-    description: "Configure a LODGroup on a GameObject. Optional: fade_mode (None | SpeedTree | " +
-        "CrossFade, default None — leaves the existing value when omitted), " +
-        "animate_cross_fading (default false), lod_count (allocates the LOD array with " +
-        "that many levels; renderers start empty — wire them via lod_add_level). " +
-        "Idempotent — re-using an existing LODGroup reports added:false (configuration " +
-        "still applied). Mutating: runs the full gate path; paths_hint is the host scene " +
-        "path. Built-in engine module (no package dependency); the constraints group is " +
-        "hidden until manage_tools activates it.",
-    inputSchema: {
-        type: "object",
-        required: ["paths_hint"],
-        properties: {
-            ...targetSchema,
-            fade_mode: {
-                type: "string",
-                enum: ["None", "SpeedTree", "CrossFade"],
-                description: "LOD fade mode. Omit to leave the existing value untouched.",
-            },
-            animate_cross_fading: {
-                type: "boolean",
-                default: false,
-                description: "Whether cross-fade transitions animate.",
-            },
-            lod_count: {
-                type: "integer",
-                default: -1,
-                description: "Allocate the LOD array with this many levels (1-8). -1 leaves the array " +
-                    "untouched. Renderers start empty — wire them via lod_add_level.",
-            },
+export const lodGroupConfigure = makeTool("unity_open_mcp_lod_group_configure", "Configure a LODGroup on a GameObject. Optional: fade_mode (None | SpeedTree | " +
+    "CrossFade, default None — leaves the existing value when omitted), " +
+    "animate_cross_fading (default false), lod_count (allocates the LOD array with " +
+    "that many levels; renderers start empty — wire them via lod_add_level). " +
+    "Idempotent — re-using an existing LODGroup reports added:false (configuration " +
+    "still applied). Mutating: runs the full gate path; paths_hint is the host scene " +
+    "path. Built-in engine module (no package dependency); the constraints group is " +
+    "hidden until manage_tools activates it.", {
+    required: ["paths_hint"],
+    properties: {
+        ...targetSchema,
+        fade_mode: {
+            type: "string",
+            enum: ["None", "SpeedTree", "CrossFade"],
+            description: "LOD fade mode. Omit to leave the existing value untouched.",
+        },
+        animate_cross_fading: {
+            type: "boolean",
+            default: false,
+            description: "Whether cross-fade transitions animate.",
+        },
+        lod_count: {
+            type: "integer",
+            default: -1,
+            description: "Allocate the LOD array with this many levels (1-8). -1 leaves the array " +
+                "untouched. Renderers start empty — wire them via lod_add_level.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=lod-group-configure.js.map

package/dist/tools/lod-group-configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"lod-group-configure.js","sourceRoot":"","sources":["../../src/tools/lod-group-configure.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC3B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+DAA+D;KAC7E;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,kEAAkE;KAChF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,gFAAgF;QAChF,qEAAqE;QACrE,gFAAgF;QAChF,0EAA0E;QAC1E,gFAAgF;QAChF,kFAAkF;QAClF,iFAAiF;QACjF,yCAAyC;IAC3C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,GAAG,YAAY;YACf,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;gBACxC,WAAW,EAAE,4DAA4D;aAC1E;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC,CAAC;gBACX,WAAW,EACT,0EAA0E;oBAC1E,iEAAiE;aACpE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"lod-group-configure.js","sourceRoot":"","sources":["../../src/tools/lod-group-configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC3B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+DAA+D;KAC7E;IACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,kEAAkE,EAAE;IACnH,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,oCAAoC,EACpC,gFAAgF;IAC9E,qEAAqE;IACrE,gFAAgF;IAChF,0EAA0E;IAC1E,gFAAgF;IAChF,kFAAkF;IAClF,iFAAiF;IACjF,yCAAyC,EAC3C;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,GAAG,YAAY;QACf,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;YACxC,WAAW,EAAE,4DAA4D;SAC1E;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,yCAAyC;SACvD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC,CAAC;YACX,WAAW,EACT,0EAA0E;gBAC1E,iEAAiE;SACpE;KACF;CACN,CACF,CAAC"}

package/dist/tools/manage-tools.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const manageTools: Tool;
+export declare const manageTools: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/manage-tools.js

@@ -1,3 +1,4 @@
+import { makeTool } from "./schema-fragments.js";
 // manage_tools meta-tool for per-session tool-group visibility.
 //
 // Server-only meta-tool for per-session tool-group visibility. The MCP server
@@ -8,42 +9,75 @@
 // The tool definition ships with every MCP-server build (always visible — it
 // is in the ALWAYS_VISIBLE_TOOLS allow-list in tool-session-state.ts) so an
 // agent can always reach it before any other group is active.
-export const manageTools = {
-    name: "unity_open_mcp_manage_tools",
-    description: "Manage which tool groups are visible in this session. Sessions start " +
-        "with five groups enabled: `core`, `gate-and-verify`, " +
-        "`asset-intelligence`, `typed-editor`, and `diagnostics`; activate other " +
-        "groups on demand to add their tools to your ListTools surface (and " +
-        "deactivate to hide them). State is ephemeral and per-session — it resets " +
-        "to those five defaults when the MCP server restarts. Actions: " +
-        "`list_groups` (show every group with active flag, description, and tool " +
-        "roster), `activate` (enable a group — its tools become visible), " +
-        "`deactivate` (hide a group's tools), `reset` (restore the five default-on " +
-        "groups). Always call `list_groups` first to discover group ids. " +
-        "Group availability also depends on the Unity domain dependency being " +
-        "compiled in — see `unity_open_mcp_capabilities` for compiled-state " +
-        "availability per group. Some groups **auto-activate** when their Unity " +
-        "package is installed (e.g. `shadergraph` when `com.unity.shadergraph` " +
-        "is present) — these surface in `list_groups` with " +
-        "`activationSource: \"auto\"` and require no manual call; deactivate to " +
-        "hide them.",
-    inputSchema: {
-        type: "object",
-        required: ["action"],
-        properties: {
-            action: {
-                enum: ["list_groups", "activate", "deactivate", "reset"],
-                description: "list_groups: enumerate every group with active flag + tool roster. " +
-                    "activate / deactivate: toggle one group (requires `group`). " +
-                    "reset: restore the five default-on groups.",
-            },
-            group: {
-                type: "string",
-                description: "Group id (required for activate / deactivate). Valid ids are " +
-                    "returned by list_groups. Unknown ids return a structured error.",
-            },
+//
+// Two intent-driven actions — `suggest` and `activate_for` — are the agent-
+// first path over hand-picking group ids: the agent states what it is about
+// to do (free-text `intent` and/or explicit `tags`) and the server maps that
+// to the right groups. `suggest` is read-only (returns recommendations +
+// reasons without changing state); `activate_for` activates the recommended
+// set in one call and emits `notifications/tools/list_changed` when the
+// visible surface changes. Unknown intent returns a structured empty
+// recommendation (no invented groups) and points the caller at `list_groups`.
+export const manageTools = makeTool("unity_open_mcp_manage_tools", "Manage which tool groups are visible in this session. Sessions start " +
+    "with two groups enabled: `core` and `gate-and-verify`; activate other " +
+    "groups on demand to add their tools to your ListTools surface (and " +
+    "deactivate to hide them). State is ephemeral and per-session — it resets " +
+    "to those two defaults when the MCP server restarts. Actions: " +
+    "`list_groups` (show every group with active flag, description, and tool " +
+    "roster), `activate` (enable a group — its tools become visible), " +
+    "`deactivate` (hide a group's tools), `reset` (restore the two default-on " +
+    "groups), `suggest` (recommend groups for a task intent and/or tags " +
+    "WITHOUT changing state — the read-only path), `activate_for` (activate " +
+    "the recommended groups for an intent and/or tags in one call). " +
+    "Prefer `activate_for(intent=\"…\")` over hand-picking group ids: state " +
+    "what you are about to do and the server brings the right groups online, " +
+    "including `gate-intelligence` when the task looks mutating or verify-" +
+    "related. Always call `list_groups` first to discover group ids when you " +
+    "need to browse or hand-pick. " +
+    "Group availability also depends on the Unity domain dependency being " +
+    "compiled in — see `unity_open_mcp_capabilities` for compiled-state " +
+    "availability per group. Some groups **auto-activate** when their Unity " +
+    "package is installed (e.g. `shadergraph` when `com.unity.shadergraph` " +
+    "is present) — these surface in `list_groups` with " +
+    "`activationSource: \"auto\"` and require no manual call; deactivate to " +
+    "hide them.", {
+    required: ["action"],
+    properties: {
+        action: {
+            enum: ["list_groups", "activate", "deactivate", "reset", "suggest", "activate_for"],
+            description: "list_groups: enumerate every group with active flag + tool roster. " +
+                "activate / deactivate: toggle one group (requires `group`). " +
+                "reset: restore the two default-on groups. " +
+                "suggest: recommend groups for an `intent` and/or `tags` WITHOUT " +
+                "changing state (read-only). " +
+                "activate_for: activate the recommended groups for an `intent` " +
+                "and/or `tags` in one call (idempotent; emits list_changed when " +
+                "the visible set changes).",
+        },
+        group: {
+            type: "string",
+            description: "Group id (required for activate / deactivate). Valid ids are " +
+                "returned by list_groups. Unknown ids return a structured error.",
+        },
+        intent: {
+            type: "string",
+            description: "Free-text task intent for `suggest` / `activate_for` (e.g. " +
+                "\"bake a NavMesh for the dungeon scene\", \"verify the prefab " +
+                "references and run a scan\"). The text is tokenized and matched " +
+                "against the intent/tag catalog; mutating/verify verbs additionally " +
+                "surface `gate-intelligence`. Unknown intent returns an empty " +
+                "recommendation (no invented groups).",
+        },
+        tags: {
+            type: "array",
+            items: { type: "string" },
+            description: "Explicit tags for `suggest` / `activate_for`. Accepted forms: " +
+                "canonical tag names (navigation, animation, audio, profiler, qa, " +
+                "verify, risk, …), catalog keywords (navmesh, particles, build, …), " +
+                "or group ids (terrain, vfx, …). Unknown tags are reported in " +
+                "`unmatchedTags` and otherwise ignored. Combine with `intent` to " +
+                "narrow the recommendation.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=manage-tools.js.map

package/dist/tools/manage-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,uEAAuE;QACvE,uDAAuD;QACvD,0EAA0E;QAC1E,qEAAqE;QACrE,2EAA2E;QAC3E,gEAAgE;QAChE,0EAA0E;QAC1E,mEAAmE;QACnE,4EAA4E;QAC5E,kEAAkE;QAClE,uEAAuE;QACvE,qEAAqE;QACrE,yEAAyE;QACzE,wEAAwE;QACxE,oDAAoD;QACpD,yEAAyE;QACzE,YAAY;IACd,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC;gBACxD,WAAW,EACT,qEAAqE;oBACrE,8DAA8D;oBAC9D,4CAA4C;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+DAA+D;oBAC/D,iEAAiE;aACpE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,uEAAuE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,+DAA+D;IAC/D,0EAA0E;IAC1E,mEAAmE;IACnE,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,YAAY,EACd;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;YACnF,WAAW,EACT,qEAAqE;gBACrE,8DAA8D;gBAC9D,4CAA4C;gBAC5C,kEAAkE;gBAClE,8BAA8B;gBAC9B,gEAAgE;gBAChE,iEAAiE;gBACjE,2BAA2B;SAC9B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;gBAC/D,iEAAiE;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,qEAAqE;gBACrE,+DAA+D;gBAC/D,sCAAsC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,qEAAqE;gBACrE,+DAA+D;gBAC/D,kEAAkE;gBAClE,4BAA4B;SAC/B;KACF;CACN,CACF,CAAC"}

package/dist/tools/material-create.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const materialCreate: Tool;
+export declare const materialCreate: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/material-create.js

@@ -1,37 +1,36 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 1 — typed material create. Wraps AssetDatabase.CreateAsset on a
 // new Material(shader). Mutating: runs the full gate path; `paths_hint`
 // must point at the new .mat path.
-export const materialCreate = {
-    name: "unity_open_mcp_material_create",
-    description: "Create a new Material asset at a given Assets/-rooted path ending in .mat, using the " +
-        "named shader. Intermediate folders are created if missing. Defaults `shader_name` to " +
-        "'Standard' (or 'Universal Render Pipeline/Lit' if found). Mutating: runs the full gate " +
-        "path; `paths_hint` must be [\"<new .mat path>\"]. Use unity_open_mcp_shader_list_all first " +
-        "to discover a valid shader name.",
-    inputSchema: {
-        type: "object",
-        required: ["asset_path", "paths_hint"],
-        properties: {
-            asset_path: {
-                type: "string",
-                description: "Destination asset path. Must start with 'Assets/' and end with '.mat'.",
-            },
-            shader_name: {
-                type: "string",
-                description: "Shader name resolvable via Shader.Find (e.g. 'Standard', 'Universal Render Pipeline/Lit', 'Sprites/Default'). " +
-                    "Defaults to 'Standard' (or 'Universal Render Pipeline/Lit' if present).",
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "New .mat path (the gate's validation scope). No whole-project fallback.",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
-            },
+export const materialCreate = makeTool("unity_open_mcp_material_create", "Create a new Material asset at a given Assets/-rooted path ending in .mat, using the " +
+    "named shader. Intermediate folders are created if missing. Defaults `shader_name` to " +
+    "'Standard' (or 'Universal Render Pipeline/Lit' if found). Mutating: runs the full gate " +
+    "path; `paths_hint` must be [\"<new .mat path>\"]. Use unity_open_mcp_shader_list_all first " +
+    "to discover a valid shader name. Refuses to clobber an existing asset at `asset_path` " +
+    "unless `overwrite: true` is passed (CreateAsset re-GUIDs the replacement, breaking every " +
+    "existing scene/prefab reference — prefer material_set_property / material_set_shader to " +
+    "edit in place).", {
+    required: ["asset_path", "paths_hint"],
+    properties: {
+        asset_path: {
+            type: "string",
+            description: "Destination asset path. Must start with 'Assets/' and end with '.mat'.",
         },
-        additionalProperties: false,
+        shader_name: {
+            type: "string",
+            description: "Shader name resolvable via Shader.Find (e.g. 'Standard', 'Universal Render Pipeline/Lit', 'Sprites/Default'). " +
+                "Defaults to 'Standard' (or 'Universal Render Pipeline/Lit' if present).",
+        },
+        overwrite: {
+            type: "boolean",
+            default: false,
+            description: "Allow replacing an existing asset at `asset_path`. DANGEROUS: AssetDatabase.CreateAsset " +
+                "deletes the old asset and the replacement gets a NEW guid, so every scene/prefab/renderer " +
+                "reference to the old material becomes a missing reference. Prefer material_set_property / " +
+                "material_set_shader to edit a material in place. Defaults to false (refuses with `asset_exists`).",
+        },
+        paths_hint: { ...PATHS_HINT_TYPE, description: "New .mat path (the gate's validation scope). No whole-project fallback." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=material-create.js.map

package/dist/tools/material-create.js.map

@@ -1 +1 @@
-{"version":3,"file":"material-create.js","sourceRoot":"","sources":["../../src/tools/material-create.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,wEAAwE;AACxE,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,uFAAuF;QACvF,uFAAuF;QACvF,yFAAyF;QACzF,6FAA6F;QAC7F,kCAAkC;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;QACtC,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wEAAwE;aACtF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gHAAgH;oBAChH,yEAAyE;aAC5E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yEAAyE;aACvF;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"}
+{"version":3,"file":"material-create.js","sourceRoot":"","sources":["../../src/tools/material-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,2EAA2E;AAC3E,wEAAwE;AACxE,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CACpC,gCAAgC,EAChC,uFAAuF;IACrF,uFAAuF;IACvF,yFAAyF;IACzF,6FAA6F;IAC7F,wFAAwF;IACxF,2FAA2F;IAC3F,0FAA0F;IAC1F,iBAAiB,EACnB;IACE,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;IAClC,UAAU,EAAE;QACV,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wEAAwE;SACtF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gHAAgH;gBAChH,yEAAyE;SAC5E;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EACT,0FAA0F;gBAC1F,4FAA4F;gBAC5F,4FAA4F;gBAC5F,mGAAmG;SACtG;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,yEAAyE,EAAE;QAC1H,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/material-get-keywords.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const materialGetKeywords: Tool;
+export declare const materialGetKeywords: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/material-get-keywords.js

@@ -1,23 +1,18 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 1 — read-only material shader-keyword listing. Gate-free.
-export const materialGetKeywords = {
-    name: "unity_open_mcp_material_get_keywords",
-    description: "List the shader keywords currently enabled on a Material. Read-only (gate-free). " +
-        "Resolve the material by `asset_path` (.mat) or `instance_id` of a scene GameObject " +
-        "(its Renderer.sharedMaterial is read) or the Material instance directly.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            asset_path: {
-                type: "string",
-                description: "Material asset path (.mat). Highest priority resolver.",
-            },
-            instance_id: {
-                type: ["string", "integer"],
-                default: 0,
-                description: "Instance ID of a scene GameObject whose Renderer.sharedMaterial is read, OR the Material instance directly.",
-            },
+export const materialGetKeywords = makeTool("unity_open_mcp_material_get_keywords", "List the shader keywords currently enabled on a Material. Read-only (gate-free). " +
+    "Resolve the material by `asset_path` (.mat) or `instance_id` of a scene GameObject " +
+    "(its Renderer.sharedMaterial is read) or the Material instance directly.", {
+    properties: {
+        asset_path: {
+            type: "string",
+            description: "Material asset path (.mat). Highest priority resolver.",
+        },
+        instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Instance ID of a scene GameObject whose Renderer.sharedMaterial is read, OR the Material instance directly.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=material-get-keywords.js.map

package/dist/tools/material-get-keywords.js.map

@@ -1 +1 @@
-{"version":3,"file":"material-get-keywords.js","sourceRoot":"","sources":["../../src/tools/material-get-keywords.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EACT,mFAAmF;QACnF,qFAAqF;QACrF,0EAA0E;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,6GAA6G;aAC3H;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"material-get-keywords.js","sourceRoot":"","sources":["../../src/tools/material-get-keywords.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CACzC,sCAAsC,EACtC,mFAAmF;IACjF,qFAAqF;IACrF,0EAA0E,EAC5E;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wDAAwD;SACtE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,6GAA6G;SAC3H;KACF;CACN,CACF,CAAC"}

package/dist/tools/material-get-properties.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const materialGetProperties: Tool;
+export declare const materialGetProperties: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/material-get-properties.js

@@ -1,32 +1,27 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 1 — read-only material properties. Token-bounded by `max_results`.
 // Read-only: gate-free. Resolves the material by `asset_path` (.mat) or
 // `instance_id` (scene renderer's sharedMaterial).
-export const materialGetProperties = {
-    name: "unity_open_mcp_material_get_properties",
-    description: "List all shader properties of a Material with their current values. Read-only (gate-free). " +
-        "Resolve the material by `asset_path` (.mat) or by `instance_id` of a scene GameObject whose " +
-        "Renderer.sharedMaterial is read. Each property carries name, type (Color/Vector/Float/Range/Int/" +
-        "Texture), description, and value. Token-bounded by `max_results`; remaining count is reported.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            asset_path: {
-                type: "string",
-                description: "Material asset path (.mat). Highest priority resolver.",
-            },
-            instance_id: {
-                type: ["string", "integer"],
-                default: 0,
-                description: "Instance ID of a scene GameObject whose Renderer.sharedMaterial is read, OR the Material instance directly. 0 = not set.",
-            },
-            max_results: {
-                type: "integer",
-                default: 100,
-                minimum: 1,
-                description: "Max properties returned; remaining count is reported in 'truncated'.",
-            },
+export const materialGetProperties = makeTool("unity_open_mcp_material_get_properties", "List all shader properties of a Material with their current values. Read-only (gate-free). " +
+    "Resolve the material by `asset_path` (.mat) or by `instance_id` of a scene GameObject whose " +
+    "Renderer.sharedMaterial is read. Each property carries name, type (Color/Vector/Float/Range/Int/" +
+    "Texture), description, and value. Token-bounded by `max_results`; remaining count is reported.", {
+    properties: {
+        asset_path: {
+            type: "string",
+            description: "Material asset path (.mat). Highest priority resolver.",
+        },
+        instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Instance ID of a scene GameObject whose Renderer.sharedMaterial is read, OR the Material instance directly. 0 = not set.",
+        },
+        max_results: {
+            type: "integer",
+            default: 100,
+            minimum: 1,
+            description: "Max properties returned; remaining count is reported in 'truncated'.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=material-get-properties.js.map