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.
Step 1: Enable the Unreal MCP plugin
Section titled “Step 1: Enable the Unreal MCP plugin”- Open your project in UE 5.8.
- Go to Edit > Plugins.
- Search for Unreal MCP and tick the checkbox.
- Accept the experimental warning.
- 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.
Step 2: Start the MCP server
Section titled “Step 2: Start the MCP server”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 runModelContextProtocol.StartServer. - From the command line: launch the editor with
-ModelContextProtocolStartServer.
By default the server listens on:
http://127.0.0.1:8000/mcpYou 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.
Step 3: Check the VAS toolsets loaded
Section titled “Step 3: Check the VAS toolsets loaded”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:
| Toolset | What it covers |
|---|---|
CrowdPlacementTools | Place, move and remove crowds in the open level |
CrowdAnimationTools | Animate and inspect crowds and animated meshes |
CrowdAssetTools | Asset collections, crowd brushes, StateTrees and export |
Console commands
Section titled “Console commands”| Command | What it does |
|---|---|
ModelContextProtocol.StartServer [port] | Starts the MCP server, optionally on a different port |
ModelContextProtocol.StopServer | Stops the MCP server |
ModelContextProtocol.RefreshTools | Rebuilds the tool list. Use it if an agent cannot see a toolset |
Next step
Section titled “Next step”Connect your agent: Using VAS with AI Agents.