integration/Plugins/BlueprintMCP/endpoint-rename-plan.md

# BlueprintMCP Endpoint Naming Plan

Convention: every endpoint is `verb_noun`. Names should be descriptive enough that you can guess what the endpoint does without reading documentation. Verbs:
- **dump** — return the entire contents of a single object (blueprint, graph, material, etc.)
- **list** — enumerate assets or sub-elements from the asset registry (cheap, no loading)
- **search** — deep search that loads assets, inspects their contents, and returns matches
- **find** — look up references or locate specific items by criteria
- **create** — make a new asset/graph/struct/enum
- **add** — add a sub-element to an existing thing (variable, component, parameter, etc.)
- **remove/delete** — remove a sub-element or asset
- **set/change** — change a property value or type
- **rename** — rename something
- **connect/disconnect** — wire/unwire pins
- **validate/compile** — compile and report errors
- **snapshot/diff/restore** — capture, compare, and restore graph state

## Blueprint — Read/Query

| Current | Proposed | Description |
|---------|----------|-------------|
| `list` | `list_blueprint_assets` | List all blueprint and level blueprint assets from the asset registry (no loading). Optional `query` filters by name/path substring. Optional `parentClass` filters by parent class name. Returns name, path, and parent class for each. |
| `blueprint` | `dump_blueprint` | Load one blueprint by name and dump everything: variables, graph list, interfaces, and parent class. |
| `graph` | `dump_blueprint_graph` | Load one graph by blueprint name + graph name. Dumps all nodes with their pins, connections, positions, and metadata. |
| `search` | `search_within_blueprints` | Deep search: loads every blueprint, iterates all graphs/nodes, and finds nodes whose title, function name, event name, or variable name matches the query. Returns blueprint, graph, and node info for each match. |
| `references` | `find_asset_references` | Given an asset path, queries the asset registry for all packages that reference it. Separates results into blueprint referencers and other referencers. |
| `search_by_type` | `search_type_usage_in_blueprints` | Deep search: loads every blueprint and finds variables, function parameters, and pin types that use a given type name (struct, class, or enum). Returns usage location and context for each match. |
| `get_pin_info` | `get_pin_details` | Get detailed type and connection info for a specific pin (by blueprint, nodeId, pinName). |
| `check_pin_compatibility` | `check_pin_connection_compatibility` | Check whether two specific pins (source and target) can be connected. Returns compatibility and any error message. |
| `test_save` | `test_save_blueprint_package` | Diagnostic: load a blueprint and save its package with no modifications, to verify the save pipeline works. |

## Blueprint — Discovery (Unreal reflection)

| Current | Proposed | Description |
|---------|----------|-------------|
| `list_classes` | `search_unreal_classes` | Search all UClasses in the engine. Optional `query` filters by class name substring. Optional `parentClass` restricts to subclasses. Returns class name, path, parent, and flags. |
| `list_functions` | `list_class_functions` | List all UFunctions on a given class. Optional `query` filters by function name substring. Returns name, parameters, return type, and flags for each. |
| `list_properties` | `list_class_properties` | List all UProperties on a given class. Optional `query` filters by property name substring. Returns name, type, flags, and metadata for each. |

## Blueprint — Validation

| Current | Proposed | Description |
|---------|----------|-------------|
| `validate_blueprint` | `compile_blueprint` | Compile one blueprint and report any errors/warnings with graph, node, and message details. |
| `validate_all_blueprints` | `compile_all_blueprints` | Compile all blueprints (optional `query` to filter which ones). Returns per-blueprint pass/fail with error details. Supports pagination. |

## Blueprint — Creation/Structure

| Current | Proposed | Description |
|---------|----------|-------------|
| `create_blueprint` | `create_blueprint_asset` | Create a new Blueprint asset with a given name, path, and parent class. |
| `create_graph` | `create_blueprint_graph` | Create a new function or macro graph inside a blueprint. |
| `delete_graph` | `delete_blueprint_graph` | Delete a graph from a blueprint. |
| `rename_graph` | `rename_blueprint_graph` | Rename a graph inside a blueprint. |
| `reparent_blueprint` | `reparent_blueprint` | Change a blueprint's parent class. |
| `create_struct` | `create_struct_asset` | Create a new user-defined struct asset. |
| `create_enum` | `create_enum_asset` | Create a new user-defined enum asset. |
| `add_struct_property` | `add_struct_field` | Add a field to a user-defined struct. |
| `remove_struct_property` | `remove_struct_field` | Remove a field from a user-defined struct. |

## Blueprint — Variables

| Current | Proposed | Description |
|---------|----------|-------------|
| `add_variable` | `add_blueprint_variable` | Add a variable to a blueprint with a given name and type. |
| `remove_variable` | `remove_blueprint_variable` | Remove a variable from a blueprint by name. |
| `change_variable_type` | `change_blueprint_variable_type` | Change an existing blueprint variable's type. |
| `set_variable_metadata` | `set_blueprint_variable_metadata` | Set variable metadata (category, tooltip, replication, etc.). |

