Skip to content

Enabling MCP in UE 5.8

From version 1.4.0, Vertex Animation Studio ships MCP (Model Context Protocol) toolsets. They let an AI coding agent such as Claude Code, Cursor, VS Code Copilot, Gemini CLI or Codex place crowds, play animations, send events and build StateTrees in the editor.

The toolsets run on top of Epic’s Unreal MCP plugin, which ships with the engine but is off by default.

  1. Open your project in UE 5.8.
  2. Go to Edit > Plugins.
  3. Search for Unreal MCP and tick the checkbox.
  4. Accept the experimental warning.
  5. Restart the editor.

Enabling Unreal MCP also enables Toolset Registry and Python Editor Script Plugin, which it depends on. You do not need to enable them separately.

The MCP server does not start on its own. Pick one of these:

  • Every session: go to Edit > Editor Preferences, search for Model Context Protocol and tick Auto Start Server. Restart the editor.
  • Once: open the console (` key) and run ModelContextProtocol.StartServer.
  • From the command line: launch the editor with -ModelContextProtocolStartServer.

By default the server listens on:

http://127.0.0.1:8000/mcp

You can change the port and path under Server Port Number and Server Url Path in the same preferences section. These settings are saved per user, per project.

VAS registers its toolsets when the editor starts. If registration fails, the Output Log shows:

Vertex Animation Studio: MCP toolset not registered: <reason>

No message means the toolsets are registered. Once an agent is connected you can ask it to list toolsets. You should see three from VAS:

ToolsetWhat it covers
CrowdPlacementToolsPlace, move and remove crowds in the open level
CrowdAnimationToolsAnimate and inspect crowds and animated meshes
CrowdAssetToolsAsset collections, crowd brushes, StateTrees and export
CommandWhat it does
ModelContextProtocol.StartServer [port]Starts the MCP server, optionally on a different port
ModelContextProtocol.StopServerStops the MCP server
ModelContextProtocol.RefreshToolsRebuilds the tool list. Use it if an agent cannot see a toolset

Connect your agent: Using VAS with AI Agents.