Skip to content
Back to search

unreal-engine-mcp

This MCP is now owned by Aura! Please try out the most intelligent AI agent for Unreal Engine at https://www.tryaura.dev/?utm_source=youtube&utm_medium=video&utm_campaign=flop

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/flopperam--unreal-engine-mcp/badge.svg)](/listings/flopperam--unreal-engine-mcp)

HTML

<a href="/listings/flopperam--unreal-engine-mcp"><img src="/api/listings/flopperam--unreal-engine-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

README.md · README · 235 lines

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

  1. <h1 align="center">🎉 Flopperam has been acquired by <a href="https://www.tryaura.dev/?utm_source=youtube&utm_medium=video&utm_campaign=flop">Aura</a>!</h1>
  2. <p align="center">
  3. Flopperam is now part of Aura. For the latest updates to the MCP and what we're building next, head over to <a href="https://www.tryaura.dev/?utm_source=youtube&utm_medium=video&utm_campaign=flop"><strong>tryaura.dev</strong></a>.
  4. </p>
  5. ---
  6. <p align="center">
  7. <img src="assets/logo.png" alt="Flopperam" width="120" />
  8. </p>
  9. <h1 align="center">Flopperam — Unreal Engine MCP</h1>
  10. <p align="center">
  11. <strong>The most advanced MCP server for Unreal Engine.</strong><br/>
  12. Control a live Unreal Editor through natural language from any MCP client.
  13. </p>
  14. <p align="center">
  15. <a href="https://www.unrealengine.com/"><img src="https://img.shields.io/badge/Unreal%20Engine-5.5%2B-orange.svg" alt="Unreal Engine" /></a>
  16. <a href="https://youtube.com/@flopperam"><img src="https://img.shields.io/badge/YouTube-@flopperam-red.svg?logo=youtube" alt="YouTube" /></a>
  17. <a href="https://discord.gg/3KNkke3rnH"><img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2.svg?logo=discord&logoColor=white" alt="Discord" /></a>
  18. <a href="https://twitter.com/Flopperam"><img src="https://img.shields.io/badge/X-@Flopperam-1DA1F2.svg?logo=x&logoColor=white" alt="Twitter" /></a>
  19. <a href="https://tiktok.com/@flopperam"><img src="https://img.shields.io/badge/TikTok-@flopperam-000000.svg?logo=tiktok&logoColor=white" alt="TikTok" /></a>
  20. </p>
  21. ## Two Ways to Use Unreal Engine MCP
  22. This repo contains two separate things:
  23. | | **Hosted Flop MCP** (Recommended) | **Open-Source Local MCP** (This Repo) |
  24. |---|---|---|
  25. | **What** | Production MCP server hosted at `agent.flopperam.com/mcp` | Community MCP server you run locally from the `Python/` folder |
  26. | **Tools** | **50+ tools** across 9 domains — Blueprint authoring, materials, VFX, animation, landscape, AI/BT, cinematics, PCG, and more | Basic toolset — scene manipulation, actor management, world building, and foundational Blueprint operations |
  27. | **Blueprint support** | Full lifecycle — batched narrow tools (`bp_create`, `bp_variable`, `bp_component`, `bp_nodes`, `bp_wire`, `bp_commit`), Graph authoring, contract verification, PIE runtime testing | Foundational — `add_node`, `connect_nodes`, `create_variable`, `create_function` with 23+ node types |
  28. | **Unreal plugin** | **FlopAI plugin** — installed separately via [flopperam.com/unreal-agent](https://www.flopperam.com/unreal-agent) | **UnrealMCP plugin** — bundled in this repo under `UnrealMCP/` |
  29. | **Server instructions** | Rich per-tool LLM guidance, cross-tool relationship mapping, error recovery patterns | Basic tool descriptions |
  30. | **Setup** | One URL + API key, no local dependencies | Clone repo, Python 3.12+, run server locally |
  31. | **Works with** | Cursor, Claude Code, Windsurf, VS Code Copilot, Cline, any MCP client | Same |
  32. > The hosted Flop MCP is a completely different, much more advanced server that shares no code with the local `Python/` server in this repo. It is actively developed with new tools shipping regularly.
  33. ---
  34. ## Hosted Flop MCP (Recommended)
  35. One URL, one API key. No local server, no Python install. Works with **Cursor, Claude Code, Windsurf, VS Code Copilot, Cline**, and any other MCP client.
  36. ### 1. Get an API key at [flopperam.com/account](https://flopperam.com/account)
  37. ### 2. Install the FlopAI Unreal plugin — see [flopperam.com/docs](https://flopperam.com/docs) (Installation tab)
  38. ### 3. Add the config to your IDE
  39. **Cursor** — `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
  40. ```json
  41. {
  42. "mcpServers": {
  43. "flopperam-unreal": {
  44. "url": "https://agent.flopperam.com/mcp",
  45. "headers": {
  46. "Authorization": "Bearer YOUR_API_KEY"
  47. }
  48. }
  49. }
  50. }
  51. ```
  52. **Claude Code** — run in your terminal:
  53. ```bash
  54. claude mcp add -H "Authorization: Bearer YOUR_API_KEY" --transport http flopperam-unreal https://agent.flopperam.com/mcp
  55. ```
  56. **VS Code / Copilot** — `.vscode/mcp.json`:
  57. ```json
  58. {
  59. "servers": {
  60. "flopperam-unreal": {
  61. "type": "http",
  62. "url": "https://agent.flopperam.com/mcp",
  63. "headers": {
  64. "Authorization": "Bearer YOUR_API_KEY"
  65. }
  66. }
  67. }
  68. }
  69. ```
  70. **Cline / Local LLMs** (Ollama, LM Studio, etc.):
  71. ```json
  72. {
  73. "mcpServers": {
  74. "flopperam-unreal": {
  75. "type": "streamableHttp",
  76. "url": "https://agent.flopperam.com/mcp",
  77. "headers": {
  78. "Authorization": "Bearer YOUR_API_KEY"
  79. }
  80. }
  81. }
  82. }
  83. ```
  84. Verify the server shows as connected in your IDE and start prompting.
  85. ### Hosted Flop MCP — Full Tool List (50+)
  86. | **Category** | **Tools** | **Description** |
  87. |---|---|---|
  88. | **Blueprint Authoring** | `bp_create`, `bp_class`, `bp_variable`, `bp_component`, `bp_graph`, `bp_nodes`, `bp_wire`, `bp_input`, `bp_commit`, `bp_author`, `bp_dry_run`, `bp_skills` | Full Blueprint lifecycle — create Actor/Pawn/Character BPs, add variables/components/events/functions, wire graphs with ~40 node types, compile and verify |
  89. | **Blueprint Inspection** | `bp_brief`, `bp_inspect`, `bp_export` | Read-only orientation — 21 targeted query ops, full GraphSpec JSON export |
  90. | **Scene & Level** | `scene_query`, `scene_brief`, `scene_compose`, `actor_inspect`, `level_inspect`, `search_assets`, `asset_references`, `project_context` | Find actors by class/label/tag with spatial filters, declarative spawn/modify/delete, Content Browser search, dependency graphs |
  91. | **Materials & Shading** | `material_inspect`, `material_edit` | Create materials/instances/functions/Parameter Collections, author expression graphs |
  92. | **VFX** | `niagara_inspect`, `niagara_edit`, `niagara_script_edit`, `chaos_edit` | Niagara particle systems, reusable script modules, Geometry Collection destruction |
  93. | **Animation** | `animation_inspect`, `animation_edit`, `animation_graph_edit`, `ik_rig_edit`, `ik_retarget` | Sequences, montages, BlendSpaces, AnimBP graph authoring, IK rigs + retargeting |
  94. | **UMG / Widgets** | `widget_inspect`, `widget_edit` | Widget tree inspection + editing, styles, animation, MVVM, event binding |
  95. | **AI & Abilities** | `behavior_tree`, `gas_edit`, `tag_registry_edit` | BTs, Blackboards, AI Controllers, EQS, Gameplay Abilities/Effects, Attribute Sets, Gameplay Tags |
  96. | **Landscape & Foliage** | `landscape_inspect`, `landscape_edit`, `foliage_inspect`, `foliage_edit` | Sculpting, semantic terrain features, paint layers, heightmap import/export, foliage scattering |
  97. | **Cinematics & Audio** | `sequencer_edit`, `metasound_edit`, `sound_asset_edit` | Level Sequences with camera cuts, MetaSound procedural audio, SoundCue graphs |
  98. | **Procedural** | `pcg_graph_edit` | PCG graphs with generators, samplers, filters, mesh spawners |
  99. | **Data Assets** | `asset_factory` | Enums, structs, DataTables, DataAssets, Enhanced Input bundles |
  100. | **Editor & Diagnostics** | `editor_actions`, `editor_log`, `performance_audit`, `window_capture`, `cpp_source` | Save/undo/redo, Output Log, perf analysis, viewport screenshots, C++ source + Live Coding |
  101. | **Runtime Verification** | `pie_test_bp`, `pie_test_scene` | PIE test harnesses with 30+ assertion types |
  102. | **Execution** | `python_execution`, `unreal_api`, `skills` | Arbitrary Python in-editor, 15,000+ API lookups, on-demand workflow docs |
  103. ---
  104. ## Open-Source Local MCP (This Repo)
  105. This repo includes a standalone local MCP server (`Python/`) and a C++ Unreal plugin (`UnrealMCP/`). This is a simpler, community-maintained toolset for basic Unreal Engine control — scene building, actor management, physics, and foundational Blueprint operations.
  106. **If you want the full 50+ tool experience, use the [Hosted Flop MCP](#hosted-flop-mcp-recommended) instead.**
  107. | **Category** | **Tools** | **Description** |
  108. |---|---|---|
  109. | **Blueprint Visual Scripting** | `add_node`, `connect_nodes`, `delete_node`, `set_node_property`, `create_variable`, `set_blueprint_variable_properties`, `create_function`, `add_function_input`, `add_function_output`, `delete_function`, `rename_function` | Blueprint programming with 23+ node types, variables with full property control, custom functions |
  110. | **Blueprint Analysis** | `read_blueprint_content`, `analyze_blueprint_graph`, `get_blueprint_variable_details`, `get_blueprint_function_details` | Inspect Blueprint structure, event graphs, execution flow, variables, and functions |
  111. | **World Building** | `create_town`, `construct_house`, `construct_mansion`, `create_tower`, `create_arch`, `create_staircase` | Build architectural structures and settlements |
  112. | **Epic Structures** | `create_castle_fortress`, `create_suspension_bridge`, `create_aqueduct` | Massive engineering marvels and medieval fortresses |
  113. | **Level Design** | `create_maze`, `create_pyramid`, `create_wall` | Game levels and puzzles |
  114. | **Physics & Materials** | `spawn_physics_blueprint_actor`, `set_physics_properties`, `get_available_materials`, `apply_material_to_actor`, `apply_material_to_blueprint`, `set_mesh_material_color` | Physics simulations and material systems |
  115. | **Blueprint System** | `create_blueprint`, `compile_blueprint`, `add_component_to_blueprint`, `set_static_mesh_properties` | Visual scripting and custom actor creation |
  116. | **Actor Management** | `get_actors_in_level`, `find_actors_by_name`, `delete_actor`, `set_actor_transform`, `get_actor_material_info` | Scene object control and inspection |
  117. **Full setup guide:** [LOCAL_SETUP.md](LOCAL_SETUP.md) (includes macOS compilation steps)
  118. ---
  119. ## The Flop Agent — [flopperam.com](https://flopperam.com/)
  120. The MCP gives your IDE tools. **The Flop Agent** is a fully autonomous AI that lives inside Unreal Engine — it plans multi-step workflows, writes and executes code, recovers from errors, and iterates until the job is done.
  121. - **Dynamic workflows** — decomposes complex requests into steps and adapts when something goes wrong
  122. - **Unreal-native reasoning** — tuned prompts, specialized routing, deep knowledge of UE APIs and Blueprints
  123. - **Full Blueprint creation and editing** — create new Blueprints, add variables/components/events/functions, update graph logic, compile and validate
  124. - **World building** — creates materials, places actors, builds structures, and verifies as it goes
  125. - **Code execution** — executes commands directly inside the editor
  126. - **Multiple AI models** — routes to the best model per task (Opus for reasoning, Flash for lookups)
  127. - **Chat inside Unreal** — embedded browser panel, no window switching
  128. - **Text/image to 3D** — three quality tiers (Good, High Quality, Very High Quality)
  129. Supports Unreal Engine 5.5, 5.6, and 5.7. Full docs at [flopperam.com/docs](https://flopperam.com/docs).
  130. <img width="800" alt="Flop AI creating a health system in BP_MyPlayer2 from a natural language prompt" src="assets/blueprint_modification2.png" />
  131. <img width="800" alt="Flop AI building a full combat system in BP_Combat99 with health, armor, stamina, combo, and more" src="assets/blueprint_modification.png" />
  132. ---
  133. ## See It In Action
  134. Watch our comprehensive tutorial for complete setup and usage:
  135. - **[Complete MCP Tutorial & Installation Guide](https://youtu.be/ct5dNJC-Hx4)** - Full walkthrough of installation, setup, and advanced usage
  136. Check out these examples on our channel:
  137. - **[GPT-5 vs Claude](https://youtube.com/shorts/xgoJ4d3d4-4)** - Claude and GPT-5 go head-to-head building simultaneously
  138. - **[Advanced Metropolis Generation](https://youtube.com/shorts/6WkxCQXbCWk)** - AI generates a full metropolis with 4,000+ objects from a single prompt
  139. - **[Advanced Maze & Mansion Generation](https://youtube.com/shorts/ArExYGpIZwI)** - Claude generates a playable maze and mansion complex
  140. ---
  141. ## Architecture
  142. ### Hosted Flop MCP
  143. ```mermaid
  144. graph TB
  145. A[AI Client<br/>Cursor / Claude Code / Windsurf / Cline] -->|MCP Protocol<br/>Streamable HTTP| B[Flop MCP Server<br/>agent.flopperam.com/mcp]
  146. B -->|WebSocket| C[FlopAI Plugin<br/>C++ / Python Bridge]
  147. C -->|Native API| D[Unreal Engine 5.5+<br/>Editor & Runtime]
  148. B --> E[50+ Tools]
  149. E --> F[Blueprint Authoring]
  150. E --> G[Scene & Level]
  151. E --> H[Materials & VFX]
  152. E --> I[Animation & AI]
  153. E --> J[Landscape & Foliage]
  154. E --> K[Cinematics & Audio]
  155. ```
  156. ### Open-Source Local MCP
  157. ```mermaid
  158. graph TB
  159. A[AI Client<br/>Cursor / Claude / Windsurf] -->|MCP Protocol<br/>stdio| B[Python Server<br/>unreal_mcp_server_advanced.py]
  160. B -->|TCP Socket| C[UnrealMCP Plugin<br/>C++]
  161. C -->|Native API| D[Unreal Engine 5.5+<br/>Editor]
  162. B --> E[Tools]
  163. E --> F[World Building]
  164. E --> G[Physics & Materials]
  165. E --> H[Blueprint System]
  166. E --> I[Actor Management]
  167. ```
  168. ---
  169. ## Community & Support
  170. - **YouTube**: [youtube.com/@flopperam](https://youtube.com/@flopperam) - Tutorials, showcases, and development updates
  171. - **Discord**: [discord.gg/3KNkke3rnH](https://discord.gg/3KNkke3rnH) - Get help, share creations, and discuss
  172. - **Twitter/X**: [twitter.com/Flopperam](https://twitter.com/Flopperam) - Latest news and quick updates
  173. - **TikTok**: [tiktok.com/@flopperam](https://tiktok.com/@flopperam) - Quick tips and amazing builds
  174. - **Docs**: [flopperam.com/docs](https://flopperam.com/docs) - Full documentation
  175. ### Get Help
  176. - **Setup Issues?** Check the [Debugging & Troubleshooting Guide](DEBUGGING.md)
  177. - **Questions?** Ask in our [Discord server](https://discord.gg/3KNkke3rnH) for real-time support
  178. - **Bug reports?** Open an [issue on GitHub](https://github.com/flopperam/unreal-engine-mcp/issues)
  179. - **Feature ideas?** Join the discussion in our community channels
  180. ---
  181. ## License
  182. MIT License — Build amazing things freely.

Ratings and comments

Sign in to rate this skill.

Sign in

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