shadergraph

Unity Open MCP — Shader Graph Extension

Skill for AI agents driving the Unity Shader Graph package (com.unity.shadergraph) in a Unity project through the unity-open-mcp MCP server.

This domain is embedded in the bridge, compile-gated on com.unity.shadergraph, and auto-activating. Its tools compile in only when the project has com.unity.shadergraph installed (the bridge sets the UNITY_OPEN_MCP_EXT_SHADERGRAPH define automatically). When the package is present, the shadergraph group activates automatically for the session — its tools appear in ListTools with no manual manage_tools call. This is the first domain to ship with package-detection auto-activation.

Preconditions

• Unity Editor is open with the target project.
• unity_open_mcp_ping returns connected: true.
• The project has com.unity.shadergraph installed. If capabilities reports the shadergraph group as available: false, install the package (and a Scriptable Render Pipeline — URP or HDRP) and let the bridge recompile.
• The shadergraph group is auto-activated when the package is present — check unity_open_mcp_manage_tools(action="list_groups"); the group should show activationSource: "auto". If you deactivated it manually, re-activate with manage_tools(action="activate", group="shadergraph").

Tool prefix

All tools in this pack use unity_open_mcp_shader_graph_* (note the underscore split — shader_graph, matching the catalog word-boundary convention).

Vocabulary

A Shader Graph is a .shadergraph asset — the authored graph that compiles into a shader. It holds an ordered list of nodes, each exposing input and output slots (identified by integer slot ids). Edges connect an output slot of one node to an input slot of another. The graph has one or more output nodes (Vertex / Fragment / etc.) that the rest of the graph feeds into.

Node ids are stable string GUIDs assigned by Shader Graph — read them via shader_graph_open or the return value of shader_graph_node_add. Slot ids are integers; an open summary lists each node's slots with { id, name }.