Frequently Asked Questions about UnrealMCP

Q: What is UnrealMCP?

A: UnrealMCP is an unofficial Unreal Engine plugin that allows AI tools to control Unreal Engine programmatically through the Machine Control Protocol (MCP).

Q: What is MCP?

A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. In the context of UnrealMCP, it enables AI models to access and interact with the Unreal Engine environment.

Q: What Unreal Engine versions are supported?

A: UnrealMCP is primarily tested and supported on Unreal Engine 5.3, but it may work on earlier versions (5.0+). Official support is only guaranteed for version 5.3.

Q: What are the system requirements for running UnrealMCP?

A: To run UnrealMCP, you need Unreal Engine 5.3, a C++ development environment configured for Unreal Engine, Python 3.7+, and an MCP-compatible LLM such as Claude for Desktop or Cursor.

Q: What AI assistants are compatible with UnrealMCP?

A: UnrealMCP is compatible with Claude for Desktop and Cursor. Other models might work, but they haven’t been officially tested.

Q: How do I install UnrealMCP?

A: Installation involves cloning or downloading the repository, creating a “Plugins” folder in your Unreal Engine project, copying the plugin files into the folder, running the setup_unreal_mcp.bat script, and enabling the plugin in the Unreal Engine editor.

Q: Is UnrealMCP safe to use?

A: UnrealMCP allows AI agents to directly modify your Unreal Engine project, which comes with risks. Always use source control, make regular backups, test in a separate project first, and review changes before committing them.

Q: What are some example commands I can use with UnrealMCP?

A: Some example commands include “What actors are in the current level?”, “Create a cube at position (0, 0, 100)”, and “List available commands I can use with Unreal Engine”.

Q: How do I configure UnrealMCP for Claude for Desktop?

A: You need to find your Claude for Desktop installation directory, locate the claude_desktop_config.json file, and add an entry for UnrealMCP with the correct path to the run_unreal_mcp.bat script.

Q: How do I configure UnrealMCP for Cursor?

A: Run the setup_cursor_mcp.bat script. If manual configuration is needed, you can modify the settings.json file in the Cursor settings directory and configure UnrealMCP server settings.

Q: What if the AI assistant makes errors with Unreal Python?

A: Claude sometimes makes errors with Unreal Python due to limited examples. Allow it to continue running, and it will often figure things out. Improving this aspect is a priority.

Q: Where can I find the MCP controls in the Unreal Editor?

A: Once the plugin is enabled, you’ll find the MCP controls in the editor toolbar button.

Q: How do I troubleshoot issues with UnrealMCP?

A: Ensure Unreal Engine is running with the MCP plugin. Check logs in Claude for Desktop for stderr output. You can also reach out on the Discord server for support.

Q: How can I contribute to UnrealMCP?

A: Contributions are welcome, but the developer needs time to clean up and organize the codebase first. Stay tuned for updates on how to contribute.

Q: What is UBOS and how does it relate to UnrealMCP?

A: UBOS is a full-stack AI Agent Development Platform that can orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents, enhancing the capabilities of UnrealMCP by enabling multi-agent systems and more complex AI-driven workflows within Unreal Engine.