ue-mcp 1.0.69 → 1.0.71

package/README.md

@@ -1,6 +1,6 @@
 # UE-MCP
 
-**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->542+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
+**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->547+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
 
 ```mermaid
 flowchart LR
@@ -57,7 +57,7 @@ If you prefer to configure manually, add to your MCP client config:
 
 - [Getting Started](https://db-lyon.github.io/ue-mcp/getting-started/) — Installation, configuration, first run
 - [Architecture](https://db-lyon.github.io/ue-mcp/architecture/) — How the pieces fit together
-- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->542+<!-- /count --> actions
+- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->547+<!-- /count --> actions
 - [Flows](https://db-lyon.github.io/ue-mcp/flows/) - YAML flow engine, custom tasks, rollback, hooks
 - [Configuration](https://db-lyon.github.io/ue-mcp/configuration/) — `.ue-mcp.json` and MCP client config
 - [Neon Shrine Demo](https://db-lyon.github.io/ue-mcp/neon-shrine-demo/) — Interactive guided demo

package/dist/tool-counts.json

@@ -1,7 +1,7 @@
 {
   "tools": 21,
-  "actions": 542,
-  "bridgeActions": 514,
+  "actions": 547,
+  "bridgeActions": 519,
   "localActions": 28,
   "perTool": {
     "project": 25,
@@ -19,13 +19,13 @@
     "editor": 54,
     "reflection": 8,
     "gameplay": 53,
-    "gas": 9,
+    "gas": 14,
     "networking": 11,
     "demo": 3,
     "feedback": 1,
     "statetree": 35,
     "plugins": 2
   },
-  "generatedAt": "2026-05-29T20:17:18.759Z",
-  "version": "1.0.69"
+  "generatedAt": "2026-05-29T20:48:42.832Z",
+  "version": "1.0.71"
 }

package/dist/tools/gas.js

@@ -10,6 +10,11 @@ export const gasTool = categoryTool("gas", "Gameplay Ability System: abilities,
     set_effect_modifier: bp("Add modifier. Params: effectPath, attribute, operation?, magnitude?", "set_effect_modifier"),
     create_cue: bp("Create GameplayCue. Params: name, packagePath?, cueType?", "create_gameplay_cue"),
     get_info: bp("Inspect GAS setup. Params: blueprintPath", "get_gas_info"),
+    set_asc_defaults: bp("Wire an AttributeSet onto a Blueprint's ASC component (DefaultStartingData) so attributes exist at runtime. Params: blueprintPath, attributeSet (content path or class name), componentName?, initDataTable? (starting values). Run add_ability_system_component first.", "set_asc_defaults"),
+    apply_effect: bp("Apply a GameplayEffect to a live actor's ASC (agnostic stat/damage stimulus - uses the game's own effect). Params: actorLabel, effectClass (content path or class name), level?, setByCaller? ({tag-or-name: magnitude}), world? (auto|pie|editor, default auto)", "apply_effect"),
+    set_attribute: bp("Set a gameplay attribute's base value on a live actor's ASC (recalculates CurrentValue through the aggregator). Params: actorLabel, attribute (Health | SetName.Health), value, world?", "set_attribute"),
+    get_attribute: bp("Read gameplay attribute base + current values on a live actor's ASC. Omit attribute to list all. Params: actorLabel, attribute?, world?", "get_attribute"),
+    init_asc: bp("Initialize a live actor's ASC (InitAbilityActorInfo) and optionally instantiate an AttributeSet so attributes are live - the runtime setup step for testing a bridge-authored GAS actor. Params: actorLabel, attributeSet? (content path or class name), world?", "init_asc"),
 }, undefined, {
     blueprintPath: z.string().optional(),
     name: z.string().optional(),
@@ -31,5 +36,14 @@ export const gasTool = categoryTool("gas", "Gameplay Ability System: abilities,
     magnitude: z.number().optional(),
     durationPolicy: z.string().optional(),
     cueType: z.string().optional(),
+    // Runtime GAS control (apply_effect / set_attribute / get_attribute)
+    actorLabel: z.string().optional().describe("Live actor label/name for runtime GAS actions"),
+    effectClass: z.string().optional().describe("apply_effect: GameplayEffect content path or class name"),
+    level: z.number().optional().describe("apply_effect: effect level (default 1)"),
+    setByCaller: z.record(z.number()).optional().describe("apply_effect: SetByCaller magnitudes keyed by gameplay tag or name"),
+    value: z.number().optional().describe("set_attribute: new base value"),
+    world: z.string().optional().describe("Runtime world scope: auto (default) | pie | editor"),
+    attributeSet: z.string().optional().describe("set_asc_defaults / init_asc: AttributeSet content path or class name"),
+    initDataTable: z.string().optional().describe("set_asc_defaults: optional DataTable of starting attribute values"),
 });
 //# sourceMappingURL=gas.js.map

package/dist/tools/gas.js.map

@@ -1 +1 @@
-{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/tools/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,EAAE,EAAgB,MAAM,aAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,OAAO,GAAY,YAAY,CAC1C,KAAK,EACL,oEAAoE,EACpE;IACE,OAAO,EAAc,EAAE,CAAC,mEAAmE,EAAE,8BAA8B,CAAC;IAC5H,oBAAoB,EAAE,EAAE,CAAC,oDAAoD,EAAE,sBAAsB,CAAC;IACtG,aAAa,EAAQ,EAAE,CAAC,8EAA8E,EAAE,eAAe,CAAC;IACxH,cAAc,EAAO,EAAE,CAAC,qEAAqE,EAAE,yBAAyB,CAAC;IACzH,gBAAgB,EAAK,EAAE,CAAC,0IAA0I,EAAE,kBAAkB,CAAC;IACvL,aAAa,EAAQ,EAAE,CAAC,uEAAuE,EAAE,wBAAwB,CAAC;IAC1H,mBAAmB,EAAE,EAAE,CAAC,qEAAqE,EAAE,qBAAqB,CAAC;IACrH,UAAU,EAAW,EAAE,CAAC,0DAA0D,EAAE,qBAAqB,CAAC;IAC1G,QAAQ,EAAa,EAAE,CAAC,0CAA0C,EAAE,cAAc,CAAC;CACpF,EACD,SAAS,EACT;IACE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,yBAAyB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,wBAAwB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxD,wBAAwB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxD,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CACF,CAAC"}
+{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/tools/gas.ts"],"names":[],"mappings":"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"}

package/dist/ue-mcp.default.yml

@@ -2927,6 +2927,36 @@ tasks:
     description: "Inspect GAS setup. Params: blueprintPath"
     options:
       method: get_gas_info
+  gas.set_asc_defaults:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Wire an AttributeSet onto a Blueprint's ASC component (DefaultStartingData) so attributes exist at runtime. Params: blueprintPath, attributeSet (content path or class name), componentName?, initDataTable? (starting values). Run add_ability_system_component first."
+    options:
+      method: set_asc_defaults
+  gas.apply_effect:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Apply a GameplayEffect to a live actor's ASC (agnostic stat/damage stimulus - uses the game's own effect). Params: actorLabel, effectClass (content path or class name), level?, setByCaller? ({tag-or-name: magnitude}), world? (auto|pie|editor, default auto)"
+    options:
+      method: apply_effect
+  gas.set_attribute:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Set a gameplay attribute's base value on a live actor's ASC (recalculates CurrentValue through the aggregator). Params: actorLabel, attribute (Health | SetName.Health), value, world?"
+    options:
+      method: set_attribute
+  gas.get_attribute:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Read gameplay attribute base + current values on a live actor's ASC. Omit attribute to list all. Params: actorLabel, attribute?, world?"
+    options:
+      method: get_attribute
+  gas.init_asc:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Initialize a live actor's ASC (InitAbilityActorInfo) and optionally instantiate an AttributeSet so attributes are live - the runtime setup step for testing a bridge-authored GAS actor. Params: actorLabel, attributeSet? (content path or class name), world?"
+    options:
+      method: init_asc
 
   # ── networking ──
   networking.set_replicates:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ue-mcp",
-  "version": "1.0.69",
-  "description": "Unreal Engine MCP server - 21 tools, 542+ actions for AI-driven editor control",
+  "version": "1.0.71",
+  "description": "Unreal Engine MCP server - 21 tools, 547+ actions for AI-driven editor control",
   "type": "module",
   "main": "dist/index.js",
   "exports": {

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

@@ -21,6 +21,9 @@
 #include "Engine/SimpleConstructionScript.h"
 #include "Engine/SCS_Node.h"
 #include "EdGraphSchema_K2.h"
+#include "AbilitySystemComponent.h"
+#include "AttributeSet.h"
+#include "Engine/DataTable.h"
 
 void FGasHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 {
@@ -33,6 +36,11 @@ void FGasHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 	Registry.RegisterHandler(TEXT("add_attribute"), &AddAttribute);
 	Registry.RegisterHandler(TEXT("set_ability_tags"), &SetAbilityTags);
 	Registry.RegisterHandler(TEXT("set_effect_modifier"), &SetEffectModifier);
+	Registry.RegisterHandler(TEXT("set_asc_defaults"), &SetAscDefaults);
+	Registry.RegisterHandler(TEXT("apply_effect"), &ApplyEffect);
+	Registry.RegisterHandler(TEXT("set_attribute"), &SetAttribute);
+	Registry.RegisterHandler(TEXT("get_attribute"), &GetAttribute);
+	Registry.RegisterHandler(TEXT("init_asc"), &InitAsc);
 }
 
 TSharedPtr<FJsonValue> FGasHandlers::CreateGasBlueprint(
@@ -373,3 +381,109 @@ TSharedPtr<FJsonValue> FGasHandlers::SetEffectModifier(const TSharedPtr<FJsonObj
 	Result->SetStringField(TEXT("note"), TEXT("GameplayEffect modifier configuration set. Use execute_python for full GE modifier array manipulation."));
 	return MCPResult(Result);
 }
+
+TSharedPtr<FJsonValue> FGasHandlers::SetAscDefaults(const TSharedPtr<FJsonObject>& Params)
+{
+	FString BPPath;
+	if (auto Err = RequireString(Params, TEXT("blueprintPath"), BPPath)) return Err;
+
+	FString AttrSetSpec;
+	if (auto Err = RequireStringAlt(Params, TEXT("attributeSet"), TEXT("attributeSetPath"), AttrSetSpec)) return Err;
+
+	UBlueprint* BP = Cast<UBlueprint>(UEditorAssetLibrary::LoadAsset(BPPath));
+	if (!BP) return MCPError(FString::Printf(TEXT("Blueprint not found: %s"), *BPPath));
+
+	UClass* ASCClass = FindObject<UClass>(nullptr, TEXT("/Script/GameplayAbilities.AbilitySystemComponent"));
+	if (!ASCClass) return MCPError(TEXT("AbilitySystemComponent not found. Enable GameplayAbilities plugin."));
+
+	// Resolve the AttributeSet class from a content path (BP generated class) or
+	// a native short name.
+	UClass* AttrSetClass = nullptr;
+	{
+		UClass* AttrBase = UAttributeSet::StaticClass();
+		auto Ok = [AttrBase](UClass* C) { return C && C->IsChildOf(AttrBase); };
+		if (AttrSetSpec.Contains(TEXT("/")))
+		{
+			if (UClass* C = LoadObject<UClass>(nullptr, *AttrSetSpec); Ok(C)) AttrSetClass = C;
+			if (!AttrSetClass)
+			{
+				FString AssetName;
+				AttrSetSpec.Split(TEXT("/"), nullptr, &AssetName, ESearchCase::CaseSensitive, ESearchDir::FromEnd);
+				if (UClass* C = LoadObject<UClass>(nullptr, *(AttrSetSpec + TEXT(".") + AssetName + TEXT("_C"))); Ok(C)) AttrSetClass = C;
+			}
+			if (!AttrSetClass)
+			{
+				if (UBlueprint* SetBP = Cast<UBlueprint>(UEditorAssetLibrary::LoadAsset(AttrSetSpec)))
+				{
+					if (Ok(SetBP->GeneratedClass)) AttrSetClass = SetBP->GeneratedClass;
+				}
+			}
+		}
+		else if (UClass* C = FindClassByShortName(AttrSetSpec); Ok(C))
+		{
+			AttrSetClass = C;
+		}
+	}
+	if (!AttrSetClass) return MCPError(FString::Printf(TEXT("AttributeSet class not found: %s"), *AttrSetSpec));
+
+	// Find the ASC component template on the blueprint's construction script.
+	const FString CompName = OptionalString(Params, TEXT("componentName"));
+	UAbilitySystemComponent* ASCTemplate = nullptr;
+	FString ResolvedComp;
+	if (BP->SimpleConstructionScript)
+	{
+		for (USCS_Node* N : BP->SimpleConstructionScript->GetAllNodes())
+		{
+			if (!N || !N->ComponentTemplate || !N->ComponentTemplate->IsA(ASCClass)) continue;
+			if (!CompName.IsEmpty() && N->GetVariableName() != FName(*CompName)) continue;
+			ASCTemplate = Cast<UAbilitySystemComponent>(N->ComponentTemplate);
+			ResolvedComp = N->GetVariableName().ToString();
+			break;
+		}
+	}
+	if (!ASCTemplate)
+	{
+		return MCPError(TEXT("No AbilitySystemComponent on the blueprint - run add_ability_system_component first"));
+	}
+
+	// Optional init DataTable (production path: starting values at ASC init).
+	UDataTable* InitTable = nullptr;
+	const FString TablePath = OptionalString(Params, TEXT("initDataTable"));
+	if (!TablePath.IsEmpty())
+	{
+		InitTable = LoadObject<UDataTable>(nullptr, *TablePath);
+		if (!InitTable) return MCPError(FString::Printf(TEXT("initDataTable not found: %s"), *TablePath));
+	}
+
+	// Idempotency: already wired for this attribute set?
+	for (const FAttributeDefaults& D : ASCTemplate->DefaultStartingData)
+	{
+		if (D.Attributes == AttrSetClass)
+		{
+			auto Existed = MCPSuccess();
+			MCPSetExisted(Existed);
+			Existed->SetStringField(TEXT("blueprintPath"), BPPath);
+			Existed->SetStringField(TEXT("component"), ResolvedComp);
+			Existed->SetStringField(TEXT("attributeSet"), AttrSetClass->GetName());
+			return MCPResult(Existed);
+		}
+	}
+
+	FAttributeDefaults Def;
+	Def.Attributes = AttrSetClass;
+	Def.DefaultStartingTable = InitTable;
+	ASCTemplate->DefaultStartingData.Add(Def);
+
+	FKismetEditorUtilities::CompileBlueprint(BP);
+	SaveAssetPackage(BP);
+
+	auto Result = MCPSuccess();
+	MCPSetCreated(Result);
+	Result->SetStringField(TEXT("blueprintPath"), BPPath);
+	Result->SetStringField(TEXT("component"), ResolvedComp);
+	Result->SetStringField(TEXT("attributeSet"), AttrSetClass->GetName());
+	if (InitTable) Result->SetStringField(TEXT("initDataTable"), InitTable->GetPathName());
+	Result->SetStringField(TEXT("note"),
+		TEXT("Attribute set wired to the ASC's DefaultStartingData. If attributes aren't live at runtime, call gas(action=\"init_asc\", attributeSet=...) after PIE starts."));
+	return MCPResult(Result);
+}

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/GasHandlers.h

@@ -32,4 +32,17 @@ private:
 	static TSharedPtr<FJsonValue> AddAttribute(const TSharedPtr<FJsonObject>& Params);
 	static TSharedPtr<FJsonValue> SetAbilityTags(const TSharedPtr<FJsonObject>& Params);
 	static TSharedPtr<FJsonValue> SetEffectModifier(const TSharedPtr<FJsonObject>& Params);
+
+	// Wire an AttributeSet (with optional init DataTable) onto a Blueprint's ASC
+	// component template via DefaultStartingData. Authoring; in GasHandlers.cpp.
+	static TSharedPtr<FJsonValue> SetAscDefaults(const TSharedPtr<FJsonObject>& Params);
+
+	// Runtime GAS control (operates on a live actor's AbilitySystemComponent,
+	// PIE by default). Implemented in GasHandlers_Runtime.cpp.
+	static TSharedPtr<FJsonValue> ApplyEffect(const TSharedPtr<FJsonObject>& Params);
+	static TSharedPtr<FJsonValue> SetAttribute(const TSharedPtr<FJsonObject>& Params);
+	static TSharedPtr<FJsonValue> GetAttribute(const TSharedPtr<FJsonObject>& Params);
+	// InitAbilityActorInfo + optionally GetOrCreateAttributeSubobject on a live
+	// actor, so a bridge-authored GAS actor has live attributes to test against.
+	static TSharedPtr<FJsonValue> InitAsc(const TSharedPtr<FJsonObject>& Params);
 };

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

@@ -0,0 +1,360 @@
+// Runtime GAS control: apply a GameplayEffect, and get/set attributes on a
+// live actor's AbilitySystemComponent. These are the agnostic "affect a stat"
+// test stimuli - they drive the game's OWN effects and attributes rather than
+// assuming a damage pipeline, so they work for any GAS game. Non-GAS games set
+// reflection-exposed stats via level.set_actor_property or call their own
+// functions via editor.invoke_function instead.
+
+#include "GasHandlers.h"
+#include "HandlerUtils.h"
+#include "Dom/JsonObject.h"
+#include "Dom/JsonValue.h"
+#include "GameFramework/Actor.h"
+#include "AbilitySystemComponent.h"
+#include "AbilitySystemBlueprintLibrary.h"
+#include "AttributeSet.h"
+#include "GameplayEffect.h"
+#include "GameplayEffectTypes.h"
+#include "GameplayTagContainer.h"
+
+namespace
+{
+	// Resolve the world for this call. Defaults to "auto" (prefer PIE), since
+	// runtime GAS control is almost always exercised during Play-In-Editor.
+	UWorld* ResolveRuntimeWorld(const TSharedPtr<FJsonObject>& Params)
+	{
+		return ResolveWorldScope(OptionalString(Params, TEXT("world"), TEXT("auto")));
+	}
+
+	// Find the actor (by label or name) in the resolved world and return its
+	// AbilitySystemComponent. On any failure writes a structured error to
+	// OutError and returns nullptr.
+	UAbilitySystemComponent* ResolveASC(
+		const TSharedPtr<FJsonObject>& Params,
+		AActor*& OutActor,
+		TSharedPtr<FJsonValue>& OutError)
+	{
+		FString ActorLabel;
+		if (auto Err = RequireString(Params, TEXT("actorLabel"), ActorLabel))
+		{
+			OutError = Err;
+			return nullptr;
+		}
+
+		UWorld* World = ResolveRuntimeWorld(Params);
+		if (!World)
+		{
+			OutError = MCPError(TEXT("No world available. For PIE actors, start Play-In-Editor first."));
+			return nullptr;
+		}
+
+		AActor* Actor = FindActorByLabelOrName(World, ActorLabel);
+		if (!Actor)
+		{
+			OutError = MCPError(FString::Printf(TEXT("Actor not found: %s"), *ActorLabel));
+			return nullptr;
+		}
+		OutActor = Actor;
+
+		UAbilitySystemComponent* ASC =
+			UAbilitySystemBlueprintLibrary::GetAbilitySystemComponent(Actor);
+		if (!ASC)
+		{
+			OutError = MCPError(FString::Printf(
+				TEXT("Actor '%s' has no AbilitySystemComponent (not a GAS actor)"), *ActorLabel));
+			return nullptr;
+		}
+		return ASC;
+	}
+
+	// Resolve a FGameplayAttribute by name against the ASC's spawned attribute
+	// sets. Accepts a bare property name ("Health") or qualified forms
+	// ("HealthSet.Health" / "HealthSet:Health"). Returns an invalid attribute
+	// on miss; writes the matched set name to OutSetName on hit.
+	FGameplayAttribute FindAttributeByName(
+		UAbilitySystemComponent* ASC,
+		const FString& Name,
+		FString& OutSetName)
+	{
+		for (const UAttributeSet* Set : ASC->GetSpawnedAttributes())
+		{
+			if (!Set) continue;
+			UClass* SetClass = Set->GetClass();
+			const FString SetName = SetClass->GetName();
+			for (TFieldIterator<FProperty> It(SetClass); It; ++It)
+			{
+				FStructProperty* SProp = CastField<FStructProperty>(*It);
+				if (!SProp || SProp->Struct != FGameplayAttributeData::StaticStruct()) continue;
+				const FString PropName = SProp->GetName();
+				if (PropName == Name
+					|| (SetName + TEXT(".") + PropName) == Name
+					|| (SetName + TEXT(":") + PropName) == Name)
+				{
+					OutSetName = SetName;
+					return FGameplayAttribute(SProp);
+				}
+			}
+		}
+		return FGameplayAttribute();
+	}
+
+	// Append one attribute's name/base/current to a JSON object.
+	void WriteAttributeRow(
+		TSharedPtr<FJsonObject> Obj,
+		UAbilitySystemComponent* ASC,
+		const FGameplayAttribute& Attr)
+	{
+		Obj->SetStringField(TEXT("attribute"), Attr.GetName());
+		Obj->SetNumberField(TEXT("baseValue"), ASC->GetNumericAttributeBase(Attr));
+		Obj->SetNumberField(TEXT("currentValue"), ASC->GetNumericAttribute(Attr));
+	}
+
+	// Resolve a UClass deriving from Base from a content path or short class name.
+	// Handles native classes, Blueprint generated classes (path + "_C"), and a
+	// Blueprint-asset fallback. Returns nullptr unless the result is a Base subclass.
+	UClass* ResolveClassDeriving(const FString& Spec, UClass* Base)
+	{
+		auto Ok = [Base](UClass* C) { return C && Base && C->IsChildOf(Base); };
+
+		if (Spec.Contains(TEXT("/")))
+		{
+			if (UClass* C = LoadObject<UClass>(nullptr, *Spec); Ok(C)) return C;
+			FString AssetName;
+			Spec.Split(TEXT("/"), nullptr, &AssetName, ESearchCase::CaseSensitive, ESearchDir::FromEnd);
+			const FString ClassPath = Spec + TEXT(".") + AssetName + TEXT("_C");
+			if (UClass* C = LoadObject<UClass>(nullptr, *ClassPath); Ok(C)) return C;
+			if (UBlueprint* BP = LoadAssetByPath<UBlueprint>(Spec))
+			{
+				if (Ok(BP->GeneratedClass)) return BP->GeneratedClass;
+			}
+			return nullptr;
+		}
+
+		UClass* C = FindClassByShortName(Spec);
+		return Ok(C) ? C : nullptr;
+	}
+}
+
+TSharedPtr<FJsonValue> FGasHandlers::ApplyEffect(const TSharedPtr<FJsonObject>& Params)
+{
+	MCP_CHECK_GAME_THREAD();
+
+	FString EffectSpec;
+	if (auto Err = RequireStringAlt(Params, TEXT("effectClass"), TEXT("effectPath"), EffectSpec)) return Err;
+
+	AActor* Actor = nullptr;
+	TSharedPtr<FJsonValue> Err;
+	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
+	if (!ASC) return Err;
+
+	UClass* EffectClass = ResolveClassDeriving(EffectSpec, UGameplayEffect::StaticClass());
+	if (!EffectClass)
+	{
+		return MCPError(FString::Printf(
+			TEXT("GameplayEffect class not found: %s (pass a content path or class name)"), *EffectSpec));
+	}
+
+	const float Level = static_cast<float>(OptionalNumber(Params, TEXT("level"), 1.0));
+
+	FGameplayEffectContextHandle Context = ASC->MakeEffectContext();
+	Context.AddInstigator(Actor, Actor);
+	FGameplayEffectSpecHandle SpecHandle = ASC->MakeOutgoingSpec(EffectClass, Level, Context);
+	if (!SpecHandle.IsValid() || !SpecHandle.Data.IsValid())
+	{
+		return MCPError(TEXT("Failed to build a GameplayEffectSpec for the effect"));
+	}
+
+	// SetByCaller magnitudes: { "<tag-or-name>": <number> }. Prefer a gameplay
+	// tag when the key resolves to one; otherwise use the FName overload.
+	const TSharedPtr<FJsonObject>* SetByCaller = nullptr;
+	TArray<FString> AppliedKeys;
+	if (Params->TryGetObjectField(TEXT("setByCaller"), SetByCaller) && SetByCaller && (*SetByCaller).IsValid())
+	{
+		for (const auto& KV : (*SetByCaller)->Values)
+		{
+			double Mag = 0.0;
+			if (!KV.Value.IsValid() || !KV.Value->TryGetNumber(Mag)) continue;
+			const FGameplayTag Tag = FGameplayTag::RequestGameplayTag(FName(*KV.Key), /*ErrorIfNotFound*/ false);
+			if (Tag.IsValid())
+			{
+				SpecHandle.Data->SetSetByCallerMagnitude(Tag, static_cast<float>(Mag));
+			}
+			else
+			{
+				SpecHandle.Data->SetSetByCallerMagnitude(FName(*KV.Key), static_cast<float>(Mag));
+			}
+			AppliedKeys.Add(KV.Key);
+		}
+	}
+
+	const FActiveGameplayEffectHandle Active = ASC->ApplyGameplayEffectSpecToSelf(*SpecHandle.Data);
+
+	auto Result = MCPSuccess();
+	Result->SetStringField(TEXT("actorLabel"), Actor->GetActorLabel());
+	Result->SetStringField(TEXT("effect"), EffectClass->GetPathName());
+	Result->SetNumberField(TEXT("level"), Level);
+	Result->SetBoolField(TEXT("applied"), Active.WasSuccessfullyApplied());
+	// Duration/Infinite effects produce a live handle; instant effects don't.
+	Result->SetBoolField(TEXT("durationActive"), Active.IsValid());
+	if (AppliedKeys.Num() > 0)
+	{
+		TArray<TSharedPtr<FJsonValue>> Keys;
+		for (const FString& K : AppliedKeys) Keys.Add(MakeShared<FJsonValueString>(K));
+		Result->SetArrayField(TEXT("setByCaller"), Keys);
+	}
+	return MCPResult(Result);
+}
+
+TSharedPtr<FJsonValue> FGasHandlers::SetAttribute(const TSharedPtr<FJsonObject>& Params)
+{
+	MCP_CHECK_GAME_THREAD();
+
+	FString AttrName;
+	if (auto Err = RequireString(Params, TEXT("attribute"), AttrName)) return Err;
+
+	double NewValue = 0.0;
+	if (!Params->TryGetNumberField(TEXT("value"), NewValue))
+	{
+		return MCPError(TEXT("Missing required parameter 'value'"));
+	}
+
+	AActor* Actor = nullptr;
+	TSharedPtr<FJsonValue> Err;
+	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
+	if (!ASC) return Err;
+
+	FString SetName;
+	const FGameplayAttribute Attr = FindAttributeByName(ASC, AttrName, SetName);
+	if (!Attr.IsValid())
+	{
+		return MCPError(FString::Printf(
+			TEXT("Attribute '%s' not found on '%s'. Use get_attribute with no 'attribute' to list available ones."),
+			*AttrName, *Actor->GetActorLabel()));
+	}
+
+	const float OldBase = ASC->GetNumericAttributeBase(Attr);
+	// SetNumericAttributeBase recalculates CurrentValue through the aggregator,
+	// so dependent modifiers stay consistent (unlike a raw property write).
+	ASC->SetNumericAttributeBase(Attr, static_cast<float>(NewValue));
+
+	auto Result = MCPSuccess();
+	MCPSetUpdated(Result);
+	Result->SetStringField(TEXT("actorLabel"), Actor->GetActorLabel());
+	Result->SetStringField(TEXT("attributeSet"), SetName);
+	Result->SetStringField(TEXT("attribute"), Attr.GetName());
+	Result->SetNumberField(TEXT("previousBaseValue"), OldBase);
+	Result->SetNumberField(TEXT("baseValue"), ASC->GetNumericAttributeBase(Attr));
+	Result->SetNumberField(TEXT("currentValue"), ASC->GetNumericAttribute(Attr));
+	return MCPResult(Result);
+}
+
+TSharedPtr<FJsonValue> FGasHandlers::GetAttribute(const TSharedPtr<FJsonObject>& Params)
+{
+	MCP_CHECK_GAME_THREAD();
+
+	AActor* Actor = nullptr;
+	TSharedPtr<FJsonValue> Err;
+	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
+	if (!ASC) return Err;
+
+	auto Result = MCPSuccess();
+	Result->SetStringField(TEXT("actorLabel"), Actor->GetActorLabel());
+
+	const FString AttrName = OptionalString(Params, TEXT("attribute"));
+	if (!AttrName.IsEmpty())
+	{
+		FString SetName;
+		const FGameplayAttribute Attr = FindAttributeByName(ASC, AttrName, SetName);
+		if (!Attr.IsValid())
+		{
+			return MCPError(FString::Printf(
+				TEXT("Attribute '%s' not found on '%s'"), *AttrName, *Actor->GetActorLabel()));
+		}
+		Result->SetStringField(TEXT("attributeSet"), SetName);
+		WriteAttributeRow(Result, ASC, Attr);
+		return MCPResult(Result);
+	}
+
+	// No attribute named: enumerate every attribute across all spawned sets.
+	TArray<TSharedPtr<FJsonValue>> Rows;
+	for (const UAttributeSet* Set : ASC->GetSpawnedAttributes())
+	{
+		if (!Set) continue;
+		UClass* SetClass = Set->GetClass();
+		const FString SetName = SetClass->GetName();
+		for (TFieldIterator<FProperty> It(SetClass); It; ++It)
+		{
+			FStructProperty* SProp = CastField<FStructProperty>(*It);
+			if (!SProp || SProp->Struct != FGameplayAttributeData::StaticStruct()) continue;
+			const FGameplayAttribute Attr(SProp);
+			TSharedPtr<FJsonObject> Row = MakeShared<FJsonObject>();
+			Row->SetStringField(TEXT("attributeSet"), SetName);
+			WriteAttributeRow(Row, ASC, Attr);
+			Rows.Add(MakeShared<FJsonValueObject>(Row));
+		}
+	}
+	Result->SetArrayField(TEXT("attributes"), Rows);
+	Result->SetNumberField(TEXT("count"), Rows.Num());
+	return MCPResult(Result);
+}
+
+TSharedPtr<FJsonValue> FGasHandlers::InitAsc(const TSharedPtr<FJsonObject>& Params)
+{
+	MCP_CHECK_GAME_THREAD();
+
+	AActor* Actor = nullptr;
+	TSharedPtr<FJsonValue> Err;
+	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
+	if (!ASC) return Err;
+
+	// Establish owner/avatar so abilities activate and effect contexts target
+	// correctly. Safe to call again; a game's own pawn may also init the ASC.
+	ASC->InitAbilityActorInfo(Actor, Actor);
+
+	// Optionally guarantee an attribute set exists on the ASC. This is what lets
+	// a bridge-authored test actor have live attributes without shipping an init
+	// DataTable: spawn the set (with its default values) and register it if it
+	// isn't already present. GetOrCreateAttributeSubobject is protected, so use
+	// the public GetAttributeSet + AddSpawnedAttribute pair.
+	FString CreatedSet;
+	const FString AttrSetSpec = OptionalString(Params, TEXT("attributeSet"));
+	if (!AttrSetSpec.IsEmpty())
+	{
+		UClass* AttrSetClass = ResolveClassDeriving(AttrSetSpec, UAttributeSet::StaticClass());
+		if (!AttrSetClass)
+		{
+			return MCPError(FString::Printf(
+				TEXT("AttributeSet class not found: %s (pass a content path or class name)"), *AttrSetSpec));
+		}
+		const UAttributeSet* Existing = ASC->GetAttributeSet(AttrSetClass);
+		if (!Existing)
+		{
+			UAttributeSet* NewSet = NewObject<UAttributeSet>(Actor, AttrSetClass);
+			ASC->AddSpawnedAttribute(NewSet);
+			CreatedSet = NewSet->GetClass()->GetName();
+		}
+		else
+		{
+			CreatedSet = Existing->GetClass()->GetName();
+		}
+	}
+
+	// Count attributes now live across all spawned sets.
+	int32 AttrCount = 0;
+	for (const UAttributeSet* Set : ASC->GetSpawnedAttributes())
+	{
+		if (!Set) continue;
+		for (TFieldIterator<FProperty> It(Set->GetClass()); It; ++It)
+		{
+			FStructProperty* SProp = CastField<FStructProperty>(*It);
+			if (SProp && SProp->Struct == FGameplayAttributeData::StaticStruct()) ++AttrCount;
+		}
+	}
+
+	auto Result = MCPSuccess();
+	Result->SetStringField(TEXT("actorLabel"), Actor->GetActorLabel());
+	Result->SetBoolField(TEXT("initialized"), true);
+	if (!CreatedSet.IsEmpty()) Result->SetStringField(TEXT("attributeSet"), CreatedSet);
+	Result->SetNumberField(TEXT("attributeCount"), AttrCount);
+	return MCPResult(Result);
+}