ue-mcp 1.0.69 → 1.0.70

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 -->545+<!-- /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 -->545+<!-- /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": 545,
+  "bridgeActions": 517,
   "localActions": 28,
   "perTool": {
     "project": 25,
@@ -19,13 +19,13 @@
     "editor": 54,
     "reflection": 8,
     "gameplay": 53,
-    "gas": 9,
+    "gas": 12,
     "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:36:26.666Z",
+  "version": "1.0.70"
 }

package/dist/tools/gas.js

@@ -10,6 +10,9 @@ 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"),
+    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"),
 }, undefined, {
     blueprintPath: z.string().optional(),
     name: z.string().optional(),
@@ -31,5 +34,12 @@ 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"),
 });
 //# 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,24 @@ tasks:
     description: "Inspect GAS setup. Params: blueprintPath"
     options:
       method: get_gas_info
+  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
 
   # ── 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.70",
+  "description": "Unreal Engine MCP server - 21 tools, 545+ 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

@@ -33,6 +33,9 @@ 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("apply_effect"), &ApplyEffect);
+	Registry.RegisterHandler(TEXT("set_attribute"), &SetAttribute);
+	Registry.RegisterHandler(TEXT("get_attribute"), &GetAttribute);
 }
 
 TSharedPtr<FJsonValue> FGasHandlers::CreateGasBlueprint(

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

@@ -32,4 +32,10 @@ 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);
+
+	// 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);
 };

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

@@ -0,0 +1,300 @@
+// 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 UGameplayEffect subclass from a content path or short class name.
+	UClass* ResolveEffectClass(const FString& Spec)
+	{
+		auto IsEffect = [](UClass* C) { return C && C->IsChildOf(UGameplayEffect::StaticClass()); };
+
+		if (Spec.Contains(TEXT("/")))
+		{
+			// Direct class load (native or already-_C class path).
+			if (UClass* C = LoadObject<UClass>(nullptr, *Spec); IsEffect(C)) return C;
+			// Blueprint generated class: "/Game/Foo/GE_Bar" -> ".../GE_Bar.GE_Bar_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); IsEffect(C)) return C;
+			// Fall back to loading the Blueprint and taking its generated class.
+			if (UBlueprint* BP = LoadAssetByPath<UBlueprint>(Spec))
+			{
+				if (IsEffect(BP->GeneratedClass)) return BP->GeneratedClass;
+			}
+			return nullptr;
+		}
+
+		UClass* C = FindClassByShortName(Spec);
+		return IsEffect(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 = ResolveEffectClass(EffectSpec);
+	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);
+}