docs: improve tool descriptions with clearer action explanations

Author: msanatan

UnityMcpBridge/UnityMcpServer~/src/tools/manage_asset.py

@@ -17,7 +17,7 @@ def register_manage_asset_tools(mcp: FastMCP):
     @telemetry_tool("manage_asset")
     async def manage_asset(
         ctx: Context,
-        action: Annotated[Literal["import", "create", "modify", "delete", "duplicate", "move", "rename", "search", "get_info", "create_folder", "get_components"], "Operations"],
+        action: Annotated[Literal["import", "create", "modify", "delete", "duplicate", "move", "rename", "search", "get_info", "create_folder", "get_components"], "Perform CRUD operations on assets."],
         path: Annotated[str, "Asset path (e.g., 'Materials/MyMaterial.mat') or search scope."],
         asset_type: Annotated[str,
                               "Asset type (e.g., 'Material', 'Folder') - required for 'create'."] | None = None,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_editor.py

@@ -15,7 +15,7 @@ def register_manage_editor_tools(mcp: FastMCP):
     def manage_editor(
         ctx: Context,
         action: Annotated[Literal["telemetry_status", "telemetry_ping", "play", "pause", "stop", "get_state", "get_project_root", "get_windows",
-                                  "get_active_tool", "get_selection", "get_prefab_stage", "set_active_tool", "add_tag", "remove_tag", "get_tags", "add_layer", "remove_layer", "get_layers"], "Operations"],
+                                  "get_active_tool", "get_selection", "get_prefab_stage", "set_active_tool", "add_tag", "remove_tag", "get_tags", "add_layer", "remove_layer", "get_layers"], "Get and update the Unity Editor state."],
         wait_for_completion: Annotated[bool,
                                        "Optional. If True, waits for certain actions"] | None = None,
         tool_name: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_gameobject.py

@@ -13,7 +13,7 @@ def register_manage_gameobject_tools(mcp: FastMCP):
     @telemetry_tool("manage_gameobject")
     def manage_gameobject(
         ctx: Context,
-        action: Literal["create", "modify", "delete", "find", "add_component", "remove_component", "set_component_property", "get_components"],
+        action: Annotated[Literal["create", "modify", "delete", "find", "add_component", "remove_component", "set_component_property", "get_components"], "Perform CRUD operations on GameObjects and components."],
         target: Annotated[str,
                           "GameObject identifier by name or path for modify/delete/component actions"] | None = None,
         search_method: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_menu_item.py

@@ -17,7 +17,7 @@ def register_manage_menu_item_tools(mcp: FastMCP):
     @telemetry_tool("manage_menu_item")
     async def manage_menu_item(
         ctx: Context,
-        action: Annotated[Literal["execute", "list", "exists"], "Operations"],
+        action: Annotated[Literal["execute", "list", "exists"], "Read and execute Unity menu items."],
         menu_path: Annotated[str,
                              "Menu path for 'execute' or 'exists' (e.g., 'File/Save Project')"] | None = None,
         search: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_prefabs.py

@@ -18,7 +18,7 @@ def manage_prefabs(
             "close_stage",
             "save_open_stage",
             "create_from_gameobject",
-        ], "Operations"],
+        ], "Manage prefabs (stage control and creation)."],
         prefab_path: Annotated[str,
                                "Prefab asset path relative to Assets e.g. Assets/Prefabs/favorite.prefab"] | None = None,
         mode: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_scene.py

@@ -13,7 +13,7 @@ def register_manage_scene_tools(mcp: FastMCP):
     @telemetry_tool("manage_scene")
     def manage_scene(
         ctx: Context,
-        action: Annotated[Literal["create", "load", "save", "get_hierarchy", "get_active", "get_build_settings"], "Operations"],
+        action: Annotated[Literal["create", "load", "save", "get_hierarchy", "get_active", "get_build_settings"], "Perform CRUD operations on Unity scenes."],
         name: Annotated[str,
                         "Scene name. Not required get_active/get_build_settings"] | None = None,
         path: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/manage_script.py

@@ -455,7 +455,7 @@ def validate_script(
     @telemetry_tool("manage_script")
     def manage_script(
         ctx: Context,
-        action: Annotated[Literal['create', 'read', 'delete'], "Operations"],
+        action: Annotated[Literal['create', 'read', 'delete'], "Perform CRUD operations on C# scripts."],
         name: Annotated[str, "Script name (no .cs extension)", "Name of the script to create"],
         path: Annotated[str, "Asset path (default: 'Assets/')", "Path under Assets/ to create the script at, e.g., 'Assets/Scripts/My.cs'"],
         contents: Annotated[str, "Contents of the script to create",

UnityMcpBridge/UnityMcpServer~/src/tools/manage_shader.py

@@ -14,7 +14,7 @@ def register_manage_shader_tools(mcp: FastMCP):
     @telemetry_tool("manage_shader")
     def manage_shader(
         ctx: Context,
-        action: Annotated[Literal['create', 'read', 'update', 'delete'], "Operations"],
+        action: Annotated[Literal['create', 'read', 'update', 'delete'], "Perform CRUD operations on shader scripts."],
         name: Annotated[str, "Shader name (no .cs extension)"],
         path: Annotated[str, "Asset path (default: \"Assets/\")"],
         contents: Annotated[str,

UnityMcpBridge/UnityMcpServer~/src/tools/read_console.py

@@ -16,7 +16,7 @@ def register_read_console_tools(mcp: FastMCP):
     @telemetry_tool("read_console")
     def read_console(
         ctx: Context,
-        action: Annotated[Literal['get', 'clear'], "Operations"],
+        action: Annotated[Literal['get', 'clear'], "Get or clear the Unity Editor console."],
         types: Annotated[list[Literal['error', 'warning',
                                       'log', 'all']], "Message types to get"] | None = None,
         count: Annotated[int, "Max messages to return"] | None = None,