## Blueprint — Functions/Parameters

| Current | Proposed | Description |
|---------|----------|-------------|
| `add_function_parameter` | `add_function_parameter` | Add an input or output parameter to a function graph. |
| `remove_function_parameter` | `remove_function_parameter` | Remove a parameter from a function graph. |
| `change_function_param_type` | `change_function_parameter_type` | Change the type of an existing function parameter. |

## Blueprint — Event Dispatchers

| Current | Proposed | Description |
|---------|----------|-------------|
| `add_event_dispatcher` | `add_event_dispatcher` | Add an event dispatcher to a blueprint. |
| `list_event_dispatchers` | `list_event_dispatchers` | List all event dispatchers on a blueprint with their delegate signatures. |

## Blueprint — Components

| Current | Proposed | Description |
|---------|----------|-------------|
| `add_component` | `add_blueprint_component` | Add a component to a blueprint's component hierarchy. |
| `remove_component` | `remove_blueprint_component` | Remove a component from a blueprint. |
| `list_components` | `list_blueprint_components` | List all components in a blueprint's component hierarchy. |

## Blueprint — Interfaces (new-style)

| Current | Proposed | Description |
|---------|----------|-------------|
| `list_interfaces` | `list_blueprint_interfaces` | List all interfaces implemented by a blueprint, with the function stubs each provides. |
| `add_interface` | `add_blueprint_interface` | Add an interface implementation to a blueprint. Creates function stub graphs. |
| `remove_interface` | `remove_blueprint_interface` | Remove an interface implementation from a blueprint. Optionally preserves function graphs. |

## Blueprint — Node Mutation (new-style)

| Current | Proposed | Description |
|---------|----------|-------------|
| `search_node_types` | `search_spawnable_node_types` | Search the blueprint action database (the right-click menu) for spawnable node types matching a query string. Returns full action names like "Utilities\|Flow Control\|Branch". |
| `spawn_node` | `spawn_node_in_graph` | Create one or more nodes in a graph by exact action name (from search_spawnable_node_types). Invokes the spawner and returns the new node details. |
| `delete_node` | `delete_node_from_graph` | Delete a node from a graph by GUID. |
| `move_node` | `set_node_position` | Set a node's X/Y position in the graph editor. |
| `duplicate_nodes` | `duplicate_nodes_in_graph` | Duplicate one or more nodes within a graph. |
| `connect_pins` | `connect_blueprint_pins` | Connect two pins (by blueprint, source node+pin, target node+pin). |
| `disconnect_pin` | `disconnect_blueprint_pin` | Break connections on a pin (all connections, or a specific one). |
| `set_pin_default` | `set_pin_default_value` | Set a pin's default value string. |
| `get_node_comment` | `get_node_comment` | Get the comment text on a node. |
| `set_node_comment` | `set_node_comment` | Set or clear the comment text on a node. |
| `replace_function_calls` | `replace_function_calls_in_blueprint` | Bulk-replace all calls to one function with calls to another across a blueprint. |
| `refresh_all_nodes` | `refresh_all_nodes_in_graph` | Refresh (reconstruct) all nodes in a graph to pick up signature changes. |
| `change_struct_node_type` | `change_struct_node_type` | Change which struct a Break/Make/Set-Members node operates on. |
| `set_blueprint_default` | `set_class_default_value` | Set a property value on the blueprint's Class Default Object (CDO). |
| `rename_asset` | `rename_asset` | Rename or move an asset to a new name/path. |
| `delete_asset` | `delete_asset` | Delete an asset from the project. |
| `diff_blueprints` | `diff_two_blueprints` | Compare two blueprints and return structural differences (added/removed/changed nodes, connections, variables). |

## Blueprint — Snapshots

| Current | Proposed | Description |
|---------|----------|-------------|
| `snapshot_graph` | `snapshot_blueprint_graph` | Capture a snapshot of a blueprint's graphs (nodes and connections) for later diffing or restore. |
| `diff_graph` | `diff_blueprint_graph_vs_snapshot` | Diff the current state of a blueprint's graphs against a previously captured snapshot. Returns added/removed/changed nodes and connections. |
| `restore_graph` | `restore_blueprint_graph_from_snapshot` | Restore a blueprint's graphs to the state captured in a snapshot (recreates nodes and connections). |
| `find_disconnected_pins` | `find_pins_disconnected_since_snapshot` | Compare current graphs against a snapshot and find pins that were previously connected but are now disconnected. |
| `analyze_rebuild_impact` | `analyze_cpp_rebuild_impact` | Given a C++ module name, find all blueprints that use structs/classes from that module and report which nodes/pins would be affected by a rebuild. |

## Materials — Read

