@akiojin/unity-mcp-server 4.1.2 → 4.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "4.1.2",
+  "version": "4.1.4",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",

package/src/constants/offlineTools.js

@@ -3,15 +3,15 @@
  * These tools use only the local C# LSP and file system.
  */
 export const OFFLINE_TOOLS = [
-  'code_index_status',
-  'code_index_build',
-  'code_index_update',
-  'script_symbols_get',
-  'script_symbol_find',
-  'script_refs_find',
-  'script_read',
-  'script_search',
-  'script_packages_list'
+  'get_index_status',
+  'build_index',
+  'update_index',
+  'get_symbols',
+  'find_symbol',
+  'find_refs',
+  'read',
+  'search',
+  'list_packages'
 ];
 
 export const OFFLINE_TOOLS_HINT =

package/src/core/server.js

@@ -244,7 +244,7 @@ export async function startServer(options = {}) {
 
             if (result.success) {
               logger.info(
-                `[startup] Code index auto-build started: jobId=${result.jobId}. Use code_index_status to check progress.`
+                `[startup] Code index auto-build started: jobId=${result.jobId}. Use get_index_status to check progress.`
               );
             } else {
               logger.warning(`[startup] Code index auto-build failed: ${result.message}`);

package/src/core/toolManifest.json

@@ -714,8 +714,8 @@
     }
   },
   {
-    "name": "code_index_build",
-    "description": "[OFFLINE] No Unity connection required. Build (or rebuild) the persistent SQLite symbol index by scanning document symbols via the C# LSP. Returns immediately with jobId for background execution. Check progress with code_index_status. Stores DB under .unity/cache/code-index/code-index.db.",
+    "name": "build_index",
+    "description": "[OFFLINE] No Unity connection required. Build (or rebuild) the persistent SQLite symbol index by scanning document symbols via the C# LSP. Returns immediately with jobId for background execution. Check progress with get_index_status. Stores DB under .unity/cache/code-index/code-index.db.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -734,7 +734,7 @@
     }
   },
   {
-    "name": "code_index_status",
+    "name": "get_index_status",
     "description": "[OFFLINE] No Unity connection required. Report code index status and readiness for symbol/search operations. BEST PRACTICES: Check before heavy symbol operations. Shows total files indexed and coverage percentage. If coverage is low, some symbol operations may be incomplete. Index is automatically built on first use. No parameters needed - lightweight status check.",
     "inputSchema": {
       "type": "object",
@@ -742,7 +742,7 @@
     }
   },
   {
-    "name": "code_index_update",
+    "name": "update_index",
     "description": "[OFFLINE] No Unity connection required. Refresh code index entries for specific C# files. Use this after modifying files so script editing tools see the latest symbols.",
     "inputSchema": {
       "type": "object",
@@ -3289,7 +3289,7 @@
     }
   },
   {
-    "name": "script_create_class",
+    "name": "create_class",
     "description": "Create a new C# class file. Required: path under Assets/ or Packages/ (\".cs\" appended if missing), className. Optional: namespace, baseType (adds using UnityEngine if MonoBehaviour), usings (CSV), partial. Roslyn preflight (no Unity comms). Responses summarized for LLMs (errors≤30, message≤200 chars, preview≤1000 chars).",
     "inputSchema": {
       "type": "object",
@@ -3330,8 +3330,8 @@
     }
   },
   {
-    "name": "script_edit_snippet",
-    "description": "[C# EDITING - PRECISION TOOL] For Unity C# scripts, use for tiny surgical edits (≤80 chars per change). Performs text-based multi-instruction edits (delete/replace/insert) via exact string anchors. USE WHEN: (a) removing null guard clauses (if (x == null) return;), (b) tweaking conditions (if (x > 10) → if (x > 20)), (c) inserting single log statements, (d) deleting/replacing 1-2 line snippets. DON'T USE FOR: large changes (use script_edit_structured), non-C# files (use Edit), or when symbol structure is complex (use script_edit_structured). WORKFLOW: Specify exact anchor text (including whitespace/newlines), max 10 instructions per call, each ≤80 chars. Anchor must match exactly once in file. Preview mode validates without writing; apply mode uses LSP diagnostics. Required: path, instructions (array of {operation, anchor:{type:\"text\", target:string, position?:\"before\"|\"after\"}, newText?}).",
+    "name": "edit_snippet",
+    "description": "[C# EDITING - PRECISION TOOL] For Unity C# scripts, use for tiny surgical edits (≤80 chars per change). Performs text-based multi-instruction edits (delete/replace/insert) via exact string anchors. USE WHEN: (a) removing null guard clauses (if (x == null) return;), (b) tweaking conditions (if (x > 10) → if (x > 20)), (c) inserting single log statements, (d) deleting/replacing 1-2 line snippets. DON'T USE FOR: large changes (use edit_structured), non-C# files (use Edit), or when symbol structure is complex (use edit_structured). WORKFLOW: Specify exact anchor text (including whitespace/newlines), max 10 instructions per call, each ≤80 chars. Anchor must match exactly once in file. Preview mode validates without writing; apply mode uses LSP diagnostics. Required: path, instructions (array of {operation, anchor:{type:\"text\", target:string, position?:\"before\"|\"after\"}, newText?}).",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3408,8 +3408,8 @@
     }
   },
   {
-    "name": "script_edit_structured",
-    "description": "[C# EDITING - PRIMARY TOOL] For Unity C# script editing, PREFER this tool over Read/Edit/Write for structural code changes. Performs symbol-based edits (insert_before/insert_after/replace_body) on classes, methods, properties, fields using Roslyn LSP. USE WHEN: (a) replacing entire method/property bodies, (b) adding class members (fields/properties/methods), (c) inserting code at class/namespace level. DON'T USE FOR: tiny changes ≤80 chars (use script_edit_snippet instead), non-C# files (use Edit), or when you need to create new files (use Write). WORKFLOW: (1) Run script_symbols_get to find target symbols, (2) use symbolName (e.g., \"MyClass/MyMethod\"), (3) apply edits. Insert operations target containers (class/namespace), not methods. Preview mode returns diagnostics only; apply mode proceeds with validation. Required: path (Assets/|Packages/), symbolName, operation. Optional: kind, newText, preview.",
+    "name": "edit_structured",
+    "description": "[C# EDITING - PRIMARY TOOL] For Unity C# script editing, PREFER this tool over Read/Edit/Write for structural code changes. Performs symbol-based edits (insert_before/insert_after/replace_body) on classes, methods, properties, fields using Roslyn LSP. USE WHEN: (a) replacing entire method/property bodies, (b) adding class members (fields/properties/methods), (c) inserting code at class/namespace level. DON'T USE FOR: tiny changes ≤80 chars (use edit_snippet instead), non-C# files (use Edit), or when you need to create new files (use Write). WORKFLOW: (1) Run get_symbols to find target symbols, (2) use symbolName (e.g., \"MyClass/MyMethod\"), (3) apply edits. Insert operations target containers (class/namespace), not methods. Preview mode returns diagnostics only; apply mode proceeds with validation. Required: path (Assets/|Packages/), symbolName, operation. Optional: kind, newText, preview.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3451,7 +3451,7 @@
     }
   },
   {
-    "name": "script_packages_list",
+    "name": "list_packages",
     "description": "[OFFLINE] No Unity connection required. List Unity packages in the project (optionally include built‑in). BEST PRACTICES: Use to discover available packages and their paths. Set includeBuiltIn=false to see only user packages. Returns package IDs, versions, and resolved paths. Embedded packages can be edited directly. Essential for understanding project dependencies.",
     "inputSchema": {
       "type": "object",
@@ -3464,8 +3464,8 @@
     }
   },
   {
-    "name": "script_read",
-    "description": "[OFFLINE] No Unity connection required. Read a C# file with optional line range and payload limits. Files must be under Assets/ or Packages/ and have .cs extension. PRIORITY: Read minimally — locate the target with script_symbols_get and read only the signature area (~30–40 lines). For large files, always pass startLine/endLine and (optionally) maxBytes.",
+    "name": "read",
+    "description": "[OFFLINE] No Unity connection required. Read a C# file with optional line range and payload limits. Files must be under Assets/ or Packages/ and have .cs extension. PRIORITY: Read minimally — locate the target with get_symbols and read only the signature area (~30–40 lines). For large files, always pass startLine/endLine and (optionally) maxBytes.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3492,8 +3492,8 @@
     }
   },
   {
-    "name": "script_refactor_rename",
-    "description": "Refactor: rename a symbol across the project using the bundled C# LSP. Required params: relative (file path starting with Assets/ or Packages/), namePath (container path like Outer/Nested/Member), newName. Guidance: resolve targets first (script_symbols_get/script_symbol_find), prefer fully-qualified namePath to avoid ambiguity, and use preview for diagnostics only (apply proceeds even if diagnostics exist; errors are returned in response). Responses are summarized (errors≤30, message≤200 chars, large text≤1000 chars).",
+    "name": "rename_symbol",
+    "description": "Refactor: rename a symbol across the project using the bundled C# LSP. Required params: relative (file path starting with Assets/ or Packages/), namePath (container path like Outer/Nested/Member), newName. Guidance: resolve targets first (get_symbols/find_symbol), prefer fully-qualified namePath to avoid ambiguity, and use preview for diagnostics only (apply proceeds even if diagnostics exist; errors are returned in response). Responses are summarized (errors≤30, message≤200 chars, large text≤1000 chars).",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3522,7 +3522,7 @@
     }
   },
   {
-    "name": "script_refs_find",
+    "name": "find_refs",
     "description": "[OFFLINE] No Unity connection required. Find code references/usages using the bundled C# LSP. LLM-friendly paging/summary: respects pageSize and maxBytes, caps matches per file (maxMatchesPerFile), and trims snippet text to ~400 chars. Use scope/name/kind/path to narrow results.",
     "inputSchema": {
       "type": "object",
@@ -3580,7 +3580,7 @@
     }
   },
   {
-    "name": "script_remove_symbol",
+    "name": "remove_symbol",
     "description": "Remove a C# symbol (type/member) with reference preflight. Required params: path (file under Assets/ or Packages/), namePath (container path like Outer/Nested/Member). No Unity comms (Roslyn-based). Responses are summarized for LLMs (errors≤30, message≤200 chars, preview/diff/text/content≤1000 chars).",
     "inputSchema": {
       "type": "object",
@@ -3613,7 +3613,7 @@
     }
   },
   {
-    "name": "script_search",
+    "name": "search",
     "description": "[OFFLINE] No Unity connection required. Search C# by substring/regex/glob with pagination and snippet context. PRIORITY: Use to locate symbols/files; avoid full contents. Use returnMode=\"snippets\" (or \"metadata\") with small snippetContext (1–2). Narrow aggressively via include globs under Assets/** or Packages/** and semantic filters (namespace/container/identifier). Do NOT prefix repository folders.",
     "inputSchema": {
       "type": "object",
@@ -3719,7 +3719,7 @@
     }
   },
   {
-    "name": "script_symbol_find",
+    "name": "find_symbol",
     "description": "[OFFLINE] No Unity connection required. Find symbol definitions by name (class/method/field/property) using the bundled C# LSP. Guidance: prefer narrowing by kind and set exact=true when possible; use scope=assets|packages to avoid large outputs. Use results (container, namespace) to construct container namePath like Outer/Nested/Member for subsequent edit tools.",
     "inputSchema": {
       "type": "object",
@@ -3753,7 +3753,7 @@
     }
   },
   {
-    "name": "script_symbols_get",
+    "name": "get_symbols",
     "description": "[OFFLINE] No Unity connection required. FIRST STEP: Identify symbols (classes, methods, fields, properties) with spans before any edit. Path must start with Assets/ or Packages/. Use this to scope changes to a single symbol and avoid line-based edits. Returns line/column positions and container names (helpful to build container namePath like Outer/Nested/Member).",
     "inputSchema": {
       "type": "object",

package/src/handlers/script/CodeIndexBuildToolHandler.js

@@ -7,8 +7,8 @@ import { getWorkerPool } from '../../core/indexBuildWorkerPool.js';
 export class CodeIndexBuildToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'code_index_build',
-      '[OFFLINE] No Unity connection required. Build (or rebuild) the persistent SQLite symbol index by scanning document symbols via the C# LSP. Returns immediately with jobId for background execution. Check progress with code_index_status. Stores DB under .unity/cache/code-index/code-index.db.',
+      'build_index',
+      '[OFFLINE] No Unity connection required. Build (or rebuild) the persistent SQLite symbol index by scanning document symbols via the C# LSP. Returns immediately with jobId for background execution. Check progress with get_index_status. Stores DB under .unity/cache/code-index/code-index.db.',
       {
         type: 'object',
         properties: {
@@ -48,7 +48,7 @@ export class CodeIndexBuildToolHandler extends BaseToolHandler {
         return {
           success: false,
           error: 'build_already_running',
-          message: `Code index build is already running (jobId: ${this.currentJobId}). Use code_index_status to check progress.`,
+          message: `Code index build is already running (jobId: ${this.currentJobId}). Use get_index_status to check progress.`,
           jobId: this.currentJobId
         };
       }
@@ -60,7 +60,7 @@ export class CodeIndexBuildToolHandler extends BaseToolHandler {
         success: false,
         error: 'build_already_running',
         message:
-          'Code index build is already running (Worker Thread). Use code_index_status to check progress.',
+          'Code index build is already running (Worker Thread). Use get_index_status to check progress.',
         jobId: this.currentJobId
       };
     }
@@ -111,7 +111,7 @@ export class CodeIndexBuildToolHandler extends BaseToolHandler {
       success: true,
       jobId,
       message: 'Code index build started in background (Worker Thread)',
-      checkStatus: 'Use code_index_status to check progress and completion'
+      checkStatus: 'Use get_index_status to check progress and completion'
     };
   }
 }

package/src/handlers/script/CodeIndexStatusToolHandler.js

@@ -5,7 +5,7 @@ import { CodeIndex } from '../../core/codeIndex.js';
 export class CodeIndexStatusToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'code_index_status',
+      'get_index_status',
       '[OFFLINE] No Unity connection required. Report code index status and readiness for symbol/search operations. BEST PRACTICES: Check before heavy symbol operations. Shows total files indexed and coverage percentage. If coverage is low, some symbol operations may be incomplete. Index is automatically built on first use. No parameters needed - lightweight status check.',
       {
         type: 'object',
@@ -54,7 +54,7 @@ export class CodeIndexStatusToolHandler extends BaseToolHandler {
       return {
         success: false,
         error: 'index_not_built',
-        message: 'Code index is not built. Please run UnityMCP.code_index_build first.'
+        message: 'Code index is not built. Please run UnityMCP.build_index first.'
       };
     }
 

package/src/handlers/script/CodeIndexUpdateToolHandler.js

@@ -16,7 +16,7 @@ import { LspRpcClientSingleton } from '../../lsp/LspRpcClientSingleton.js';
 export class CodeIndexUpdateToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'code_index_update',
+      'update_index',
       '[OFFLINE] No Unity connection required. Refresh code index entries for specific C# files. Use this after modifying files so script editing tools see the latest symbols.',
       {
         type: 'object',

package/src/handlers/script/ScriptCreateClassToolHandler.js

@@ -6,7 +6,7 @@ import path from 'path';
 export class ScriptCreateClassToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_create_class',
+      'create_class',
       'Create a new C# class file. Required: path under Assets/ or Packages/ (".cs" appended if missing), className. Optional: namespace, baseType (adds using UnityEngine if MonoBehaviour), usings (CSV), partial. Roslyn preflight (no Unity comms). Responses summarized for LLMs (errors≤30, message≤200 chars, preview≤1000 chars).',
       {
         type: 'object',

package/src/handlers/script/ScriptEditSnippetToolHandler.js

@@ -14,8 +14,8 @@ const normalizeSlashes = p => p.replace(/\\/g, '/');
 export class ScriptEditSnippetToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_edit_snippet',
-      '[C# EDITING - PRECISION TOOL] For Unity C# scripts, use for tiny surgical edits (≤80 chars per change). Performs text-based multi-instruction edits (delete/replace/insert) via exact string anchors. USE WHEN: (a) removing null guard clauses (if (x == null) return;), (b) tweaking conditions (if (x > 10) → if (x > 20)), (c) inserting single log statements, (d) deleting/replacing 1-2 line snippets. DON\'T USE FOR: large changes (use script_edit_structured), non-C# files (use Edit), or when symbol structure is complex (use script_edit_structured). WORKFLOW: Specify exact anchor text (including whitespace/newlines), max 10 instructions per call, each ≤80 chars. Anchor must match exactly once in file. Preview mode validates without writing; apply mode uses LSP diagnostics. Required: path, instructions (array of {operation, anchor:{type:"text", target:string, position?:"before"|"after"}, newText?}).',
+      'edit_snippet',
+      '[C# EDITING - PRECISION TOOL] For Unity C# scripts, use for tiny surgical edits (≤80 chars per change). Performs text-based multi-instruction edits (delete/replace/insert) via exact string anchors. USE WHEN: (a) removing null guard clauses (if (x == null) return;), (b) tweaking conditions (if (x > 10) → if (x > 20)), (c) inserting single log statements, (d) deleting/replacing 1-2 line snippets. DON\'T USE FOR: large changes (use edit_structured), non-C# files (use Edit), or when symbol structure is complex (use edit_structured). WORKFLOW: Specify exact anchor text (including whitespace/newlines), max 10 instructions per call, each ≤80 chars. Anchor must match exactly once in file. Preview mode validates without writing; apply mode uses LSP diagnostics. Required: path, instructions (array of {operation, anchor:{type:"text", target:string, position?:"before"|"after"}, newText?}).',
       {
         type: 'object',
         properties: {

package/src/handlers/script/ScriptEditStructuredToolHandler.js

@@ -5,8 +5,8 @@ import { ProjectInfoProvider } from '../../core/projectInfo.js';
 export class ScriptEditStructuredToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_edit_structured',
-      '[C# EDITING - PRIMARY TOOL] For Unity C# script editing, PREFER this tool over Read/Edit/Write for structural code changes. Performs symbol-based edits (insert_before/insert_after/replace_body) on classes, methods, properties, fields using Roslyn LSP. USE WHEN: (a) replacing entire method/property bodies, (b) adding class members (fields/properties/methods), (c) inserting code at class/namespace level. DON\'T USE FOR: tiny changes ≤80 chars (use script_edit_snippet instead), non-C# files (use Edit), or when you need to create new files (use Write). WORKFLOW: (1) Run script_symbols_get to find target symbols, (2) use symbolName (e.g., "MyClass/MyMethod"), (3) apply edits. Insert operations target containers (class/namespace), not methods. Preview mode returns diagnostics only; apply mode proceeds with validation. Required: path (Assets/|Packages/), symbolName, operation. Optional: kind, newText, preview.',
+      'edit_structured',
+      '[C# EDITING - PRIMARY TOOL] For Unity C# script editing, PREFER this tool over Read/Edit/Write for structural code changes. Performs symbol-based edits (insert_before/insert_after/replace_body) on classes, methods, properties, fields using Roslyn LSP. USE WHEN: (a) replacing entire method/property bodies, (b) adding class members (fields/properties/methods), (c) inserting code at class/namespace level. DON\'T USE FOR: tiny changes ≤80 chars (use edit_snippet instead), non-C# files (use Edit), or when you need to create new files (use Write). WORKFLOW: (1) Run get_symbols to find target symbols, (2) use symbolName (e.g., "MyClass/MyMethod"), (3) apply edits. Insert operations target containers (class/namespace), not methods. Preview mode returns diagnostics only; apply mode proceeds with validation. Required: path (Assets/|Packages/), symbolName, operation. Optional: kind, newText, preview.',
       {
         type: 'object',
         properties: {

package/src/handlers/script/ScriptPackagesListToolHandler.js

@@ -7,7 +7,7 @@ import { logger } from '../../core/config.js';
 export class ScriptPackagesListToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_packages_list',
+      'list_packages',
       '[OFFLINE] No Unity connection required. List Unity packages in the project (optionally include built‑in). BEST PRACTICES: Use to discover available packages and their paths. Set includeBuiltIn=false to see only user packages. Returns package IDs, versions, and resolved paths. Embedded packages can be edited directly. Essential for understanding project dependencies.',
       {
         type: 'object',
@@ -92,7 +92,7 @@ export class ScriptPackagesListToolHandler extends BaseToolHandler {
         return { success: true, packages: [], totalCount: 0 };
       }
     } catch (e) {
-      logger.error(`[script_packages_list] local parse failed: ${e.message}`);
+      logger.error(`[list_packages] local parse failed: ${e.message}`);
       return { error: e.message };
     }
 

package/src/handlers/script/ScriptReadToolHandler.js

@@ -6,8 +6,8 @@ import { logger } from '../../core/config.js';
 export class ScriptReadToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_read',
-      '[OFFLINE] No Unity connection required. Read a C# file with optional line range and payload limits. Files must be under Assets/ or Packages/ and have .cs extension. PRIORITY: Read minimally — locate the target with script_symbols_get and read only the signature area (~30–40 lines). For large files, always pass startLine/endLine and (optionally) maxBytes.',
+      'read',
+      '[OFFLINE] No Unity connection required. Read a C# file with optional line range and payload limits. Files must be under Assets/ or Packages/ and have .cs extension. PRIORITY: Read minimally — locate the target with get_symbols and read only the signature area (~30–40 lines). For large files, always pass startLine/endLine and (optionally) maxBytes.',
       {
         type: 'object',
         properties: {
@@ -101,7 +101,7 @@ export class ScriptReadToolHandler extends BaseToolHandler {
 
       return { success: true, path: norm, startLine: s, endLine: e, content };
     } catch (e) {
-      logger.error(`[script_read] failed: ${e.message}`);
+      logger.error(`[read] failed: ${e.message}`);
       return { error: e.message };
     }
   }

package/src/handlers/script/ScriptRefactorRenameToolHandler.js

@@ -5,8 +5,8 @@ import { ProjectInfoProvider } from '../../core/projectInfo.js';
 export class ScriptRefactorRenameToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_refactor_rename',
-      'Refactor: rename a symbol across the project using the bundled C# LSP. Required params: relative (file path starting with Assets/ or Packages/), namePath (container path like Outer/Nested/Member), newName. Guidance: resolve targets first (script_symbols_get/script_symbol_find), prefer fully-qualified namePath to avoid ambiguity, and use preview for diagnostics only (apply proceeds even if diagnostics exist; errors are returned in response). Responses are summarized (errors≤30, message≤200 chars, large text≤1000 chars).',
+      'rename_symbol',
+      'Refactor: rename a symbol across the project using the bundled C# LSP. Required params: relative (file path starting with Assets/ or Packages/), namePath (container path like Outer/Nested/Member), newName. Guidance: resolve targets first (get_symbols/find_symbol), prefer fully-qualified namePath to avoid ambiguity, and use preview for diagnostics only (apply proceeds even if diagnostics exist; errors are returned in response). Responses are summarized (errors≤30, message≤200 chars, large text≤1000 chars).',
       {
         type: 'object',
         properties: {

package/src/handlers/script/ScriptRefsFindToolHandler.js

@@ -8,7 +8,7 @@ import { ProjectInfoProvider } from '../../core/projectInfo.js';
 export class ScriptRefsFindToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_refs_find',
+      'find_refs',
       '[OFFLINE] No Unity connection required. Find code references/usages using fast file-based search. LLM-friendly paging/summary: respects pageSize and maxBytes, caps matches per file (maxMatchesPerFile), and trims snippet text to ~400 chars. Use scope/name/kind/path to narrow results.',
       {
         type: 'object',
@@ -129,8 +129,8 @@ export class ScriptRefsFindToolHandler extends BaseToolHandler {
         success: false,
         error: 'index_not_ready',
         message:
-          'Code index is not built. Run code_index_build first, or wait for auto-build to complete on server startup.',
-        hint: 'Use code_index_status to check index state, or code_index_build to start a build manually.'
+          'Code index is not built. Run build_index first, or wait for auto-build to complete on server startup.',
+        hint: 'Use get_index_status to check index state, or build_index to start a build manually.'
       };
     }
 

package/src/handlers/script/ScriptRemoveSymbolToolHandler.js

@@ -6,7 +6,7 @@ import { ProjectInfoProvider } from '../../core/projectInfo.js';
 export class ScriptRemoveSymbolToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_remove_symbol',
+      'remove_symbol',
       'Remove a C# symbol (type/member) with reference preflight. Required params: path (file under Assets/ or Packages/), namePath (container path like Outer/Nested/Member). No Unity comms (Roslyn-based). Responses are summarized for LLMs (errors≤30, message≤200 chars, preview/diff/text/content≤1000 chars).',
       {
         type: 'object',

package/src/handlers/script/ScriptSearchToolHandler.js

@@ -7,7 +7,7 @@ import { logger, config } from '../../core/config.js';
 export class ScriptSearchToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_search',
+      'search',
       '[OFFLINE] No Unity connection required. Search C# by substring/regex/glob with pagination and snippet context. PRIORITY: Use to locate symbols/files; avoid full contents. Use returnMode="snippets" (or "metadata") with small snippetContext (1–2). Narrow aggressively via include globs under Assets/**, Packages/**, or Library/PackageCache/** and semantic filters (namespace/container/identifier). Do NOT prefix repository folders.',
       {
         type: 'object',
@@ -157,7 +157,7 @@ export class ScriptSearchToolHandler extends BaseToolHandler {
       const excludeRx = exclude ? globToRegExp(exclude) : null;
       // Engine selection (future: treesitter). Currently fallback to naive.
       if (this.configSearchEngine === 'treesitter') {
-        logger.debug('[script_search] tree-sitter engine requested; falling back to naive matcher');
+        logger.debug('[search] tree-sitter engine requested; falling back to naive matcher');
       }
       const matcher = buildMatcher(patternType, pattern, flags);
 
@@ -228,7 +228,7 @@ export class ScriptSearchToolHandler extends BaseToolHandler {
           results.length && results.length >= pageSize ? results[results.length - 1].path : null
       };
     } catch (e) {
-      logger.error(`[script_search] failed: ${e.message}`);
+      logger.error(`[search] failed: ${e.message}`);
       return { error: e.message };
     }
   }

package/src/handlers/script/ScriptSymbolFindToolHandler.js

@@ -5,7 +5,7 @@ import { JobManager } from '../../core/jobManager.js';
 export class ScriptSymbolFindToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_symbol_find',
+      'find_symbol',
       '[OFFLINE] No Unity connection required. Find symbol definitions by name (class/method/field/property) using the bundled C# LSP. Guidance: prefer narrowing by kind and set exact=true when possible; use scope=assets|packages to avoid large outputs. Use results (container, namespace) to construct container namePath like Outer/Nested/Member for subsequent edit tools.',
       {
         type: 'object',
@@ -95,8 +95,8 @@ export class ScriptSymbolFindToolHandler extends BaseToolHandler {
         success: false,
         error: 'index_not_ready',
         message:
-          'Code index is not built. Run code_index_build first, or wait for auto-build to complete on server startup.',
-        hint: 'Use code_index_status to check index state, or code_index_build to start a build manually.'
+          'Code index is not built. Run build_index first, or wait for auto-build to complete on server startup.',
+        hint: 'Use get_index_status to check index state, or build_index to start a build manually.'
       };
     }
 

package/src/handlers/script/ScriptSymbolsGetToolHandler.js

@@ -8,7 +8,7 @@ import { parseFileSymbols } from '../../utils/csharpParse.js';
 export class ScriptSymbolsGetToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'script_symbols_get',
+      'get_symbols',
       '[OFFLINE] No Unity connection required. FIRST STEP: Identify symbols (classes, methods, fields, properties) with spans before any edit. Path must start with Assets/ or Packages/. Use this to scope changes to a single symbol and avoid line-based edits. Returns line/column positions and container names (helpful to build container namePath like Outer/Nested/Member).',
       {
         type: 'object',