ue-mcp 1.3.1-beta.1 → 1.3.1-beta.2

package/README.md

@@ -177,7 +177,7 @@ Details: [Guards](https://ue-mcp.com/docs/plugins-guards/) and [Handler Conventi
 
 | | |
 |---|---|
-| **Unreal Engine** | 5.4-5.8 (Windows), 5.6+ (Linux and macOS). `epic` category needs 5.8+. |
+| **Unreal Engine** | 5.4-5.8 (Windows), 5.6+ (Linux and macOS). Compiled and verified on 5.7 and 5.8; 5.4 to 5.6 are version-gated in source but not built here. `epic` category needs 5.8+. |
 | **Node.js** | 18 or newer |
 | **UE plugins** | `PythonScriptPlugin` (ships with the engine); `init` enables the rest for you |
 | **C++ toolchain** | Required - the bridge is a C++ plugin and compiles on first editor launch. On Windows that means Visual Studio with the C++ workload; on macOS, Xcode command line tools. |

package/dist/action-class.js

@@ -267,7 +267,13 @@ const OVERRIDES = {
     // terrain, but a file appearing on disk is an external side effect and the
     // taxonomy above counts that as a mutation.
     "landscape.export_heightmap": "mutate",
-    "audio.extract_pcm": "mutate",
+    // Not one of the exports above, despite sitting next to them here since it
+    // was written. It decodes a USoundWave's imported audio into memory and
+    // returns the samples base64-encoded in the response: no intermediate file,
+    // no path parameter to write one to, nothing dirtied and nothing saved. It
+    // was classified `mutate` by association with the file-writing exports, and
+    // the handler body settles it the other way.
+    "audio.extract_pcm": "read",
     // Rebuilds the full-text index in the editor's own database.
     "asset.reindex_fts": "mutate",
     // Loads, rewrites and saves the packages that reference a set of
@@ -288,6 +294,31 @@ const OVERRIDES = {
     // The verb says read; what it can do says mutate, and the gate follows what
     // it can do.
     "gas.get_live_attribute_value": "mutate",
+    // Runs an EQS query through FEnvQueryManager::RunInstantQuery against an
+    // already-spawned querier and serialises the scored items. `run` is a mutate
+    // verb and this one does not: no spawn, no Modify, no save, nothing written
+    // back to the query asset or the world. Landing it in the wrong editor
+    // returns the wrong scores and changes nothing.
+    "gameplay.run_eqs_query": "read",
+    // ── Reads whose name leads with a subsystem, not a verb ─────────────
+    // The lexicon only trusts a read verb in the leading segment, so these say
+    // out loud what they read. Each one was confirmed against its handler: they
+    // open an asset, walk a graph or a document, and write nothing back.
+    "audio.metasound_get_graph": "read",
+    "audio.metasound_read_document": "read",
+    "audio.metasound_list_node_classes": "read",
+    "audio.metasound_list_node_pins": "read",
+    "audio.metasound_list_connections": "read",
+    "audio.metasound_list_variables": "read",
+    "audio.metasound_search_nodes": "read",
+    "audio.metasound_inspect_node": "read",
+    // Runs the MetaSound builder's own validation over a document and reports
+    // the errors. It builds nothing and saves nothing.
+    "audio.metasound_validate": "read",
+    "audio.cue_get_graph": "read",
+    // Answers whether a named weightmap layer is present on a landscape. The
+    // `exists` question never creates the layer it asks about.
+    "landscape.layer_exists": "read",
     // ── The workflow journal and the skill packs ────────────────────────
     // Neither reaches a bridge, so nothing here can land in the wrong EDITOR.
     // Both are still per project: the journal file is keyed by absolute project
@@ -333,7 +364,20 @@ export function classifyActionClass(tool, action) {
     const segments = action.toLowerCase().split(/[._]/).filter(Boolean);
     if (segments.some((s) => MUTATE_VERBS.has(s)))
         return { class: "mutate", source: "lexicon" };
-    if (segments.some((s) => READ_VERBS.has(s)))
+    // A read verb only settles the question from the FRONT of the name. Anywhere
+    // else it is a noun as often as a verb, and the direction of that mistake is
+    // the dangerous one: `wire_rvt_sample` was a mutation that classified as a
+    // read on the strength of `sample`, and untargeted dispatch would have let it
+    // edit whichever editor happened to be active. It reached a human review
+    // rather than a release, and was renamed to `add_rvt_sampler`, which is a fix
+    // to one name and not to the rule that produced it.
+    //
+    // So a trailing read verb now decides nothing and falls through to
+    // `unresolved`, which is gated exactly like a mutation and which the drift
+    // guard fails on. The cost is an override line for every genuine read whose
+    // name leads with a subsystem instead of a verb; those are below, each saying
+    // what it reads. The alternative costs a silent wrong-editor write.
+    if (READ_VERBS.has(segments[0] ?? ""))
         return { class: "read", source: "lexicon" };
     // Epic's wrapped engine tools are injected at runtime from a live catalog, so
     // no build-time guard can enumerate them: enrichment can invent whole

package/dist/action-class.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-class.js","sourceRoot":"","sources":["../src/action-class.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"action-class.js","sourceRoot":"","sources":["../src/action-class.ts"],"names":[],"mappings":"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"}

package/dist/tool-counts.json

@@ -31,6 +31,6 @@
   },
   "nativeToolsets": 52,
   "nativeToolActions": 830,
-  "generatedAt": "2026-08-30T02:34:19.266Z",
-  "version": "1.3.1-beta.1"
+  "generatedAt": "2026-08-30T11:29:36.512Z",
+  "version": "1.3.1-beta.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ue-mcp",
-  "version": "1.3.1-beta.1",
+  "version": "1.3.1-beta.2",
   "description": "Unreal Engine MCP server - 24 tools, 1090+ actions for AI-driven editor control",
   "type": "module",
   "main": "dist/index.js",

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AnimationHandlers_IKRetargeterAuthoring.cpp

@@ -655,6 +655,13 @@ TSharedPtr<FJsonValue> FAnimationHandlers::ConfigureIKRetargeter(const TSharedPt
 		PreparedPose = MoveTemp(Pose);
 	}
 
+	// Read before the transaction reassigns them. A rollback payload built after
+	// the write would carry the values this call just installed.
+	const UIKRigDefinition* PreviousSourceRig = Controller->GetIKRig(ERetargetSourceOrTarget::Source);
+	const UIKRigDefinition* PreviousTargetRig = Controller->GetIKRig(ERetargetSourceOrTarget::Target);
+	USkeletalMesh* PreviousSourcePreview = Controller->GetPreviewMesh(ERetargetSourceOrTarget::Source);
+	USkeletalMesh* PreviousTargetPreview = Controller->GetPreviewMesh(ERetargetSourceOrTarget::Target);
+
 	bool bMutationFailed = false;
 	FString MutationError;
 	bool bAddedDefaultOps = false;
@@ -948,6 +955,40 @@ TSharedPtr<FJsonValue> FAnimationHandlers::ConfigureIKRetargeter(const TSharedPt
 		Result->SetObjectField(TEXT("pose"), BuildPoseJson(Controller, Pose.Side, Pose.Name, Pose.bAutoAlignAll));
 	}
 
+	// Only the assignment half of this action is reversible: the rigs and preview
+	// meshes each had a previous asset that a replay of this same action can
+	// point back at. ensureDefaultOps is forced off in that replay so a pure
+	// assignment restore cannot install an op stack of its own.
+	const bool bAssignmentsOnly = !bAddedDefaultOps && !bHasAutoMap
+		&& PreparedMappings.IsEmpty() && !PreparedPose.IsSet();
+	const bool bAssignedAnything = bHasSourceRig || bHasTargetRig || bHasSourcePreview || bHasTargetPreview;
+	const bool bAssignmentsRestorable =
+		(!bHasSourceRig || PreviousSourceRig != nullptr)
+		&& (!bHasTargetRig || PreviousTargetRig != nullptr)
+		&& (!bHasSourcePreview || PreviousSourcePreview != nullptr)
+		&& (!bHasTargetPreview || PreviousTargetPreview != nullptr);
+	if (bAssignmentsOnly && bAssignedAnything && bAssignmentsRestorable)
+	{
+		auto Payload = MakeShared<FJsonObject>();
+		Payload->SetStringField(TEXT("retargeterPath"), Retargeter->GetPathName());
+		Payload->SetBoolField(TEXT("ensureDefaultOps"), false);
+		if (bHasSourceRig) Payload->SetStringField(TEXT("sourceRig"), PreviousSourceRig->GetPathName());
+		if (bHasTargetRig) Payload->SetStringField(TEXT("targetRig"), PreviousTargetRig->GetPathName());
+		if (bHasSourcePreview) Payload->SetStringField(TEXT("sourcePreviewMesh"), PreviousSourcePreview->GetPathName());
+		if (bHasTargetPreview) Payload->SetStringField(TEXT("targetPreviewMesh"), PreviousTargetPreview->GetPathName());
+		MCPSetRollback(Result, TEXT("configure_ik_retargeter"), Payload);
+	}
+	else
+	{
+		TArray<FString> Causes;
+		if (bAddedDefaultOps) Causes.Add(TEXT("a default retarget op stack was installed and no action removes a retarget op"));
+		if (bHasAutoMap || !PreparedMappings.IsEmpty()) Causes.Add(TEXT("chain mappings were rewritten over mappings this call did not capture"));
+		if (PreparedPose.IsSet()) Causes.Add(TEXT("a retarget pose was created, reset or realigned and no action deletes a pose"));
+		if (!bAssignmentsRestorable) Causes.Add(TEXT("a rig or preview mesh this call assigned had none before, and configure_ik_retargeter takes asset paths so it cannot clear one back to unset"));
+		if (Causes.IsEmpty()) Causes.Add(TEXT("this call assigned no rig or preview mesh, so there is no previous asset for a replay to point back at"));
+		MCPSetNoRollback(Result, FString::Join(Causes, TEXT("; ")) + TEXT("."));
+	}
+
 	auto Validation = MakeShared<FJsonObject>();
 	Validation->SetBoolField(TEXT("ran"), bValidationRan);
 	Validation->SetBoolField(TEXT("initialized"), bValidationInitialized);

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AnimationHandlers_IKRigAuthoring.cpp

@@ -620,6 +620,11 @@ TSharedPtr<FJsonValue> FAnimationHandlers::ConfigureIKRig(const TSharedPtr<FJson
 	const int32 BeforeGoalCount = Controller->GetAllGoals().Num();
 	const int32 BeforeSolverCount = Controller->GetNumSolvers();
 	const TSet<FName> BeforeExcluded(Skeleton.ExcludedBones);
+	// Read before the transaction writes over them, because the rollback payload
+	// below has to carry the bones this rig used to name, not the ones it names
+	// after this call succeeds.
+	const FName BeforeRetargetRoot = Controller->GetRetargetRoot();
+	const FName BeforeRootMotionBone = Controller->GetRootMotionBone();
 	UPackage* Package = Rig->GetOutermost();
 	const bool bWasDirty = Package && Package->IsDirty();
 	bool bFailed = false;
@@ -892,6 +897,46 @@ TSharedPtr<FJsonValue> FAnimationHandlers::ConfigureIKRig(const TSharedPtr<FJson
 		Result->SetNumberField(TEXT("fullBodyIKSolverIndex"), SolverIndex);
 		Result->SetBoolField(TEXT("fullBodyIKSolverCreated"), Controller->GetNumSolvers() > BeforeSolverCount);
 	}
+	// Only the settings half of this action is reversible. retargetRoot,
+	// rootMotionBone and bone exclusions each had a previous value that a replay
+	// of this same action can write back. The rest of what it does is creation,
+	// and creation is what no registered action can take back.
+	const bool bSettingsOnly = !bAutoRetarget && Chains.IsEmpty() && !FullBody.bPresent
+		&& (RetargetRoot.IsSet() || RootMotionBone.IsSet() || !Exclusions.IsEmpty());
+	const bool bBonesRestorable =
+		(!RetargetRoot.IsSet() || !BeforeRetargetRoot.IsNone())
+		&& (!RootMotionBone.IsSet() || !BeforeRootMotionBone.IsNone());
+	if (bSettingsOnly && bBonesRestorable)
+	{
+		TSharedPtr<FJsonObject> Payload = MakeShared<FJsonObject>();
+		Payload->SetStringField(TEXT("rigPath"), Rig->GetPathName());
+		if (RetargetRoot.IsSet()) Payload->SetStringField(TEXT("retargetRoot"), BeforeRetargetRoot.ToString());
+		if (RootMotionBone.IsSet()) Payload->SetStringField(TEXT("rootMotionBone"), BeforeRootMotionBone.ToString());
+		if (!Exclusions.IsEmpty())
+		{
+			TArray<TSharedPtr<FJsonValue>> PreviousExclusions;
+			for (const FExclusionRequest& Request : Exclusions)
+			{
+				TSharedPtr<FJsonObject> Entry = MakeShared<FJsonObject>();
+				Entry->SetStringField(TEXT("bone"), Request.Bone.ToString());
+				Entry->SetBoolField(TEXT("excluded"), BeforeExcluded.Contains(Request.Bone));
+				PreviousExclusions.Add(MakeShared<FJsonValueObject>(Entry));
+			}
+			Payload->SetArrayField(TEXT("exclusions"), PreviousExclusions);
+		}
+		MCPSetRollback(Result, TEXT("configure_ik_rig"), Payload);
+	}
+	else
+	{
+		TArray<FString> Causes;
+		if (bAutoRetarget) Causes.Add(TEXT("autoSetup replaced the rig's retarget definition and no action restores the previous one"));
+		if (!Chains.IsEmpty()) Causes.Add(TEXT("retarget chains were upserted and no action removes a chain"));
+		if (FullBody.bPresent) Causes.Add(TEXT("IK goals and a Full Body IK solver were upserted and no action removes a goal or a solver"));
+		if (!bBonesRestorable) Causes.Add(TEXT("retargetRoot or rootMotionBone had no previous bone, and configure_ik_rig takes a bone name so it cannot clear one back to none"));
+		if (Causes.IsEmpty()) Causes.Add(TEXT("this call changed nothing whose previous value a replay could write back"));
+		MCPSetNoRollback(Result, FString::Join(Causes, TEXT("; ")) + TEXT("."));
+	}
+
 	TArray<TSharedPtr<FJsonValue>> WarningValues;
 	for (const FString& Warning : Warnings) WarningValues.Add(MakeShared<FJsonValueString>(Warning));
 	Result->SetArrayField(TEXT("warnings"), WarningValues);

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AnimationHandlers_Validation.cpp

@@ -730,6 +730,34 @@ TSharedPtr<FJsonValue> FAnimationHandlers::AnalyzeAnimation(const TSharedPtr<FJs
 		Result->SetStringField(TEXT("outputDirectory"), OutputDirectory);
 		Result->SetStringField(TEXT("manifestPath"), ManifestPath);
 		Result->SetStringField(TEXT("samplesPath"), SamplesPath);
+
+		// The only effect this call has outside the response, and it happens
+		// only when the caller named a directory. The sequence, its skeleton
+		// and the preview mesh are read and never written: the pose evaluation
+		// runs against a stack-local FCompactPose.
+		//
+		// No inverse is named because deleting a report this same call
+		// regenerates on demand is not a meaningful undo, and the bridge has no
+		// delete-file action to name anyway. The files are safe to leave: the
+		// handler refuses to run when either already exists, so a replay cannot
+		// overwrite a report somebody is reading.
+		MCPSetNoRollback(Result, FString::Printf(TEXT(
+			"Wrote the analysis report '%s' and its samples file '%s', and changed no animation, skeleton or "
+			"asset state. An analysis report is an output artifact rather than project state, and this call "
+			"regenerates it on demand, so no inverse is named. Nothing in the bridge deletes a file outside "
+			"the content browser."), *ManifestPath, *SamplesPath));
+		MCPSetCreated(Result);
+	}
+	else
+	{
+		// The whole call is a read on this path: it opens the sequence, samples
+		// poses into a local buffer and reports. Said out loud because a caller
+		// reading a body with neither a rollback nor a note cannot tell that
+		// from a handler that forgot one.
+		MCPSetNoRollback(Result, TEXT(
+			"Read the sequence and reported on it. No file was written and no asset, skeleton or world state "
+			"changed, so there is nothing to undo."));
+		Result->SetBoolField(TEXT("unchanged"), true);
 	}
 	return MCPResult(Result);
 }

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers.cpp

@@ -2566,6 +2566,15 @@ TSharedPtr<FJsonValue> FAssetHandlers::SaveAsset(const TSharedPtr<FJsonObject>&
 		Result->SetStringField(TEXT("path"), AssetPath);
 		Result->SetBoolField(TEXT("force"), bForce);
 
+		// The dirty flag is the only honest answer to "did this call change
+		// anything", and it has to be read before the save, because afterwards
+		// every package is clean and a save that wrote nothing is
+		// indistinguishable from one that flushed an edit.
+		UObject* PreSaveAsset = MCPLoadAssetObject(AssetPath);
+		UPackage* PreSavePackage = PreSaveAsset ? PreSaveAsset->GetOutermost() : nullptr;
+		const bool bWasDirty = PreSavePackage && PreSavePackage->IsDirty();
+		Result->SetBoolField(TEXT("wasDirty"), bWasDirty);
+
 		bool bSuccess = false;
 		if (bForce)
 		{
@@ -2598,6 +2607,35 @@ TSharedPtr<FJsonValue> FAssetHandlers::SaveAsset(const TSharedPtr<FJsonObject>&
 			}
 		}
 		Result->SetBoolField(TEXT("success"), bSuccess);
+
+		// A clean package had nothing to flush. Without force the save was a
+		// no-op and says so; with force the file was rewritten anyway, which is
+		// a write to disk even though no edit was pending, so it does not claim
+		// to have changed nothing.
+		if (bWasDirty)
+		{
+			MCPSetUpdated(Result);
+		}
+		else if (bForce && bSuccess)
+		{
+			MCPSetUpdated(Result);
+			Result->SetStringField(TEXT("note"),
+				TEXT("The package was not dirty. force=true rewrote the file on disk anyway; without it this call would have written nothing."));
+		}
+		else
+		{
+			Result->SetBoolField(TEXT("updated"), false);
+			Result->SetBoolField(TEXT("unchanged"), true);
+			if (bSuccess)
+			{
+				// Only when the save itself reported success. A failed save
+				// wrote nothing either, and telling that caller the package was
+				// simply clean would hide the failure behind a no-op.
+				Result->SetStringField(TEXT("note"),
+					TEXT("The package was not dirty, so nothing was written. Pass force=true to write it regardless."));
+			}
+		}
+
 		Result->SetBoolField(TEXT("rollbackPossible"), false);
 		Result->SetStringField(TEXT("rollbackNote"),
 			TEXT("A save overwrites the file on disk with what is in memory. The previous file contents are gone and the ")
@@ -2613,10 +2651,36 @@ TSharedPtr<FJsonValue> FAssetHandlers::SaveAsset(const TSharedPtr<FJsonObject>&
 		{
 			return MCPError(TEXT("'force' requires an assetPath - it forces one package to disk. To flush everything, use asset(save_all_dirty), which reports exactly which packages were written."));
 		}
+		// Counted before the sweep for the same reason as the single-asset
+		// branch: SaveDirectory is dirty-only, so with nothing dirty it writes
+		// nothing, and afterwards there is no way to tell that from a sweep
+		// that flushed a hundred packages.
+		TArray<UPackage*> DirtyBefore;
+		FEditorFileUtils::GetDirtyContentPackages(DirtyBefore);
+		FEditorFileUtils::GetDirtyWorldPackages(DirtyBefore);
+		int32 DirtyUnderGame = 0;
+		for (UPackage* Package : DirtyBefore)
+		{
+			if (Package && Package->IsDirty() && Package->GetName().StartsWith(TEXT("/Game/")))
+			{
+				++DirtyUnderGame;
+			}
+		}
+
 		UEditorAssetLibrary::SaveDirectory(TEXT("/Game"));
 		auto Result = MCPSuccess();
 		Result->SetBoolField(TEXT("success"), true);
 		Result->SetStringField(TEXT("message"), TEXT("All modified assets under /Game saved (dirty only). Use save_all_dirty for a per-package report."));
+		Result->SetNumberField(TEXT("dirtyPackagesBefore"), DirtyUnderGame);
+		if (DirtyUnderGame > 0)
+		{
+			MCPSetUpdated(Result);
+		}
+		else
+		{
+			Result->SetBoolField(TEXT("updated"), false);
+			Result->SetBoolField(TEXT("unchanged"), true);
+		}
 		Result->SetBoolField(TEXT("rollbackPossible"), false);
 		Result->SetStringField(TEXT("rollbackNote"),
 			TEXT("A save overwrites the files on disk with what is in memory. The previous file contents are gone and the ")

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers_Redirectors.cpp

@@ -474,5 +474,16 @@ TSharedPtr<FJsonValue> FAssetHandlers::FixupRedirectors(const TSharedPtr<FJsonOb
 	Result->SetNumberField(TEXT("deletedRedirectorCount"), ConfirmedDeleted);
 	Result->SetArrayField(TEXT("redirectors"), RedirectorStatuses);
 	MCPSetUpdated(Result);
+	// Two irreversible writes, neither of which the bridge can undo. The
+	// referencer packages were saved over their previous bytes, and no copy of
+	// those was kept; the redirector packages were deleted from disk once
+	// nothing pointed at them. Restoring the old state needs a call that
+	// recreates an ObjectRedirector at a vacated path and a call that rewinds a
+	// package to its pre-save contents, and neither exists.
+	MCPSetNoRollback(Result, FString::Printf(
+		TEXT("Rewrote and saved %d referencer package(s) over their previous contents and deleted %d redirector ")
+		TEXT("package(s). Undoing this needs an action that recreates an ObjectRedirector at an old path and one that ")
+		TEXT("restores a package's pre-save bytes; neither exists, and no copy of the overwritten packages was kept."),
+		SavedCount, ConfirmedDeleted));
 	return MCPResult(Result);
 }

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers_Sockets.cpp

@@ -318,6 +318,13 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 		{
 			if (SM->Sockets[i] && SM->Sockets[i]->SocketName == FName(*SocketName))
 			{
+				// Read before the removal. After RemoveAt the array no longer
+				// holds the socket, and a transform captured then would put
+				// back a socket at the origin rather than where this one was.
+				const FVector PrevLoc = SM->Sockets[i]->RelativeLocation;
+				const FRotator PrevRot = SM->Sockets[i]->RelativeRotation;
+				const FVector PrevScale = SM->Sockets[i]->RelativeScale;
+
 				SM->Modify();
 				SM->Sockets.RemoveAt(i);
 				SM->MarkPackageDirty();
@@ -327,6 +334,18 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 				Result->SetStringField(TEXT("meshType"), TEXT("StaticMesh"));
 				Result->SetStringField(TEXT("source"), TEXT("mesh"));
 				Result->SetBoolField(TEXT("deleted"), true);
+
+				// add_socket recreates it with the transform it had.
+				// onConflict=update so the restore lands whether or not a
+				// socket of that name exists again by the time it runs.
+				TSharedPtr<FJsonObject> Payload = MakeShared<FJsonObject>();
+				Payload->SetStringField(TEXT("assetPath"), AssetPath);
+				Payload->SetStringField(TEXT("socketName"), SocketName);
+				Payload->SetObjectField(TEXT("relativeLocation"), MCPVec3ToJsonObject(PrevLoc));
+				Payload->SetObjectField(TEXT("relativeRotation"), MCPRotatorToJsonObject(PrevRot));
+				Payload->SetObjectField(TEXT("relativeScale"), MCPVec3ToJsonObject(PrevScale));
+				Payload->SetStringField(TEXT("onConflict"), TEXT("update"));
+				MCPSetRollback(Result, TEXT("add_socket"), Payload);
 				return MCPResult(Result);
 			}
 		}
@@ -346,6 +365,14 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 		{
 			if (Sockets[i] && Sockets[i]->SocketName == FName(*SocketName))
 			{
+				// Captured before the removal, and the bone with it: a socket
+				// restored onto the wrong bone is attached to the wrong part of
+				// the skeleton however right its transform is.
+				const FVector PrevLoc = Sockets[i]->RelativeLocation;
+				const FRotator PrevRot = Sockets[i]->RelativeRotation;
+				const FVector PrevScale = Sockets[i]->RelativeScale;
+				const FString PrevBone = Sockets[i]->BoneName.ToString();
+
 				SKM->Modify();
 				Sockets[i]->Modify();
 				Sockets.RemoveAt(i);
@@ -357,6 +384,16 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 				Result->SetStringField(TEXT("meshType"), TEXT("SkeletalMesh"));
 				Result->SetStringField(TEXT("source"), TEXT("mesh"));
 				Result->SetBoolField(TEXT("deleted"), true);
+
+				TSharedPtr<FJsonObject> Payload = MakeShared<FJsonObject>();
+				Payload->SetStringField(TEXT("assetPath"), AssetPath);
+				Payload->SetStringField(TEXT("socketName"), SocketName);
+				Payload->SetStringField(TEXT("boneName"), PrevBone);
+				Payload->SetObjectField(TEXT("relativeLocation"), MCPVec3ToJsonObject(PrevLoc));
+				Payload->SetObjectField(TEXT("relativeRotation"), MCPRotatorToJsonObject(PrevRot));
+				Payload->SetObjectField(TEXT("relativeScale"), MCPVec3ToJsonObject(PrevScale));
+				Payload->SetStringField(TEXT("onConflict"), TEXT("update"));
+				MCPSetRollback(Result, TEXT("add_socket"), Payload);
 				return MCPResult(Result);
 			}
 		}
@@ -375,6 +412,11 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 		{
 			if (Skel->Sockets[i] && Skel->Sockets[i]->SocketName == FName(*SocketName))
 			{
+				const FVector PrevLoc = Skel->Sockets[i]->RelativeLocation;
+				const FRotator PrevRot = Skel->Sockets[i]->RelativeRotation;
+				const FVector PrevScale = Skel->Sockets[i]->RelativeScale;
+				const FString PrevBone = Skel->Sockets[i]->BoneName.ToString();
+
 				Skel->Modify();
 				Skel->Sockets[i]->Modify();
 				Skel->Sockets.RemoveAt(i);
@@ -385,6 +427,19 @@ TSharedPtr<FJsonValue> FAssetHandlers::RemoveSocket(const TSharedPtr<FJsonObject
 				Result->SetStringField(TEXT("meshType"), TEXT("Skeleton"));
 				Result->SetStringField(TEXT("source"), TEXT("skeleton"));
 				Result->SetBoolField(TEXT("deleted"), true);
+
+				// The same assetPath routes add_socket back to the Skeleton's
+				// own socket array, so the rig-level socket is restored where it
+				// lived rather than on a mesh.
+				TSharedPtr<FJsonObject> Payload = MakeShared<FJsonObject>();
+				Payload->SetStringField(TEXT("assetPath"), AssetPath);
+				Payload->SetStringField(TEXT("socketName"), SocketName);
+				Payload->SetStringField(TEXT("boneName"), PrevBone);
+				Payload->SetObjectField(TEXT("relativeLocation"), MCPVec3ToJsonObject(PrevLoc));
+				Payload->SetObjectField(TEXT("relativeRotation"), MCPRotatorToJsonObject(PrevRot));
+				Payload->SetObjectField(TEXT("relativeScale"), MCPVec3ToJsonObject(PrevScale));
+				Payload->SetStringField(TEXT("onConflict"), TEXT("update"));
+				MCPSetRollback(Result, TEXT("add_socket"), Payload);
 				return MCPResult(Result);
 			}
 		}

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers_Subobject.cpp

@@ -268,6 +268,18 @@ TSharedPtr<FJsonValue> FAssetHandlers::CreateSubobject(const TSharedPtr<FJsonObj
 	OwnerAsset->PostEditChange();
 	OwnerPackage->MarkPackageDirty();
 
+	// The new object lives inside a package that existed before this call, and
+	// nothing in this surface takes one back out: delete_asset would destroy
+	// the owning asset along with everything else in it, which is a larger loss
+	// than the thing being undone. Undoing this needs a remove_subobject that
+	// does not exist, so the property values overwritten on a reused subobject
+	// are not recoverable through the bridge either.
+	MCPSetNoRollback(Result, FString::Printf(
+		TEXT("Created or reconfigured the subobject '%s' inside the existing package '%s'. No action removes a named ")
+		TEXT("subobject from a package or restores its previous property values; delete_asset would destroy the whole ")
+		TEXT("owning asset rather than undo this."),
+		*Name, *OwnerPackage->GetName()));
+
 	// Saving in the same call is what closes the garbage-collection window the
 	// issue is about: after this the subobject is an export on disk, so a later
 	// call resolves it by path even if the in-memory copy is collected.

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers_UV.cpp

@@ -2743,6 +2743,10 @@ TSharedPtr<FJsonValue> FAssetHandlers::ExportUvLayout(const TSharedPtr<FJsonObje
 			TEXT("The %dx%d UV layout for '%s' could not be PNG-encoded."), Size, Size, *Target.AssetPath));
 	}
 	const TArray64<uint8> PngData = PngWrapper->GetCompressed(100);
+	// Asked before the write, because afterwards every export looks like a
+	// first one. A caller rerunning this over a directory it is collecting
+	// pictures in wants to know which of them it just replaced.
+	const bool bOverwroteExistingFile = FPaths::FileExists(OutputPath);
 	if (!FFileHelper::SaveArrayToFile(PngData, *OutputPath))
 	{
 		return MCPError(FString::Printf(
@@ -2764,6 +2768,33 @@ TSharedPtr<FJsonValue> FAssetHandlers::ExportUvLayout(const TSharedPtr<FJsonObje
 		TEXT("White wire = UV triangle edges. Yellow border = the unit square. Grey grid = quarters. Coloured fill ")
 			TEXT("= one hue per UV island. Red fill = two or more triangles on the same texel, which is what breaks ")
 			TEXT("a lightmap bake."));
+
+	// The render always runs and the file is always written, so the honest
+	// answer to "did this change anything" is whether a picture was already
+	// sitting at that path.
+	if (bOverwroteExistingFile)
+	{
+		MCPSetExisted(Result);
+		MCPSetUpdated(Result);
+	}
+	else
+	{
+		MCPSetCreated(Result);
+	}
+
+	// The mesh is untouched: this writes a preview PNG under Saved/ and nothing
+	// else. An export produces an output artifact rather than project state,
+	// and deleting a picture that regenerates on demand from the same call is
+	// not a meaningful undo, so no inverse is named. The six export_* actions
+	// that predate this one emit no rollback for the same reason.
+	const FString OverwriteNote = bOverwroteExistingFile
+		? FString(TEXT(" The picture that was already at that path is gone and no copy was kept."))
+		: FString();
+	MCPSetNoRollback(Result, FString::Printf(
+		TEXT("Wrote the preview PNG '%s' and changed no project state. An export produces an output artifact, and ")
+		TEXT("deleting a file that this same call regenerates on demand is not a meaningful undo, so no inverse is ")
+		TEXT("named.%s"),
+		*OutputPath, *OverwriteNote));
 	return MCPResult(Result);
 }
 

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AudioHandlers_Depth.cpp

@@ -65,10 +65,14 @@
 #include "EdGraph/EdGraphNode.h"
 
 #include "MetasoundBuilderBase.h"
+// MetasoundDocumentBuilderRegistry.h, and never MetasoundFrontendDocumentBuilderRegistry.h:
+// the frontend header ships on 5.8 only. This MetasoundEngine header reaches
+// Metasound::Frontend::IDocumentBuilderRegistry on every supported engine, by
+// including the frontend header on 5.8 and MetasoundDocumentInterface.h, where
+// 5.7 and earlier declare the class, on all of them.
 #include "MetasoundDocumentBuilderRegistry.h"
 #include "MetasoundDocumentInterface.h"
 #include "MetasoundFrontendDocument.h"
-#include "MetasoundFrontendDocumentBuilderRegistry.h"
 #include "MetasoundFrontendLiteral.h"
 #include "MetasoundSource.h"
 
@@ -240,9 +244,18 @@ namespace
 	const FMetasoundFrontendDocument* MSEditDocument(const FMSEditTarget& T)
 	{
 		if (!T.Builder) return nullptr;
-		TScriptInterface<IMetaSoundDocumentInterface> Doc = T.Builder->GetMetaSound();
-		const IMetaSoundDocumentInterface* Iface = Doc.GetInterface();
-		return Iface ? &Iface->GetConstDocument() : nullptr;
+		// Through the builder's own document rather than through the MetaSound
+		// object it is editing. UMetaSoundBuilderBase::GetMetaSound arrived in
+		// 5.8, and the two accessors that would stand in for it on 5.7 are
+		// private in both engines, but GetConstDocumentChecked has been public
+		// on FMetaSoundFrontendDocumentBuilder throughout and is what the
+		// GetMetaSound round trip was reaching for anyway.
+		//
+		// IsValid first, because the Checked form asserts on a builder with no
+		// document while the round trip it replaces returned null for it.
+		const FMetaSoundFrontendDocumentBuilder& Builder = T.Builder->GetConstBuilder();
+		if (!Builder.IsValid()) return nullptr;
+		return &Builder.GetConstDocumentChecked();
 	}
 
 	/**

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AudioHandlers_MetaSound.cpp

@@ -45,9 +45,13 @@
 
 #include "MetasoundBuilderSubsystem.h"
 #include "MetasoundBuilderBase.h"
+// MetasoundDocumentBuilderRegistry.h, and never MetasoundFrontendDocumentBuilderRegistry.h:
+// the frontend header ships on 5.8 only. This MetasoundEngine header reaches
+// Metasound::Frontend::IDocumentBuilderRegistry on every supported engine, by
+// including the frontend header on 5.8 and MetasoundDocumentInterface.h, where
+// 5.7 and earlier declare the class, on all of them.
 #include "MetasoundDocumentBuilderRegistry.h"
 #include "MetasoundDocumentInterface.h"
-#include "MetasoundFrontendDocumentBuilderRegistry.h"
 #include "MetasoundSource.h"
 #include "MetasoundFrontendLiteral.h"
 #include "MetasoundFrontendDocument.h"

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AudioHandlers_MetaSoundRead.cpp

@@ -39,9 +39,14 @@
 
 #include "MetasoundBuilderSubsystem.h"
 #include "MetasoundBuilderBase.h"
+// MetasoundDocumentBuilderRegistry.h, and never MetasoundFrontendDocumentBuilderRegistry.h:
+// the frontend header ships on 5.8 only. This MetasoundEngine header reaches
+// Metasound::Frontend::IDocumentBuilderRegistry on every supported engine, by
+// including the frontend header on 5.8 and MetasoundDocumentInterface.h, where
+// 5.7 and earlier declare the class, on all of them.
+#include "MetasoundDocumentBuilderRegistry.h"
 #include "MetasoundDocumentInterface.h"
 #include "MetasoundFrontendDocument.h"
-#include "MetasoundFrontendDocumentBuilderRegistry.h"
 #include "MetasoundFrontendLiteral.h"
 #include "MetasoundSource.h"