Skip to content
Back to search

unreal-engine-skills-for-claude-code

Control Unreal Editor directly from Claude Code via MCP. Hundreds of tools exposed via Unreal's ToolsetRegistry across 30+ toolsets: actors, blueprints, materials, Niagara, Control Rigs, Sequencer, State Trees, widgets, Gameplay Ability System, automation testing, and more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/epicgames--unreal-engine-skills-for-claude-code-plugin/badge.svg)](/listings/epicgames--unreal-engine-skills-for-claude-code-plugin)

HTML

<a href="/listings/epicgames--unreal-engine-skills-for-claude-code-plugin"><img src="/api/listings/epicgames--unreal-engine-skills-for-claude-code-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This plugin is published in Anthropic's official Claude Code plugin marketplace, `claude-plugins-official`, which is available automatically when you start Claude Code. Browse it at [claude.com/plugins](https://claude.com/plugins) or in the **Discover** tab of the `/plugin` panel.

Install for a single developer

In Claude Code:

/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official

If the official marketplace is not present, add it first, then run the install command above:

/plugin marketplace add anthropics/claude-plugins-official

Install for a team

Commit this to `.claude/settings.json` in the project that should use the plugin. Anyone who trusts the project folder is prompted to install it automatically:

{
  "enabledPlugins": {
    "unreal-engine-skills-for-claude-code@claude-plugins-official": true
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 10 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "unreal-engine-skills-for-claude-code",
  3. "version": "3.1.2",
  4. "description": "Control Unreal Editor directly from Claude Code via MCP. Hundreds of tools exposed via Unreal's ToolsetRegistry across 30+ toolsets: actors, blueprints, materials, Niagara, Control Rigs, Sequencer, State Trees, widgets, Gameplay Ability System, automation testing, and more.",
  5. "author": {
  6. "name": "Thomas Mansencal",
  7. "email": "thomas.mansencal@epicgames.com"
  8. },
  9. "license": "MIT"
  10. }
README.md · README · 112 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Unreal Engine Skills for Claude Code
  2. Control Unreal Editor directly from Claude Code via MCP. Hundreds of tools exposed via Unreal's ToolsetRegistry across 30+ toolsets: actors, blueprints, materials, Niagara, Control Rigs, Sequencer, State Trees, widgets, Gameplay Ability System, automation testing, and more.
  3. ## Contents
  4. ### Skills
  5. - **`unreal-mcp`** (`skills/unreal-mcp`) - instructions and workflows for driving the Unreal Editor via MCP.
  6. ### Hooks
  7. - **SessionStart** (`hooks/unreal-context.sh`) - injects a short note identifying the repo as an Unreal Engine project so Claude defaults to UE conventions (C++/`UObject`, Slate, UHT) and prefers the `unreal-mcp` skill. Runs on `startup`, `resume`, and `clear`.
  8. ## Prerequisites
  9. 1. **Unreal Editor** with the **ModelContextProtocol** and **AllToolsets** plugins enabled (`AllToolsets` provides the tools; the server exposes none without it)
  10. 2. **Editor running to execute tools**, with the MCP server started. Run `ModelContextProtocol.StartServer`, or enable `bAutoStartServer` through `skills/unreal-mcp/references/setup.md`. The optional proxy can keep the client connection open while the editor is stopped.
  11. 3. **A bash shell on `PATH`** - required for the `SessionStart` hook (see **Platform Support**)
  12. ## Platform Support
  13. Supported: **macOS**, **Linux**, and **Windows via Git Bash or WSL**.
  14. The `SessionStart` hook is a bash script (`hooks/unreal-context.sh`) invoked by `hooks/hooks.json` as `bash ${CLAUDE_PLUGIN_ROOT}/hooks/unreal-context.sh`. It requires a working `bash` on `PATH`:
  15. - **macOS / Linux:** works out of the box.
  16. - **Windows:** install **Git for Windows** (provides Git Bash) or run Claude Code under **WSL**. Native PowerShell without one of those does not have `bash` on `PATH`, and the hook will not run. The plugin's MCP tools still work; you just lose the short project-context note the hook injects at session start. There is no separate PowerShell companion script today.
  17. ## Installation
  18. This plugin is published in Anthropic's official Claude Code plugin marketplace, `claude-plugins-official`, which is available automatically when you start Claude Code. Browse it at [claude.com/plugins](https://claude.com/plugins) or in the **Discover** tab of the `/plugin` panel.
  19. ### Install for a single developer
  20. In Claude Code:
  21. ```
  22. /plugin install unreal-engine-skills-for-claude-code@claude-plugins-official
  23. ```
  24. If the official marketplace is not present, add it first, then run the install command above:
  25. ```
  26. /plugin marketplace add anthropics/claude-plugins-official
  27. ```
  28. ### Install for a team
  29. Commit this to `.claude/settings.json` in the project that should use the plugin. Anyone who trusts the project folder is prompted to install it automatically:
  30. ```json
  31. {
  32. "enabledPlugins": {
  33. "unreal-engine-skills-for-claude-code@claude-plugins-official": true
  34. }
  35. }
  36. ```
  37. ## Verification
  38. 1. Launch Unreal Editor, then run `ModelContextProtocol.StartServer` in the console to start the MCP server.
  39. 2. Check the Output Log for MCP server startup messages.
  40. 3. In Claude Code, run `/plugin`. The **Installed** tab should list `unreal-engine-skills-for-claude-code` as enabled. This confirms the plugin itself (skills, hooks) is loaded.
  41. 4. Run `/mcp`. Check for `unreal-mcp`, or `unreal-mcp-proxy` if you installed the proxy. A connected proxy does not prove that Unreal is reachable.
  42. 5. Try: "List all actors in the current level".
  43. ## Configuration
  44. The default port is **8000** with URL path `/mcp`. If the port is in use, run `ModelContextProtocol.StartServer <port>` in the console with a different port number.
  45. > **Note:** This plugin does not ship a static `.mcp.json` file. Run `ModelContextProtocol.GenerateClientConfig ClaudeCode` in the editor console to generate it from the current server port and URL; re-run after changing either.
  46. ### Optional proxy for editor recovery
  47. If your engine build includes `Engine/Plugins/Experimental/ModelContextProtocol/Extras/Proxy`, you can use its `unreal_mcp_proxy` executable.
  48. The proxy keeps the client-facing MCP session open while Unreal is unavailable and reconnects when Unreal starts again. It stores Unreal's native tool catalog as a temporary fallback. Cached tools do not prove that live calls can succeed. Without a cache, it exposes only `unreal_mcp_status` until the client fetches the recovered catalog.
  49. See [proxy setup](skills/unreal-mcp/references/setup.md#4-optional-install-the-proxy) for platform binaries and installation commands. See [proxy recovery](skills/unreal-mcp/references/operations.md#proxy-recovery) for status, cached catalogs, and connection failures.
  50. **Tool search** is enabled by default: the MCP server exposes three meta-tools (`list_toolsets`, `describe_toolset`, `call_tool`) instead of the full tool catalog, so Claude discovers toolsets on demand, the prompt cache stays warm, and discovered tools are callable on the same turn through `call_tool`. Toggle with the `bEnableToolSearch` setting in `[/Script/ModelContextProtocolEngine.ModelContextProtocolSettings]`; when disabled, every tool is registered upfront (path used by the hash-mapping commandlet). The model-facing usage contract lives in `skills/unreal-mcp/SKILL.md`.
  51. ## Security
  52. Installing this plugin gives Claude broad, live access to the running Unreal Editor. Treat that access the same way you would treat running arbitrary code from an assistant, because in practice it is.
  53. **Localhost is not a trust boundary.** The MCP server binds to `localhost:8000` with origin validation. Origin validation protects against a browser tab talking to the server, but any process running as the same user on the same machine can connect. Do not run the MCP server on shared or untrusted machines, and do not expose the port outside the loopback interface.
  54. **`ProgrammaticToolset.execute_tool_script` executes arbitrary Python** inside the editor process. That script has full access to every toolset API, the project on disk, the asset database, and editor-privileged functions. Treat every invocation as a privileged operation that can mutate, move, or delete project content, and expect it to succeed without a second confirmation when approvals are disabled.
  55. **`--dangerously-skip-permissions` removes the per-tool approval gate.** In that mode Claude can drive the editor and run Python through `execute_tool_script` with no further consent. A bad prompt in that mode can reach into the project and modify a large amount of state before you notice. Prefer not to run Claude Code with `--dangerously-skip-permissions` while this plugin is loaded; if you do, keep the blast radius small (narrow prompts, read-heavy tasks, a throwaway sandbox project).
  56. **Source-control hygiene.** MCP tools edit live `UObject` state and can mutate, move, or delete VCS-tracked assets in a single call. Save and commit (or shelve) before any long MCP-driven session so the working copy is recoverable if Claude produces an unexpected result. Review the diff before submitting.
  57. ## What's Available
  58. All tools are auto-discovered by Claude Code via MCP. No manual configuration needed. Tools cover the full editor surface across these domains:
  59. - **Actors and Scene** - spawn, transform, inspect, and delete actors; manage components and outliner folders
  60. - **Blueprints** - create, edit graphs, add nodes, connect pins, manage variables, compile
  61. - **Assets and Content** - find, load, save, move, duplicate assets; edit Data Tables, Curve Tables, String Tables
  62. - **Materials** - author material graphs, create and configure material instances
  63. - **Meshes and Textures** - inspect/edit static and skeletal meshes, LODs, collisions, Nanite, sockets, bones
  64. - **Animation** - build Control Rigs, inspect State Trees and Behavior Trees
  65. - **Sequencer** - create and edit Level Sequences, keyframe animation, manage cameras, Control Rig integration, FBX import/export
  66. - **VFX** - author Niagara systems and Dataflow graphs
  67. - **UI** - build UMG widget blueprints, automate Slate UI interaction
  68. - **Gameplay** - manage gameplay tags, inspect GAS state, create Game Feature Plugins, edit physics assets
  69. - **Testing** - discover, run, and inspect C++ automation tests with detailed results
  70. - **Editor** - screenshots, camera control, actor/asset selection, content browser, log inspection
  71. - **Scripting** - batch multiple tool calls into a single Python script execution

Version history

  • v3.1.210/28/2026

  • v3.1.110/23/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.