Tools Reference

Blueprint AI registers 25+ tools that AI agents can call to read, create, and modify Unreal Engine assets. Tools are executed on the game thread and logged to Saved/Logs/AIK_ToolAudit.log.

Tool Execution Model

All tool calls are dispatched to the Unreal game thread for safety. When called from the MCP server (which runs on an HTTP background thread), execution is automatically forwarded via AsyncTask(ENamedThreads::GameThread, ...). A configurable timeout (default 60s) prevents long-running tools from blocking the agent indefinitely.

Tool Registry

Tools are registered at module startup in FBAIToolToolRegistry::RegisterBuiltInTools(). Each tool inherits from FBAIToolToolBase and implements Execute(Args). You can disable individual tools globally or per-profile in Settings.

Scripting

execute_python

Execute arbitrary Python scripts inside the Unreal Editor Python environment. Provides access to 1000+ UE Python APIs for asset creation, manipulation, editor automation, and bulk operations. This is the most powerful and flexible tool.

Arguments: script (string)

Reading & Introspection

read_file

Read an asset's contents with deep introspection. For Blueprints, this includes full graph structure, node details, pin connections, variables, components, functions, and events. Also reads C++ source files, data tables, and other text-based assets.

Arguments: name (string), path? (string), graph? (string)

find_node

Search for nodes within a Blueprint graph by name, type, or property. Returns matching node GUIDs and details. Use this before editing to locate specific nodes.

Arguments: asset (string), query (string), graph? (string)

read_logs

Read the Unreal Engine output log or compile a Blueprint and return compiler errors/warnings. Supports filtering by category and log level.

Arguments: operation ('read_log' | 'compile_blueprint'), asset? (string)

screenshot

Capture a screenshot of the level viewport or an asset editor viewport. Supports camera positioning for level captures. Returns a base64-encoded image for vision-capable models.

Arguments: target ('viewport' | 'asset_editor'), asset? (string), camera? (object)

Blueprint Editing

edit_blueprint

Create and modify Blueprint assets. Operations include adding/removing components, variables, functions, event dispatchers, interface implementations, and widget hierarchy manipulation. Also supports Animation Blueprint state machine editing.

Arguments: name (string), operation (string), ... operation-specific args

edit_graph

Edit Blueprint event graphs and function graphs. Add nodes, create connections between pins, set default values, remove nodes, and rewire logic. Supports live preview for Material graphs.

Arguments: asset (string), operation (string), graph? (string), ... operation-specific args

configure_asset

Set properties on any asset using dot-notation paths. Supports targeting specific graph nodes by GUID. Useful for configuring assets that don't have dedicated editing tools.

Arguments: asset_path (string), property (string), value (any)

Data Structures

edit_data_structure

Create and edit UStruct and UEnum assets. Add, remove, or rename fields in user-defined structs, and add/remove entries in user-defined enums. Not available through Python.

Arguments: asset (string), operation (string), ... operation-specific args

Animation

edit_ik_rig

Edit IK Rig assets for inverse kinematics. Add/remove goals, solvers, bone chains, and retarget chains. Supports Full Body IK and CCDIK solver configurations.