| Current | Proposed | Description |
|---------|----------|-------------|
| `materials` | `list_material_assets` | List all material and material instance assets from the asset registry (no loading). Optional `query` filters by name/path substring. Optional `type` filters to "material" or "instance" only. |
| `material` | `dump_material` | Load one material by name and dump everything: properties (domain, blend mode, shading model, two-sided, etc.) and expression summary. |
| `material_graph` | `dump_material_expression_graph` | Load one material and dump its full expression graph: every expression node with type, position, parameter values, and all pin connections. |
| `describe_material` | `describe_material_in_english` | Load a material and generate a human-readable text description by tracing the expression graph backwards from each material output pin. |
| `search_materials` | `search_within_materials` | Deep search: loads every material, inspects expression nodes, and finds materials/expressions whose name, class, description, or parameter name matches the query. |
| `material_references` | `find_material_references` | Given a material name, query the asset registry for all assets that reference it. |

## Materials — Mutation

| Current | Proposed | Description |
|---------|----------|-------------|
| `create_material` | `create_material_asset` | Create a new material asset. |
| `set_material_property` | `set_material_property` | Set a top-level material property (blend mode, shading model, two-sided, etc.). |
| `add_material_expression` | `add_material_expression` | Add a material expression node to a material's graph. |
| `delete_material_expression` | `delete_material_expression` | Remove a material expression node from a material's graph. |
| `connect_material_pins` | `connect_material_expression_pins` | Connect two expression pins in a material graph. |
| `disconnect_material_pin` | `disconnect_material_expression_pin` | Disconnect a pin in a material graph. |
| `set_expression_value` | `set_material_expression_property` | Set a property on a material expression node (e.g. constant value, texture, parameter name). |
| `move_material_expression` | `set_material_expression_position` | Set X/Y position of a material expression in the graph editor. |
| `validate_material` | `compile_material` | Compile a material and report errors. |

## Material Instances

| Current | Proposed | Description |
|---------|----------|-------------|
| `create_material_instance` | `create_material_instance_asset` | Create a new material instance constant with a given parent material. |
| `set_material_instance_parameter` | `set_material_instance_parameter` | Set a parameter override on a material instance (scalar, vector, texture, etc.). |
| `material_instance_params` | `dump_material_instance_parameters` | Dump all parameter values on a material instance, showing both overridden and inherited values. |
| `reparent_material_instance` | `reparent_material_instance` | Change a material instance's parent material. |

## Material Functions

| Current | Proposed | Description |
|---------|----------|-------------|
| `material_functions` | `list_material_function_assets` | List all material function assets from the asset registry. Optional `query` filters by name/path substring. |
| `material_function` | `dump_material_function` | Load one material function and dump its expressions, inputs, and outputs. |
| `create_material_function` | `create_material_function_asset` | Create a new material function asset. |

## Material Snapshots

| Current | Proposed | Description |
|---------|----------|-------------|
| `snapshot_material_graph` | `snapshot_material_expression_graph` | Capture a snapshot of a material's expression graph. |
| `diff_material_graph` | `diff_material_graph_vs_snapshot` | Diff a material's current expression graph against a snapshot. |
| `restore_material_graph` | `restore_material_graph_from_snapshot` | Restore a material's expression graph from a snapshot. |

## Animation Blueprints

| Current | Proposed | Description |
|---------|----------|-------------|
| `create_anim_blueprint` | `create_anim_blueprint_asset` | Create a new Animation Blueprint asset with a given skeleton. |
| `add_anim_state` | `add_anim_state_to_machine` | Add a state node to a state machine graph. |
| `remove_anim_state` | `remove_anim_state_from_machine` | Remove a state node from a state machine graph. |
| `add_anim_transition` | `add_anim_state_transition` | Add a transition between two states in a state machine. |
| `set_transition_rule` | `set_anim_transition_rule` | Set the boolean condition expression for a state machine transition. |
| `add_anim_node` | `add_anim_graph_node` | Add an animation node (sequence player, blend space player, etc.) to a state's graph. |
| `add_state_machine` | `add_anim_state_machine` | Add a state machine sub-graph to an anim blueprint's AnimGraph. |
| `set_state_animation` | `set_anim_state_animation` | Set which animation sequence a state plays. |
| `list_anim_slots` | `list_anim_slot_names` | List all animation slot names available in the skeleton's slot groups. |
| `list_sync_groups` | `list_anim_sync_groups` | List all animation sync groups defined in the project. |
| `create_blend_space` | `create_blend_space_asset` | Create a new Blend Space asset. |
| `set_blend_space_samples` | `set_blend_space_sample_points` | Set the sample points (animation + coordinates) on a blend space. |
| `set_state_blend_space` | `set_anim_state_blend_space` | Set a state to play a blend space instead of a single animation. |

## System

| Current | Proposed | Description |
|---------|----------|-------------|
| `health` | `health` | Returns server status, mode, and asset counts. Answered on HTTP thread, no game-thread access. |
| `rescan` | `rescan_asset_registry` | Re-scan the asset registry and refresh all cached asset lists. |
| `shutdown` | `shutdown` | Request graceful engine exit. Only available in commandlet mode. |