blueprint-extractor-mcp 6.0.3 → 6.0.5

package/README.md

@@ -23,7 +23,7 @@ Blueprint Extractor MCP is a [Model Context Protocol](https://modelcontextprotoc
  AI Assistant         stdio           MCP Server         HTTP :30010        Unreal Editor
  ─────────────  ◄────────────►  ─────────────────  ◄──────────────────►  ─────────────────
   Claude Code                     Node.js process                         Remote Control API
-  Codex                           89 tools                                BlueprintExtractor
+  Codex                           95 tools                                BlueprintExtractor
   ...                             4 resource templates                    plugin
                                   8 prompts
 ```
@@ -35,9 +35,10 @@ Blueprint Extractor MCP is a [Model Context Protocol](https://modelcontextprotoc
 | **Extract** | Read Blueprints, widgets, materials, animations, data assets, state trees, and more |
 | **Author** | Create and modify widgets, materials, Blueprints, input actions, AI assets, data tables |
 | **Build** | Compile project code, trigger Live Coding, restart the editor, sync changes |
+| **PIE** | Start, stop, and relaunch Play-In-Editor sessions from the active editor |
 | **Import** | Bring in textures, meshes, and generic assets with async job polling |
 | **Test** | Run UE automation tests, collect results and artifacts |
-| **Verify** | Capture widget screenshots, compare against references, inspect motion checkpoints |
+| **Verify** | Capture widget previews, editor screenshots, runtime screenshots, compare against references, inspect motion checkpoints |
 
 <br>
 
@@ -68,7 +69,7 @@ Connects to the editor at `127.0.0.1:30010` by default.
 ```bash
 claude mcp add -s user -t stdio blueprint-extractor \
   -e UE_REMOTE_CONTROL_PORT=30010 \
-  -- npx -y blueprint-extractor-mcp@latest
+  -- npx -y blueprint-extractor-mcp@6.0.5
 ```
 
 </td></tr>
@@ -77,7 +78,7 @@ claude mcp add -s user -t stdio blueprint-extractor \
 
 ```bash
 codex mcp add --env UE_REMOTE_CONTROL_PORT=30010 \
-  blueprint-extractor -- npx -y blueprint-extractor-mcp@latest
+  blueprint-extractor -- npx -y blueprint-extractor-mcp@6.0.5
 ```
 
 </td></tr>
@@ -101,8 +102,8 @@ Only **~13 core tools** are visible by default to keep the context window lean.
 | `animation_authoring` | 7 | Anim sequences, montages, blend spaces, widget motion |
 | `data_tables` | 7 | Data assets, data tables, curves, Enhanced Input actions & mappings |
 | `import` | 3 | `import_assets` with texture/mesh options, job polling |
-| `automation_testing` | 4 | `run_automation_tests` + run inspection and artifact retrieval |
-| `verification` | 7 | Widget captures, motion checkpoint bundles, reference comparisons |
+| `automation_testing` | 7 | `run_automation_tests`, run inspection, project automation context, PIE lifecycle control |
+| `verification` | 9 | Widget captures, editor/runtime screenshots, motion checkpoint bundles, reference comparisons |
 
 ### Contract Design
 
@@ -115,6 +116,8 @@ The tool contract is optimized for model reliability:
 - **Explicit-save semantics** &mdash; nothing persists until `save_assets` is called
 - **Next-step hints** guiding the assistant toward the logical follow-up action
 
+See [../docs/CURRENT_STATUS.md](../docs/CURRENT_STATUS.md) for the current validation snapshot, normative docs, and the one-shot stabilization ledger.
+
 <br>
 
 ## Configuration
@@ -130,6 +133,8 @@ The tool contract is optimized for model reliability:
 | `UE_BUILD_PLATFORM` | &mdash; | e.g. `Win64` |
 | `UE_BUILD_CONFIGURATION` | &mdash; | e.g. `Development` |
 
+`get_project_automation_context` surfaces the editor-derived `engineRoot`, `projectFilePath`, `editorTarget`, and `isPlayingInEditor` state that project-control and verification flows use for fallback or guard logic.
+
 <br>
 
 ## Resources & Prompts
@@ -175,7 +180,12 @@ npm test            # unit + stdio integration
 | `npm run test:publish-gate` | Version consistency and publish readiness |
 | `BLUEPRINT_EXTRACTOR_LIVE_E2E=1 npm run test:live` | Full end-to-end against a running editor |
 
-The live suite exercises texture/mesh import via HTTP fixtures, material authoring workflows, Enhanced Input round-trips, and asset persistence.
+The live suite exercises texture/mesh import via HTTP fixtures, material authoring workflows, Enhanced Input round-trips, widget authoring, and project-control round-trips.
+
+The UE runner keeps two explicit lanes:
+
+- headless/default: `BlueprintExtractor` with `-NullRHI`
+- rendered verification: targeted filters with `-NoNullRHI` and optional `-AllowSoftwareRendering`
 
 <br>
 

package/dist/catalogs/example-catalog.js

@@ -4,18 +4,18 @@ export const exampleCatalog = {
         summary: 'Inspect the current widget, apply the smallest structural change that solves the layout problem, compile, visually confirm the rendered result, then save.',
         recommended_flow: [
             'extract_widget_blueprint',
-            'modify_widget_blueprint',
-            'compile_widget_blueprint',
+            'patch_widget',
+            'batch_widget_operations',
+            'compile_widget',
             'capture_widget_preview',
             'save_assets',
         ],
         examples: [
             {
                 title: 'patch_title_text',
-                tool: 'modify_widget_blueprint',
+                tool: 'patch_widget',
                 arguments: {
                     asset_path: '/Game/UI/WBP_Window',
-                    operation: 'patch_widget',
                     widget_path: 'WindowRoot/TitleBar/TitleText',
                     properties: { Text: 'Window' },
                     compile_after: true,
@@ -23,10 +23,9 @@ export const exampleCatalog = {
             },
             {
                 title: 'insert_body_text',
-                tool: 'modify_widget_blueprint',
+                tool: 'batch_widget_operations',
                 arguments: {
                     asset_path: '/Game/UI/WBP_Window',
-                    operation: 'batch',
                     operations: [
                         {
                             operation: 'insert_child',
@@ -49,10 +48,11 @@ export const exampleCatalog = {
             'normalize_ui_design_input',
             'design_menu_from_design_spec',
             'extract_widget_blueprint',
-            'import_textures',
+            'import_assets',
             'create_material_instance',
-            'modify_widget_blueprint',
-            'compile_widget_blueprint',
+            'patch_widget',
+            'batch_widget_operations',
+            'compile_widget',
             'capture_widget_preview',
             'compare_capture_to_reference',
             'save_assets',
@@ -60,10 +60,9 @@ export const exampleCatalog = {
         examples: [
             {
                 title: 'text_image_menu_screen',
-                tool: 'modify_widget_blueprint',
+                tool: 'patch_widget',
                 arguments: {
                     asset_path: '/Game/UI/Screens/WBP_MainMenu',
-                    operation: 'patch_widget',
                     widget_path: 'WindowRoot/TitleBar/TitleText',
                     properties: { Text: 'Campaign' },
                     compile_after: true,
@@ -432,6 +431,64 @@ export const exampleCatalog = {
             },
         ],
     },
+    data_asset_instanced_graph: {
+        summary: 'Use generic DataAsset reflection for asset-owned config data, including inline instanced UObject graphs for UPROPERTY(Instanced) and EditInlineNew values.',
+        recommended_flow: [
+            'create_data_asset',
+            'modify_data_asset',
+            'extract_asset',
+            'save_assets',
+        ],
+        examples: [
+            {
+                title: 'create_inline_object_graph',
+                tool: 'create_data_asset',
+                arguments: {
+                    asset_class_path: '/Script/BlueprintExtractorFixture.BlueprintExtractorFixtureDataAsset',
+                    asset_path: '/Game/Data/DA_MenuConfig',
+                    properties: {
+                        Count: 7,
+                        InlineObject: {
+                            classPath: '/Script/BlueprintExtractorFixture.BlueprintExtractorFixtureInlineObject',
+                            properties: {
+                                Label: 'Root',
+                                Count: 11,
+                                Child: {
+                                    classPath: '/Script/BlueprintExtractorFixture.BlueprintExtractorFixtureInlineObject',
+                                    properties: {
+                                        Label: 'Leaf',
+                                        Count: 12,
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            {
+                title: 'patch_inline_object_graph',
+                tool: 'modify_data_asset',
+                arguments: {
+                    asset_path: '/Game/Data/DA_MenuConfig.DA_MenuConfig',
+                    properties: {
+                        Count: 8,
+                        InlineObject: {
+                            properties: {
+                                Label: 'RootModified',
+                                Count: 13,
+                                Child: {
+                                    properties: {
+                                        Label: 'LeafModified',
+                                        Count: 14,
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        ],
+    },
     window_ui_polish: {
         summary: 'Use the thin sequencing helper when a screen change touches variable flags, class defaults, compile, and optional code sync in one flow, then gate persistence on visual confirmation.',
         recommended_flow: [
@@ -461,6 +518,46 @@ export const exampleCatalog = {
             },
         ],
     },
+    pie_and_screenshots: {
+        summary: 'Use explicit PIE lifecycle controls for live editor sessions, and use the editor/runtime screenshot tools when rendered evidence is needed in the shared verification-artifact format.',
+        recommended_flow: [
+            'get_project_automation_context',
+            'start_pie',
+            'capture_editor_screenshot',
+            'capture_runtime_screenshot',
+            'stop_pie',
+        ],
+        examples: [
+            {
+                title: 'start_play_session',
+                tool: 'start_pie',
+                arguments: {
+                    simulate: false,
+                },
+            },
+            {
+                title: 'capture_editor_viewport',
+                tool: 'capture_editor_screenshot',
+                arguments: {},
+            },
+            {
+                title: 'capture_runtime_frame_from_automation',
+                tool: 'capture_runtime_screenshot',
+                arguments: {
+                    automation_filter: 'BlueprintExtractor.ProjectControl.PIEAndScreenshots',
+                    engine_root: 'C:/Program Files/Epic Games/UE_5.7',
+                    project_path: 'C:/Projects/MyGame/MyGame.uproject',
+                    target: 'MyGameEditor',
+                    null_rhi: false,
+                },
+            },
+            {
+                title: 'stop_play_session',
+                tool: 'stop_pie',
+                arguments: {},
+            },
+        ],
+    },
     project_code: {
         summary: 'Use explicit changed_paths so build-vs-live-coding decisions stay deterministic.',
         recommended_flow: [

package/dist/helpers/package-metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const packageName: string;
+export declare const packageVersion: string;

package/dist/helpers/package-metadata.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+export const packageName = packageJson.name ?? 'blueprint-extractor-mcp';
+export const packageVersion = packageJson.version ?? '0.0.0';

package/dist/helpers/project-resolution.d.ts

@@ -18,5 +18,6 @@ type ResolveProjectInputsDeps = {
 };
 export declare function rememberExternalBuild(result: CompileProjectCodeResult): Record<string, unknown>;
 export declare function getProjectAutomationContext(deps: GetProjectAutomationContextDeps): Promise<ProjectAutomationContext>;
+export declare const HEURISTIC_ENGINE_CANDIDATES: string[];
 export declare function resolveProjectInputs(request: ProjectInputsRequest, deps: ResolveProjectInputsDeps): Promise<ResolvedProjectInputs>;
 export {};

package/dist/helpers/project-resolution.js

@@ -31,7 +31,8 @@ export async function getProjectAutomationContext(deps) {
     return nextContext;
 }
 let cachedHeuristicEngineRoot;
-const HEURISTIC_ENGINE_CANDIDATES = [
+export const HEURISTIC_ENGINE_CANDIDATES = [
+    'C:/Program Files/Epic Games/UE_5.7',
     'C:/Program Files/Epic Games/UE_5.6',
     'C:/Program Files/Epic Games/UE_5.5',
     'C:/Program Files/Epic Games/UE_5.4',

package/dist/helpers/subsystem.js

@@ -62,6 +62,8 @@ function extractFailureMessage(parsed) {
         return parsed.errorMessage;
     if (typeof parsed.error === 'string' && parsed.error.length > 0)
         return parsed.error;
+    if (typeof parsed.errorSummary === 'string' && parsed.errorSummary.length > 0)
+        return parsed.errorSummary;
     if (Array.isArray(parsed.diagnostics) && parsed.diagnostics.length > 0) {
         const messages = parsed.diagnostics
             .filter((d) => typeof d === 'object' && d !== null && typeof d.message === 'string')

package/dist/helpers/tool-help.js

@@ -101,12 +101,29 @@ export function summarizeOutputSchema(schema) {
     return summary;
 }
 export function collectToolExampleFamilies(exampleCatalog, toolName) {
+    const equivalentToolNames = new Set([toolName]);
+    if (toolName === 'modify_widget_blueprint') {
+        [
+            'patch_widget',
+            'patch_widget_class_defaults',
+            'insert_widget_child',
+            'remove_widget',
+            'move_widget',
+            'wrap_widget',
+            'replace_widget_class',
+            'replace_widget_tree',
+            'batch_widget_operations',
+        ].forEach((name) => equivalentToolNames.add(name));
+    }
+    if (toolName === 'compile_widget_blueprint') {
+        equivalentToolNames.add('compile_widget');
+    }
     return Object.entries(exampleCatalog)
         .flatMap(([family, entry]) => {
         const exampleTitles = entry.examples
-            .filter((example) => example.tool === toolName)
+            .filter((example) => equivalentToolNames.has(example.tool))
             .map((example) => example.title);
-        const usedInRecommendedFlow = entry.recommended_flow.includes(toolName);
+        const usedInRecommendedFlow = entry.recommended_flow.some((name) => equivalentToolNames.has(name));
         if (!usedInRecommendedFlow && exampleTitles.length === 0) {
             return [];
         }
@@ -136,6 +153,14 @@ export function collectRelatedResources(toolName) {
         resources.add('blueprint://widget-best-practices');
         resources.add('blueprint://verification-workflows');
     }
+    if (toolName === 'capture_editor_screenshot'
+        || toolName === 'capture_runtime_screenshot'
+        || toolName === 'start_pie'
+        || toolName === 'stop_pie'
+        || toolName === 'relaunch_pie') {
+        resources.add('blueprint://verification-workflows');
+        resources.add('blueprint://project-automation');
+    }
     if (toolName.includes('material')) {
         resources.add('blueprint://material-graph-guidance');
     }
@@ -147,7 +172,10 @@ export function collectRelatedResources(toolName) {
         || toolName === 'trigger_live_coding'
         || toolName === 'restart_editor'
         || toolName === 'wait_for_editor'
-        || toolName === 'sync_project_code') {
+        || toolName === 'sync_project_code'
+        || toolName === 'start_pie'
+        || toolName === 'stop_pie'
+        || toolName === 'relaunch_pie') {
         resources.add('blueprint://project-automation');
     }
     if (toolName.includes('animation')

package/dist/helpers/verification.js

@@ -1,17 +1,36 @@
 import { buildCaptureResourceUri } from './capture.js';
 import { firstDefinedString, isPlainObject, } from './formatting.js';
-function isVerificationSurface(value) {
+function normalizeVerificationSurface(value) {
+    if (value === 'editor_viewport') {
+        return 'editor_tool_viewport';
+    }
+    if (value === 'runtime_viewport') {
+        return 'pie_runtime';
+    }
     return value === 'editor_offscreen'
         || value === 'pie_runtime'
         || value === 'editor_tool_viewport'
         || value === 'external_packaged'
-        || value === 'widget_motion_checkpoint';
+        || value === 'widget_motion_checkpoint'
+        ? value
+        : undefined;
+}
+function isVerificationSurface(value) {
+    return normalizeVerificationSurface(value) !== undefined;
 }
 function inferVerificationSurface(captureType) {
-    if (isVerificationSurface(captureType)) {
-        return captureType;
+    const normalizedSurface = normalizeVerificationSurface(captureType);
+    if (normalizedSurface) {
+        return normalizedSurface;
     }
     switch (captureType) {
+        case 'editor_screenshot':
+            return 'editor_tool_viewport';
+        case 'runtime_screenshot':
+        case 'automation_screenshot':
+        case 'automation_image_artifact':
+        case 'automation_diff':
+            return 'pie_runtime';
         case 'widget_motion_checkpoint':
             return 'widget_motion_checkpoint';
         case 'widget_preview':
@@ -54,6 +73,28 @@ function buildDefaultWorldContext(payload, surface) {
         }
         return context;
     }
+    if (surface === 'editor_tool_viewport') {
+        return {
+            contextType: 'editor_viewport',
+            renderLane: 'viewport',
+            ...(typeof payload.assetPath === 'string' && payload.assetPath.length > 0
+                ? { assetPath: payload.assetPath }
+                : {}),
+            ...(typeof payload.isPlayingInEditor === 'boolean'
+                ? { isPlayingInEditor: payload.isPlayingInEditor }
+                : { isPlayingInEditor: false }),
+        };
+    }
+    if (surface === 'pie_runtime') {
+        return {
+            contextType: 'runtime_viewport',
+            renderLane: 'viewport',
+            ...(typeof payload.assetPath === 'string' && payload.assetPath.length > 0
+                ? { assetPath: payload.assetPath }
+                : {}),
+            isPlayingInEditor: true,
+        };
+    }
     if (surface === 'widget_motion_checkpoint') {
         const context = {
             contextType: 'widget_motion',
@@ -91,6 +132,13 @@ function buildDefaultCameraContext(payload, surface) {
             ...(typeof height === 'number' ? { height } : {}),
         };
     }
+    if (surface === 'editor_tool_viewport' || surface === 'pie_runtime') {
+        return {
+            contextType: surface === 'editor_tool_viewport' ? 'editor_viewport' : 'runtime_viewport',
+            ...(typeof width === 'number' ? { width } : {}),
+            ...(typeof height === 'number' ? { height } : {}),
+        };
+    }
     if (surface === 'widget_motion_checkpoint') {
         return {
             contextType: 'motion_checkpoint',
@@ -127,7 +175,7 @@ function normalizeAutomationVerificationArtifacts(payload) {
         return existing.map((artifact) => {
             const normalized = normalizeVerificationArtifact({
                 ...artifact,
-                surface: isVerificationSurface(artifact.surface) ? artifact.surface : 'pie_runtime',
+                surface: normalizeVerificationSurface(artifact.surface) ?? 'pie_runtime',
                 captureType: typeof artifact.captureType === 'string' && artifact.captureType.length > 0
                     ? artifact.captureType
                     : 'automation_image_artifact',
@@ -198,9 +246,11 @@ export function normalizeVerificationArtifact(payload) {
         : assetPath
             ? [assetPath]
             : [];
-    const surface = isVerificationSurface(basePayload.surface)
-        ? basePayload.surface
-        : inferVerificationSurface(basePayload.captureType);
+    const surface = normalizeVerificationSurface(basePayload.surface)
+        ?? (isVerificationSurface(basePayload.surface)
+            ? basePayload.surface
+            : undefined)
+        ?? inferVerificationSurface(basePayload.captureType);
     const worldContext = buildDefaultWorldContext(basePayload, surface);
     const cameraContext = buildDefaultCameraContext(basePayload, surface);
     return {

package/dist/resources/example-and-capture-resources.js

@@ -260,7 +260,8 @@ export function registerExampleAndCaptureResources({ server, automationControlle
                     'Blueprint Extractor Unsupported Surfaces',
                     '',
                     '- Generic create_data_asset and modify_data_asset reject Enhanced Input asset classes. Use the dedicated InputAction/InputMappingContext tools instead.',
-                    '- modify_material and modify_material_function remain available but are advanced escape hatches, not the primary authoring workflow.',
+                    '- Generic DataAsset reflection does support inline instanced UObject graphs for asset-owned config, but it does not support literal embedded AActor instances.',
+                    '- modify_material remains available as an advanced escape hatch, but the canonical authoring path is create_material plus material_graph_operation for settings, node creation, wiring, and root-property binding.',
                     '- There is still no first-class Substrate graph DSL.',
                     '- CommonUI wrapper widgets are not a backdoor into internal Slate/UButton background or style fields. For CommonButtonBase-family widgets, treat raw UButton background/style properties as unsupported and use extract_commonui_button_style, create_commonui_button_style, modify_commonui_button_style, or apply_commonui_button_style.',
                     '- Dedicated widget animation authoring is supported only for the constrained supported track subset. Unsupported track families and broader arbitrary MovieScene synthesis remain outside the public contract.',
@@ -281,9 +282,9 @@ export function registerExampleAndCaptureResources({ server, automationControlle
                     '2. search_assets and extract the current HUD, transition widgets, and target screen widgets.',
                     '3. Inspect class defaults, BindWidget names, and current activatable-window flow before replacing any widget tree.',
                     '4. Choose a preset layout pattern such as centered_overlay, common_menu_shell, activatable_window, or list_detail.',
-                    '5. Apply the smallest modify_widget_blueprint patch possible. Only use build_widget_tree or replace_tree when broad structure must change.',
+                    '5. Apply the smallest widget operation possible: patch_widget, insert_widget_child, remove_widget, move_widget, wrap_widget, replace_widget_class, or batch_widget_operations. Only use replace_widget_tree when broad structure must change.',
                     '6. If the redesign includes authored motion on the supported track subset, use create_widget_animation or modify_widget_animation instead of trying to encode that work through generic widget patches.',
-                    '7. Compile immediately after structural or animation changes. If compile fails, inspect compile diagnostics and rerun the smallest recovery patch first.',
+                    '7. Compile immediately after structural or animation changes with compile_widget. If compile fails, inspect compile diagnostics and rerun the smallest recovery patch first.',
                     '8. Run capture_widget_preview or capture_widget_motion_checkpoints after the compile result is clean so the rendered result is visually confirmed for each required checkpoint.',
                     '9. If reference images or checkpoint frames exist, run compare_capture_to_reference or compare_motion_capture_bundle for key states before save_assets.',
                     '10. Save after capture or compare succeeds, or report lower-confidence / partial verification explicitly when the visual checkpoint is blocked.',

package/dist/resources/static-doc-resources.js

@@ -38,13 +38,13 @@ export function registerStaticDocResources(server) {
         '- Write responses include: success, operation, assetPath, assetClass, changedObjects, dirtyPackages, diagnostics, and optional validation/compile summaries.',
         '',
         'Current write-capable families:',
-        '- WidgetBlueprint: create_widget_blueprint, build_widget_tree, modify_widget, modify_widget_blueprint, compile_widget_blueprint',
+        '- WidgetBlueprint: create_widget_blueprint, replace_widget_tree, patch_widget, insert_widget_child, remove_widget, move_widget, wrap_widget, replace_widget_class, batch_widget_operations, compile_widget. Deprecated compatibility aliases remain available for modify_widget_blueprint, build_widget_tree, and compile_widget_blueprint.',
         '- CommonUI button style Blueprints: extract_commonui_button_style, create_commonui_button_style, modify_commonui_button_style, apply_commonui_button_style',
-        '- DataAsset: create_data_asset, modify_data_asset',
+        '- DataAsset: create_data_asset, modify_data_asset. Inline instanced UObject graphs are supported for UPROPERTY(Instanced) / EditInlineNew values.',
         '- DataTable: create_data_table, modify_data_table',
         '- Curve: create_curve, modify_curve',
         '- CurveTable: create_curve_table, modify_curve_table',
-        '- Material graph assets: extract_material, create_material, modify_material, extract_material_function, create_material_function, modify_material_function, compile_material_asset',
+        '- Material graph assets: extract_material, create_material, modify_material, compile_material_asset. Use asset_kind="function", "layer", or "layer_blend" for material-family variants.',
         '- MaterialInstance: create_material_instance, modify_material_instance',
         '- UserDefinedStruct: create_user_defined_struct, modify_user_defined_struct',
         '- UserDefinedEnum: create_user_defined_enum, modify_user_defined_enum',
@@ -73,11 +73,11 @@ export function registerStaticDocResources(server) {
         '- Blueprint graphs: operation upsert_function_graphs preserves unrelated graphs; append_function_call_to_sequence patches an existing sequence-style initializer without replacing the whole graph.',
         '',
         'WidgetBlueprint guidance:',
-        '- build_widget_tree is the destructive bootstrap path for whole-tree replacement.',
+        '- replace_widget_tree is the destructive bootstrap path for whole-tree replacement.',
         '- extract_widget_blueprint returns a compact authoring snapshot with widgetPath annotations and additive packagePath/objectPath fields.',
         '- modify_widget supports direct widget_name or widget_path patches for one widget.',
-        '- modify_widget_blueprint is the primary structural API: replace_tree, patch_widget, patch_class_defaults, insert_child, remove_widget, move_widget, wrap_widget, replace_widget_class, batch, or compile.',
-        '- compile_widget_blueprint validates the asset but still does not save it.',
+        '- Prefer operation-specific widget tools such as patch_widget, patch_widget_class_defaults, insert_widget_child, remove_widget, move_widget, wrap_widget, replace_widget_class, and batch_widget_operations.',
+        '- compile_widget validates the asset but still does not save it.',
         '- apply_window_ui_changes is a thin MCP helper that sequences variable-flag updates, class defaults, optional font work, compile, optional save, and optional code sync.',
         '',
         'Explicit deferrals:',
@@ -130,7 +130,7 @@ export function registerStaticDocResources(server) {
         '- Keep payloads small by sending only changed fields, not full extracted objects, unless the tool explicitly expects a full replacement payload.',
         '- Re-extract after mutation when you need confirmation; do not assume UE normalized fields exactly as sent.',
         '- For fidelity-sensitive menu work, normalize text, image, Figma-export, or HTML/CSS inputs into design_spec_json before authoring assets.',
-        '- For multi-step widget work, prefer extract_widget_blueprint -> modify_widget_blueprint -> compile_widget_blueprint -> capture_widget_preview -> save_assets.',
+        '- For multi-step widget work, prefer extract_widget_blueprint -> patch_widget or batch_widget_operations -> compile_widget -> capture_widget_preview -> save_assets.',
         '- For authored widget motion, prefer extract_widget_animation -> create_widget_animation or modify_widget_animation -> capture_widget_motion_checkpoints -> compare_motion_capture_bundle before save_assets.',
         '- When reference frames exist, extend the widget flow to compare_capture_to_reference before save_assets. Without reference frames, capture and report lower-confidence or partial verification explicitly.',
         '- If widget preview capture is blocked, report partial verification explicitly instead of treating compile/save as visual proof.',
@@ -218,12 +218,13 @@ export function registerStaticDocResources(server) {
     registerStaticTextResource(server, 'project-automation-guidance', 'blueprint://project-automation', 'Host/editor project automation guidance for build, Live Coding, restart, and reconnect flows.', [
         'Blueprint Extractor Project Automation',
         '',
-        '- get_project_automation_context returns the editor-derived engine root, project file path, and editor target that project-control tools use as their first fallback.',
+        '- get_project_automation_context returns the editor-derived engine root, project file path, editor target, and isPlayingInEditor state that project-control tools use as their first fallback.',
         '- compile_project_code runs an external UBT build from the MCP host.',
         '- compile_project_code and sync_project_code resolve engine_root, project_path, and target in this order: explicit args -> editor context -> environment.',
         '- trigger_live_coding requests an editor-side Live Coding compile and is only supported on Windows-focused setups. changed_paths remains an accepted compatibility input but the current editor-side trigger ignores it. When Live Coding reports NoChanges or another fallback state, the result includes fallbackRecommended, reason, and the last external build context when available.',
         '- restart_editor requests an editor restart, then waits for Remote Control to disconnect and reconnect. When save_dirty_assets is true, all dirty packages are saved before the restart to prevent modal save dialogs.',
         '- wait_for_editor polls Remote Control once per second and returns a normalized readiness result that callers can use after restart windows or transient disconnects.',
+        '- start_pie, stop_pie, and relaunch_pie are the explicit live-editor PIE lifecycle controls.',
         '- sync_project_code requires explicit changed_paths and chooses Live Coding vs build_and_restart deterministically.',
         '- sync_project_code.restart_first now means shutdown-first: save/checkpoint if requested, ask the editor to close without relaunching, build with the DLL unlocked, then launch the editor from the MCP host and wait for reconnect.',
         '- apply_window_ui_changes can checkpoint after each mutation step without changing the low-level explicit-save contract. Use that when debugging editor ensures or breakpoint-heavy UI iterations.',
@@ -239,8 +240,8 @@ export function registerStaticDocResources(server) {
         'Blueprint Extractor Verification Workflows',
         '',
         'Three verification lanes work together:',
-        '- Semantic verification: use extract_blueprint, extract_widget_blueprint, extract_asset, compile_widget_blueprint, compile_material_asset, and compile/save diagnostics to verify authored data, graph wiring, widget hierarchy, class defaults, and graph layout.',
-        '- Visual verification: use capture_widget_preview and compare_capture_to_reference when structure can compile but the rendered result may still be wrong.',
+        '- Semantic verification: use extract_blueprint, extract_widget_blueprint, extract_asset, compile_widget, compile_material_asset, and compile/save diagnostics to verify authored data, graph wiring, widget hierarchy, class defaults, and graph layout.',
+        '- Visual verification: use capture_widget_preview, capture_editor_screenshot, capture_runtime_screenshot, and compare_capture_to_reference when structure can compile but the rendered result may still be wrong.',
         '- Gameplay/runtime verification: use run_automation_tests for mechanics, behavior, interactions, and scenario validation through Automation Specs or Functional Tests.',
         '',
         'Recommended mapping:',
@@ -287,7 +288,7 @@ export function registerStaticDocResources(server) {
         '1. Normalize raw text, image, PNG/Figma, or HTML/CSS inputs into design_spec_json.',
         '2. Inspect the current widget, HUD, transition widgets, and class defaults before rewriting structure.',
         '3. Author reusable foundation assets first under /Game/UI/Foundation/Materials, /Game/UI/Foundation/MaterialInstances, /Game/UI/Foundation/Styles, and /Game/UI/Foundation/Widgets.',
-        '4. Assemble the menu screen under /Game/UI/Screens with modify_widget_blueprint and related existing tools.',
+        '4. Assemble the menu screen under /Game/UI/Screens with patch_widget, batch_widget_operations, and related widget tools.',
         '5. If motion is part of the spec, author or patch widget timelines with create_widget_animation or modify_widget_animation using the supported track subset.',
         '6. Compile, then capture key visual checkpoints such as open, focused, or pressed.',
         '7. If reference frames exist, compare captures with compare_capture_to_reference or compare_motion_capture_bundle before save_assets.',

package/dist/schemas/tool-inputs.d.ts

@@ -847,17 +847,17 @@ export declare const MeshImportOptionsSchema: z.ZodObject<{
     generate_collision: z.ZodOptional<z.ZodBoolean>;
     skeleton_path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    import_textures?: boolean | undefined;
     mesh_type?: string | undefined;
     import_materials?: boolean | undefined;
+    import_textures?: boolean | undefined;
     import_animations?: boolean | undefined;
     combine_meshes?: boolean | undefined;
     generate_collision?: boolean | undefined;
     skeleton_path?: string | undefined;
 }, {
-    import_textures?: boolean | undefined;
     mesh_type?: string | undefined;
     import_materials?: boolean | undefined;
+    import_textures?: boolean | undefined;
     import_animations?: boolean | undefined;
     combine_meshes?: boolean | undefined;
     generate_collision?: boolean | undefined;
@@ -1053,17 +1053,17 @@ export declare const MeshImportPayloadSchema: z.ZodObject<{
             generate_collision: z.ZodOptional<z.ZodBoolean>;
             skeleton_path: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;
             skeleton_path?: string | undefined;
         }, {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;
@@ -1072,9 +1072,9 @@ export declare const MeshImportPayloadSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         url?: string | undefined;
         options?: {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;
@@ -1091,9 +1091,9 @@ export declare const MeshImportPayloadSchema: z.ZodObject<{
     }, {
         url?: string | undefined;
         options?: {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;
@@ -1112,9 +1112,9 @@ export declare const MeshImportPayloadSchema: z.ZodObject<{
     items: {
         url?: string | undefined;
         options?: {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;
@@ -1133,9 +1133,9 @@ export declare const MeshImportPayloadSchema: z.ZodObject<{
     items: {
         url?: string | undefined;
         options?: {
-            import_textures?: boolean | undefined;
             mesh_type?: string | undefined;
             import_materials?: boolean | undefined;
+            import_textures?: boolean | undefined;
             import_animations?: boolean | undefined;
             combine_meshes?: boolean | undefined;
             generate_collision?: boolean | undefined;

package/dist/server-config.js

@@ -2,13 +2,13 @@ const EDITOR_UNAVAILABLE_MESSAGE_FRAGMENT = 'UE Editor not running or Remote Con
 const SUBSYSTEM_UNAVAILABLE_MESSAGE_FRAGMENT = 'BlueprintExtractor subsystem not found';
 export const EDITOR_POLL_INTERVAL_MS = 1_000;
 export const serverInstructions = [
-    'Blueprint Extractor MCP v5 uses workflow-scoped tool surfaces, snake_case arguments, prompt workflows, and structured JSON results.',
+    'Blueprint Extractor MCP uses a v2 public contract with workflow-scoped tool surfaces, snake_case arguments, prompt workflows, and structured JSON results.',
     // Tool discovery
     'Only ~13 core tools are visible by default. Use activate_workflow_scope to load specialized tool families: widget_authoring (or sub-scopes: widget_authoring_structure, widget_authoring_visual, widget_verification), material_authoring, blueprint_authoring, schema_ai_authoring, animation_authoring, data_tables, import, automation_testing, verification.',
     'Use find_and_extract for search+extract in one call (activate any authoring scope to access it). Use search_assets when you only need to locate assets.',
     'Call get_tool_help before the first use of a complex or polymorphic tool when you need operation-specific payload guidance. This may also auto-activate the relevant workflow scope.',
     // Deferred tool directory (tools available via activate_workflow_scope)
-    'Deferred tool families — widget_authoring_structure: create/replace/patch/insert/remove/move/wrap widgets. widget_authoring_visual: CommonUI styles, widget animations, compile_widget, extraction. widget_verification: captures and comparisons. widget_authoring: activates all three widget sub-scopes. material_authoring: create/modify material, material_graph_operation, material instances. blueprint_authoring: create/modify blueprint members and graphs, trigger_live_coding. schema_ai_authoring: structs, enums, blackboards, behavior trees, state trees. animation_authoring: anim sequences, montages, blend spaces, widget animations. data_tables: data assets, input actions, tables, curves. import: import_assets, job tracking. automation_testing: run/get/list automation tests, project automation context. verification: widget captures and comparisons.',
+    'Deferred tool families — widget_authoring_structure: create/replace/patch/insert/remove/move/wrap widgets. widget_authoring_visual: CommonUI styles, widget animations, compile_widget, extraction. widget_verification: captures and comparisons. widget_authoring: activates all three widget sub-scopes. material_authoring: create/modify material, material_graph_operation, material instances. blueprint_authoring: create/modify blueprint members and graphs, trigger_live_coding. schema_ai_authoring: structs, enums, blackboards, behavior trees, state trees. animation_authoring: anim sequences, montages, blend spaces, widget animations. data_tables: data assets, input actions, tables, curves. import: import_assets, job tracking. automation_testing: run/get/list automation tests, project automation context, and PIE lifecycle control. verification: widget captures, editor screenshots, runtime screenshots, and comparisons.',
     // Extraction
     'All extract_* tools default to compact: true. Pass compact: false for verbose output.',
     // Search
@@ -34,6 +34,7 @@ export const serverInstructions = [
     'Motion support includes dedicated widget animation authoring for render_opacity, render_transform translation/scale/angle, and color_and_opacity tracks. Treat broader arbitrary MovieScene track synthesis as deferred_to_future or unsupported when it exceeds that subset.',
     // Testing
     'Use run_automation_tests for gameplay or runtime verification. If no Automation Spec or Functional Test exists for a mechanic, report verification as partial instead of inferring success from structure alone.',
+    'Use capture_runtime_screenshot when a runtime verification lane already exports screenshot artifacts through automation. Use capture_editor_screenshot for the active editor viewport when a rendered editor reference is needed.',
     // Results format
     'Successful tool results use structuredContent as the canonical JSON payload. Recoverable execution failures return isError=true with code, message, recoverable, and next_steps.',
 ].join('\n');
@@ -46,6 +47,7 @@ export const taskAwareTools = new Set([
     'get_import_job',
     'list_import_jobs',
     'run_automation_tests',
+    'capture_runtime_screenshot',
     'get_automation_test_run',
     'list_automation_test_runs',
 ]);
@@ -142,12 +144,17 @@ export const TOOL_MODE_ANNOTATIONS = new Map([
     ['trigger_live_coding', 'editor_only'],
     ['sync_project_code', 'editor_only'],
     ['wait_for_editor', 'editor_only'],
+    ['start_pie', 'editor_only'],
+    ['stop_pie', 'editor_only'],
+    ['relaunch_pie', 'editor_only'],
     // ── Import (editor_only) ──
     ['import_assets', 'editor_only'],
     // ── Automation tests (editor_only) ──
     ['run_automation_tests', 'editor_only'],
     // ── Verification / captures (editor_only) ──
     ['capture_widget_preview', 'editor_only'],
+    ['capture_editor_screenshot', 'editor_only'],
+    ['capture_runtime_screenshot', 'editor_only'],
     ['capture_widget_motion_checkpoints', 'editor_only'],
     ['compare_capture_to_reference', 'editor_only'],
     ['compare_motion_capture_bundle', 'editor_only'],

package/dist/server-factory.js

@@ -1,6 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { UEClient } from './ue-client.js';
+import { packageVersion } from './helpers/package-metadata.js';
 import { ProjectController, } from './project-controller.js';
 import { AutomationController, } from './automation-controller.js';
 import { firstDefinedString } from './helpers/formatting.js';
@@ -23,7 +24,7 @@ export function createBlueprintExtractorServer(client = new UEClient(), projectC
     const registeredToolMap = new Map();
     const server = new McpServer({
         name: 'blueprint-extractor',
-        version: '6.0.3',
+        version: packageVersion,
     }, {
         instructions: serverInstructions,
     });

package/dist/tool-context.d.ts

@@ -7,6 +7,7 @@ export type ProjectAutomationContext = {
     engineDir?: string;
     engineRoot?: string;
     editorTarget?: string;
+    isPlayingInEditor?: boolean;
     hostPlatform?: string;
     supportsLiveCoding?: boolean;
     liveCodingAvailable?: boolean;

package/dist/tool-surface-manager.js

@@ -153,7 +153,7 @@ const SCOPE_DEFINITIONS = {
         prompts: [],
         tools: [
             'run_automation_tests', 'get_automation_test_run', 'list_automation_test_runs',
-            'get_project_automation_context',
+            'get_project_automation_context', 'start_pie', 'stop_pie', 'relaunch_pie',
         ],
     },
     verification: {
@@ -161,6 +161,7 @@ const SCOPE_DEFINITIONS = {
         description: 'Widget verification and capture tools',
         prompts: [],
         tools: [
+            'capture_editor_screenshot', 'capture_runtime_screenshot',
             'capture_widget_preview', 'capture_widget_motion_checkpoints',
             'compare_capture_to_reference', 'list_captures', 'cleanup_captures',
             'compare_motion_capture_bundle',

package/dist/tools/extraction.js

@@ -143,7 +143,10 @@ export function registerExtractionTools({ server, callSubsystemJson, scopeEnum,
             if (compact) {
                 parsed = compactMaterial(parsed);
             }
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess({
+                ...parsed,
+                operation: 'extract_material',
+            });
         }
         catch (error) {
             return jsonToolError(error);

package/dist/tools/import-jobs.js

@@ -66,7 +66,10 @@ export function registerImportJobTools({ server, callSubsystemJson, importJobSch
                 PayloadJson: JSON.stringify(transformedPayload),
                 bValidateOnly: validate_only,
             });
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess({
+                ...parsed,
+                operation: 'import_assets',
+            });
         }
         catch (error) {
             return jsonToolError(error);

package/dist/tools/material-authoring.js

@@ -15,6 +15,12 @@ function structuredToolError(message, options = {}) {
         isError: true,
     };
 }
+function normalizeMaterialToolOperation(parsed, operation) {
+    return {
+        ...parsed,
+        operation,
+    };
+}
 export function registerMaterialAuthoringTools({ server, callSubsystemJson, jsonObjectSchema, materialNodePositionSchema, materialConnectionSelectorFieldsSchema, materialGraphOperationKindSchema, materialGraphOperationSchema, }) {
     server.registerTool('create_material', {
         title: 'Create Material',
@@ -42,7 +48,7 @@ export function registerMaterialAuthoringTools({ server, callSubsystemJson, json
                     SettingsJson: JSON.stringify(settings ?? {}),
                     bValidateOnly: validate_only,
                 });
-                return jsonToolSuccess(parsed);
+                return jsonToolSuccess(normalizeMaterialToolOperation(parsed, 'create_material'));
             }
             const parsed = await callSubsystemJson('CreateMaterialFunction', {
                 AssetPath: asset_path,
@@ -50,7 +56,7 @@ export function registerMaterialAuthoringTools({ server, callSubsystemJson, json
                 SettingsJson: JSON.stringify(settings ?? {}),
                 bValidateOnly: validate_only,
             });
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess(normalizeMaterialToolOperation(parsed, 'create_material'));
         }
         catch (error) {
             return jsonToolError(error);
@@ -171,7 +177,7 @@ export function registerMaterialAuthoringTools({ server, callSubsystemJson, json
                 PayloadJson: JSON.stringify(payload),
                 bValidateOnly: validate_only,
             });
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess(normalizeMaterialToolOperation(parsed, 'modify_material'));
         }
         catch (error) {
             return jsonToolError(error);

package/dist/tools/project-control.js

@@ -43,6 +43,74 @@ export function registerProjectControlTools({ server, client, projectController,
             return jsonToolError(error);
         }
     });
+    server.registerTool('start_pie', {
+        title: 'Start PIE',
+        description: 'Request a Play-In-Editor session from the active editor.',
+        inputSchema: {
+            simulate: z.boolean().default(false).describe('When true, start Simulate-In-Editor instead of Play-In-Editor.'),
+        },
+        annotations: {
+            title: 'Start PIE',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ simulate }) => {
+        try {
+            const parsed = await callSubsystemJson('StartPIE', {
+                bSimulateInEditor: simulate,
+            });
+            return jsonToolSuccess(parsed);
+        }
+        catch (error) {
+            return jsonToolError(error);
+        }
+    });
+    server.registerTool('stop_pie', {
+        title: 'Stop PIE',
+        description: 'Stop the current Play-In-Editor session if one is active.',
+        inputSchema: {},
+        annotations: {
+            title: 'Stop PIE',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const parsed = await callSubsystemJson('StopPIE', {});
+            return jsonToolSuccess(parsed);
+        }
+        catch (error) {
+            return jsonToolError(error);
+        }
+    });
+    server.registerTool('relaunch_pie', {
+        title: 'Relaunch PIE',
+        description: 'Restart the current Play-In-Editor session by stopping it and scheduling a fresh launch.',
+        inputSchema: {
+            simulate: z.boolean().default(false).describe('When true, relaunch into Simulate-In-Editor instead of Play-In-Editor.'),
+        },
+        annotations: {
+            title: 'Relaunch PIE',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ simulate }) => {
+        try {
+            const parsed = await callSubsystemJson('RelaunchPIE', {
+                bSimulateInEditor: simulate,
+            });
+            return jsonToolSuccess(parsed);
+        }
+        catch (error) {
+            return jsonToolError(error);
+        }
+    });
     server.registerTool('wait_for_editor', {
         title: 'Wait For Editor',
         description: 'Poll the editor connection once per second until Remote Control responds again or the timeout elapses.',

package/dist/tools/widget-verification.js

@@ -3,6 +3,23 @@ import { buildCaptureResourceUri, buildResourceLinkContent, maybeBuildInlineImag
 import { explainProjectResolutionFailure } from '../helpers/project-utils.js';
 import { jsonToolError, jsonToolSuccess } from '../helpers/subsystem.js';
 import { normalizeAutomationRunResult, normalizeVerificationArtifact, normalizeVerificationArtifactReference, normalizeVerificationComparison, } from '../helpers/verification.js';
+async function buildCaptureExtraContent(artifact, label, description) {
+    const extraContent = [];
+    const resourceUri = typeof artifact.resourceUri === 'string'
+        ? artifact.resourceUri
+        : '';
+    const captureId = typeof artifact.captureId === 'string'
+        ? artifact.captureId
+        : '';
+    if (resourceUri) {
+        extraContent.push(buildResourceLinkContent(resourceUri, label || `Capture ${captureId || 'capture'}`, 'image/png', description));
+    }
+    const inlineImage = await maybeBuildInlineImageContent(typeof artifact.artifactPath === 'string' ? artifact.artifactPath : undefined);
+    if (inlineImage) {
+        extraContent.push(inlineImage);
+    }
+    return extraContent;
+}
 export function registerWidgetVerificationTools({ server, callSubsystemJson, automationController, resolveProjectInputs, captureResultSchema, widgetAnimationCheckpointSchema, motionCaptureModeSchema, motionCaptureBundleResultSchema, compareCaptureResultSchema, listCapturesResultSchema, cleanupCapturesResultSchema, compareMotionCaptureBundleResultSchema, }) {
     server.registerTool('capture_widget_preview', {
         title: 'Capture Widget Preview',
@@ -47,6 +64,95 @@ export function registerWidgetVerificationTools({ server, callSubsystemJson, aut
             return jsonToolError(error);
         }
     });
+    server.registerTool('capture_editor_screenshot', {
+        title: 'Capture Editor Screenshot',
+        description: 'Capture the active editor viewport and return screenshot artifacts.',
+        inputSchema: {},
+        outputSchema: captureResultSchema,
+        annotations: {
+            title: 'Capture Editor Screenshot',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const parsed = await callSubsystemJson('CaptureEditorScreenshot', {});
+            const artifact = normalizeVerificationArtifact(parsed);
+            const captureId = typeof artifact.captureId === 'string' ? artifact.captureId : '';
+            const resourceUri = buildCaptureResourceUri(captureId);
+            const normalizedArtifact = {
+                ...artifact,
+                resourceUri,
+            };
+            const extraContent = await buildCaptureExtraContent(normalizedArtifact, captureId ? `Editor ${captureId}` : 'Editor screenshot', 'Captured editor viewport screenshot.');
+            return jsonToolSuccess(normalizedArtifact, { extraContent });
+        }
+        catch (error) {
+            return jsonToolError(error);
+        }
+    });
+    server.registerTool('capture_runtime_screenshot', {
+        title: 'Capture Runtime Screenshot',
+        description: 'Run an automation scenario and return the first normalized runtime screenshot artifact.',
+        inputSchema: {
+            automation_filter: z.string().regex(/^[A-Za-z0-9_.+* -]+$/u, 'automation_filter must contain only alphanumeric, dots, underscores, plus, asterisk, hyphen, and spaces').describe('Automation test filter passed to run_automation_tests.'),
+            engine_root: z.string().optional().describe('Optional Unreal Engine root. Falls back to editor context or UE_ENGINE_ROOT.'),
+            project_path: z.string().optional().describe('Optional .uproject path. Falls back to editor context or UE_PROJECT_PATH.'),
+            target: z.string().optional().describe('Optional editor target name to keep in the run metadata.'),
+            report_output_dir: z.string().optional().describe('Optional host filesystem directory for this run.'),
+            timeout_seconds: z.number().int().positive().default(3600).describe('Maximum wall-clock time for the automation process before the host terminates it.'),
+            null_rhi: z.boolean().default(false).describe('Leave false for screenshot-backed runtime verification. Set true only when the automation path exports images without live rendering.'),
+        },
+        outputSchema: captureResultSchema,
+        annotations: {
+            title: 'Capture Runtime Screenshot',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ automation_filter, engine_root, project_path, target, report_output_dir, timeout_seconds, null_rhi }) => {
+        try {
+            const resolved = await resolveProjectInputs({ engine_root, project_path, target });
+            if (!resolved.engineRoot || !resolved.projectPath) {
+                throw explainProjectResolutionFailure('capture_runtime_screenshot requires engine_root and project_path', resolved);
+            }
+            const run = normalizeAutomationRunResult(await automationController.runAutomationTests({
+                automationFilter: automation_filter,
+                engineRoot: resolved.engineRoot,
+                projectPath: resolved.projectPath,
+                target: resolved.target,
+                reportOutputDir: report_output_dir,
+                timeoutMs: timeout_seconds * 1000,
+                nullRhi: null_rhi,
+            }));
+            const runtimeArtifact = (Array.isArray(run.verificationArtifacts) ? run.verificationArtifacts : [])
+                .map((artifact) => normalizeVerificationArtifactReference(artifact))
+                .find((artifact) => artifact.surface === 'pie_runtime');
+            if (!runtimeArtifact) {
+                return jsonToolError(new Error('capture_runtime_screenshot did not find a normalized pie_runtime artifact. Ensure the automation scenario exports a screenshot-backed artifact.'));
+            }
+            const extraContent = await buildCaptureExtraContent(runtimeArtifact, typeof runtimeArtifact.captureId === 'string' && runtimeArtifact.captureId.length > 0
+                ? `Runtime ${runtimeArtifact.captureId}`
+                : 'Runtime screenshot', 'Automation-exported runtime screenshot.');
+            return jsonToolSuccess({
+                ...runtimeArtifact,
+                operation: 'capture_runtime_screenshot',
+                automationRun: run,
+                inputResolution: {
+                    engineRoot: resolved.sources.engineRoot,
+                    projectPath: resolved.sources.projectPath,
+                    target: resolved.sources.target,
+                    contextError: resolved.contextError,
+                },
+            }, { extraContent });
+        }
+        catch (error) {
+            return jsonToolError(error);
+        }
+    });
     server.registerTool('capture_widget_motion_checkpoints', {
         title: 'Capture Widget Motion Checkpoints',
         description: 'Play a widget animation or automation scenario and capture named motion checkpoints.\n\n'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blueprint-extractor-mcp",
-  "version": "6.0.3",
+  "version": "6.0.5",
   "description": "MCP server for the Unreal Engine BlueprintExtractor plugin over Remote Control",
   "type": "module",
   "main": "dist/index.js",