Payload-safe paging for hierarchy/components + safer asset search + docs

MCPForUnity/Editor/Clients/McpClientConfiguratorBase.cs

@@ -423,7 +423,11 @@ private void Register()
             else
             {
                 var (uvxPath, gitUrl, packageName) = AssetPathUtility.GetUvxCommandParts();
-                args = $"mcp add --transport stdio UnityMCP -- \"{uvxPath}\" --from \"{gitUrl}\" {packageName}";
+                bool devForceRefresh = false;
+                try { devForceRefresh = EditorPrefs.GetBool(EditorPrefKeys.DevModeForceServerRefresh, false); } catch { }
+
+                string devFlags = devForceRefresh ? "--no-cache --refresh " : string.Empty;
+                args = $"mcp add --transport stdio UnityMCP -- \"{uvxPath}\" {devFlags}--from \"{gitUrl}\" {packageName}";
             }
 
             string projectDir = Path.GetDirectoryName(Application.dataPath);
@@ -537,8 +541,11 @@ public override string GetManualSnippet()
             }
 
             string gitUrl = AssetPathUtility.GetMcpServerGitUrl();
+            bool devForceRefresh = false;
+            try { devForceRefresh = EditorPrefs.GetBool(EditorPrefKeys.DevModeForceServerRefresh, false); } catch { }
+
             return "# Register the MCP server with Claude Code:\n" +
-                   $"claude mcp add --transport stdio UnityMCP -- \"{uvxPath}\" --from \"{gitUrl}\" mcp-for-unity\n\n" +
+                   $"claude mcp add --transport stdio UnityMCP -- \"{uvxPath}\" {(devForceRefresh ? "--no-cache --refresh " : string.Empty)}--from \"{gitUrl}\" mcp-for-unity\n\n" +
                    "# Unregister the MCP server:\n" +
                    "claude mcp remove UnityMCP\n\n" +
                    "# List registered servers:\n" +

MCPForUnity/Editor/Constants/EditorPrefKeys.cs

@@ -20,6 +20,7 @@ internal static class EditorPrefKeys
         internal const string SessionId = "MCPForUnity.SessionId";
         internal const string WebSocketUrlOverride = "MCPForUnity.WebSocketUrl";
         internal const string GitUrlOverride = "MCPForUnity.GitUrlOverride";
+        internal const string DevModeForceServerRefresh = "MCPForUnity.DevModeForceServerRefresh";
 
         internal const string PackageDeploySourcePath = "MCPForUnity.PackageDeploy.SourcePath";
         internal const string PackageDeployLastBackupPath = "MCPForUnity.PackageDeploy.LastBackupPath";

MCPForUnity/Editor/Helpers/CodexConfigHelper.cs

@@ -2,9 +2,11 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using MCPForUnity.Editor.Constants;
 using MCPForUnity.Editor.Services;
 using MCPForUnity.External.Tommy;
 using UnityEditor;
+using UnityEngine;
 
 namespace MCPForUnity.Editor.Helpers
 {
@@ -37,9 +39,17 @@ public static string BuildCodexServerBlock(string uvPath)
             {
                 // Stdio mode: Use command and args
                 var (uvxPath, fromUrl, packageName) = AssetPathUtility.GetUvxCommandParts();
+                bool devForceRefresh = false;
+                try { devForceRefresh = EditorPrefs.GetBool(EditorPrefKeys.DevModeForceServerRefresh, false); } catch { }
+
                 unityMCP["command"] = uvxPath;
 
                 var args = new TomlArray();
+                if (devForceRefresh)
+                {
+                    args.Add(new TomlString { Value = "--no-cache" });
+                    args.Add(new TomlString { Value = "--refresh" });
+                }
                 if (!string.IsNullOrEmpty(fromUrl))
                 {
                     args.Add(new TomlString { Value = "--from" });
@@ -184,9 +194,17 @@ private static TomlTable CreateUnityMcpTable(string uvPath)
             {
                 // Stdio mode: Use command and args
                 var (uvxPath, fromUrl, packageName) = AssetPathUtility.GetUvxCommandParts();
+                bool devForceRefresh = false;
+                try { devForceRefresh = EditorPrefs.GetBool(EditorPrefKeys.DevModeForceServerRefresh, false); } catch { }
+
                 unityMCP["command"] = new TomlString { Value = uvxPath };
 
                 var argsArray = new TomlArray();
+                if (devForceRefresh)
+                {
+                    argsArray.Add(new TomlString { Value = "--no-cache" });
+                    argsArray.Add(new TomlString { Value = "--refresh" });
+                }
                 if (!string.IsNullOrEmpty(fromUrl))
                 {
                     argsArray.Add(new TomlString { Value = "--from" });

MCPForUnity/Editor/Helpers/ConfigJsonBuilder.cs

@@ -81,7 +81,10 @@ private static void PopulateUnityNode(JObject unity, string uvPath, McpClient cl
                 // Stdio mode: Use uvx command
                 var (uvxPath, fromUrl, packageName) = AssetPathUtility.GetUvxCommandParts();
 
-                var toolArgs = BuildUvxArgs(fromUrl, packageName);
+                bool devForceRefresh = false;
+                try { devForceRefresh = EditorPrefs.GetBool(EditorPrefKeys.DevModeForceServerRefresh, false); } catch { }
+
+                var toolArgs = BuildUvxArgs(fromUrl, packageName, devForceRefresh);
 
                 if (ShouldUseWindowsCmdShim(client))
                 {
@@ -149,9 +152,13 @@ private static JObject EnsureObject(JObject parent, string name)
             return created;
         }
 
-        private static IList<string> BuildUvxArgs(string fromUrl, string packageName)
+        private static IList<string> BuildUvxArgs(string fromUrl, string packageName, bool devForceRefresh)
         {
-            var args = new List<string> { packageName };
+            // Dev mode: force a fresh install/resolution (avoids stale cached builds while iterating).
+            // `--no-cache` is the key flag; `--refresh` ensures metadata is revalidated.
+            var args = devForceRefresh
+                ? new List<string> { "--no-cache", "--refresh", packageName }
+                : new List<string> { packageName };
 
             if (!string.IsNullOrEmpty(fromUrl))
             {