/ue-mcp-epic-routing

name: ue-mcp-epic-routing
description: Use when deciding between ue-mcp's native category actions and Epic's wrapped ToolsetRegistry tools (the `epic_*` actions, incl. the Blueprint graph DSL) for a task in Unreal. Pulls in when authoring Blueprint graph bodies, or any time both a native action and an epic_* action could do the job and you need to pick.

Epic-vs-native tool routing (ue-mcp)

ue-mcp exposes two overlapping surfaces. Picking the right one per task avoids slow, failure-prone paths.

• **Native category actions** - `blueprint(...)`, `level(...)`, `material(...)`, etc. Hand-written, idempotent, with rollback and structured errors.
• **Epic `epic_*` actions** - Epic's own MCP toolsets, surfaced in-category when the ToolsetRegistry is available (UE 5.8+ with the Epic toolset plugins enabled). Discover them with `epic(action="status")` and `epic(action="list_toolsets")`.

This is **not** a blanket "always use epic" rule. Epic needs 5.8 + plugins, and much of ue-mcp has no epic equivalent or adds idempotency/rollback the raw tools lack.

The one that matters most: Blueprint graph bodies -> the DSL

Authoring the **contents of a graph** (event graph, function body, macro) is the headline case.

• Prefer `blueprint(action="epic_write_graph_dsl", ...)`. Call `blueprint(action="epic_get_graph_dsl_docs")` first to get the S-expression grammar.
• It authors **and compiles the whole graph in one call** - materially faster and more reliable than node-by-node `add_node` + `connect_pins` (typically one correct pass instead of several failed iterations).

Decision table

| Task | Route | |------|-------| | Author/replace a graph body (nodes + wiring) | `blueprint(epic_write_graph_dsl)` (docs first) | | Read / inspect a graph, list graphs/variables/functions | native `blueprint(read*, list_*, get_execution_flow)` | | SCS components, reparenting, component properties | native `blueprint(add_component, ...)` | | CDO / class defaults, tick settings | native `blueprint(set_class_default, set_actor_tick_settings)` | | Interfaces, event dispatchers | native `blueprint(create_interface, add_interface, add_event_dispatcher)` | | Structured compile / validate with diagnostics | native `blueprint(compile, validate)` | | A task with no native action but an `epic_*` one exists | the `epic_*` action | | A task with no epic equivalent | the native action |

Fallback

If `epic(action="status")` reports the registry unavailable (pre-5.8, plugins off, or `available=false`), route **everything** through the native path - the DSL actions will not exist. The native node-by-node path (`add_node` -> `set_node_property` -> `connect_pins` -> `compile`) always works; see the `ue-mcp-blueprint` skill.