Wicked Owl Games - Blueprint Forge — MCP Blueprint Editing for AI Agents

Blueprint Forge gives your AI coding agent real hands inside the Unreal editor: it can edit Blueprints node by node — including inside collapsed graphs (Composite nodes), which Epic's built-in BlueprintTools toolset can't create nodes in — and walk a Blueprint all the way over to C++. New in 0.10.0, the conversion suite covers Widget Blueprints and Animation Blueprints too, exports a Blueprint's class defaults as C++ data, and can swap placed Blueprint actors in a level for their C++ class. The full workflow is documented in the conversion guide included in the package (Docs/CONVERSION_GUIDE.md) — it's the workflow that converted a full project of about 120 Blueprints to C++.

AI Link — one click

The AI button on the Level Editor toolbar starts Epic's MCP server if it isn't running, writes the MCP config for your AI client, opens the editor Terminal in your project folder, and runs the client. Choose the client in Project Settings > Plugins > Blueprint Forge: Claude Code, Codex, Gemini CLI, Cursor, VS Code, or a custom command. Nothing needs configuring first — the defaults work.

58 MCP tools

Registers a BlueprintForgeTools toolset with Epic's Toolset Registry (UE 5.8+), backed by C++ libraries that are also callable from Python and Editor Utility Blueprints.


Inspect


  • bpf_list_graphs — every graph in a Blueprint, including collapsed subgraphs

  • bpf_get_nodes — nodes, pins, defaults, and links of a graph

  • bpf_find_nodes / bpf_get_node — filtered, compact node search and single-node reads for big graphs

  • bpf_dump_blueprint — full structure as JSON (variables, functions, events, dispatchers, components, calls)

  • bpf_dump_graph_logic — a graph's logic as readable pseudo-code, collapsed graphs and timelines included


Create & edit nodes


  • bpf_add_call_function — a Call Function node for any class, in any graph

  • bpf_add_node — Branch, Sequence, Reroute, Self, Variable Get/Set, Cast, macros, Make/Break Struct, Comments

  • bpf_replace_call_function — swap a function in one step, keeping position, links, defaults, and splits

  • bpf_set_pin_default / bpf_set_node_position / bpf_delete_node / bpf_set_property_text


Wiring


  • bpf_connect_pins / bpf_break_pin_links / bpf_move_pin_links

  • bpf_split_pin / bpf_recombine_pin — split and rejoin struct pins (Rotator, Vector, …)


Batch, compile & save


  • bpf_apply_ops — a JSON list of edits in one call and one undo step

  • bpf_compile_blueprint — errors and warnings name the offending nodes and pins

  • bpf_save_blueprint / bpf_save_all / bpf_set_auto_save / bpf_undo

  • bpf_resave_assets — load, compile, and save assets so fixed-up references are written before a covered asset is deleted

  • bpf_self_test — 12 smoke-test checks on throw-away assets; run it first on a new install


Blueprint → C++ migration


  • bpf_generate_cpp_skeleton / bpf_generate_cpp_struct / bpf_generate_cpp_enum / bpf_dump_struct — C++ source generated from Blueprints, structs, and enums (with PropertyRedirects)

  • bpf_reparent_blueprint / bpf_compare_blueprint_to_class — move a Blueprint onto its new C++ parent and check parity

  • bpf_convert_type / bpf_convert_types_in_blueprints / bpf_convert_interface — switch every use of a Blueprint type to its C++ replacement, one Blueprint or a batch, compiling as it goes

  • bpf_retype_variable / bpf_retype_function_pin / bpf_retype_struct_member — re-point individual pieces first when order matters

  • bpf_find_type_usages / bpf_find_references / bpf_list_blueprints_by_parent — where a type or asset is used; every Blueprint derived from a class

  • bpf_remove_ported_logic — delete the Blueprint side once the C++ exists

  • bpf_restore_links_from_reference / bpf_repair_links / bpf_copy_component_settings — recover links and settings from an older copy and repair conversion leftovers

  • bpf_reassign_data_table_row_struct — point a Data Table at a C++ row struct, keeping its rows

  • bpf_generate_cpp_defaults (new in 0.10.0) — export what a Blueprint child sets on top of its native C++ parent (class defaults, component settings, added components) as C++ data, with a report of anything Blueprint-only so nothing is lost silently


Widget Blueprints → C++ (new in 0.10.0)


  • bpf_generate_cpp_widget_runtime — writes the header-only ForgeWidgetBuild.h runtime once

  • bpf_generate_cpp_widget_tree — the whole widget layout as C++ data: widgets, slot/designer properties, bindings, and animations, played by the generated animation player

  • bpf_describe_widget_animations — text dump of a Widget Blueprint's animations, to check or hand-port them

  • bpf_bind_widget_property — re-point a widget property binding at a Blueprint (or inherited C++) function

  • bpf_generate_cpp_editor_tab_runtime — host a C++ editor utility widget in a nomad tab with a Window menu entry, replacing editor utility widget Blueprints


Animation Blueprints → C++ (new in 0.10.0)


  • bpf_generate_cpp_anim_graph_runtime — writes ForgeAnimGraph.h: a native proxy that plays one state machine (sequence / blend space players, crossfades), an optional montage slot and layered blend per bone, and mesh-space bone controllers

  • bpf_generate_cpp_anim_graph — reads an Animation Blueprint's AnimGraph and writes the graph as C++ data, returning the variables it reads and warnings for anything not converted


Levels (new in 0.10.0)


  • bpf_replace_actors — replace every placed actor of one class with another class in the open level, keeping transform, label, folder, tags, attach parent, and same-named component settings (verified property by property; dry_run lists first)


Editor control


  • bpf_close_editor / bpf_restart_editor / bpf_rebuild_and_restart — save everything, then close, restart, or rebuild the C++ and relaunch, with no prompts (helper scripts are supplied in the documentation, not in the package — FAB doesn't allow .bat files in plugin packages; only bpf_rebuild_and_restart needs them)


Every edit is a single undoable transaction, and nothing is written to disk until the asset is saved.