README.md

June 26, 2026 · View on GitHub

🎉 Flopperam has been acquired by Aura!

Flopperam is now part of Aura. For the latest updates to the MCP and what we're building next, head over to tryaura.dev.

Flopperam

Flopperam — Unreal Engine MCP

The most advanced MCP server for Unreal Engine.
Control a live Unreal Editor through natural language from any MCP client.

Unreal Engine YouTube Discord Twitter TikTok

Two Ways to Use Unreal Engine MCP

This repo contains two separate things:

Hosted Flop MCP (Recommended)Open-Source Local MCP (This Repo)
WhatProduction MCP server hosted at agent.flopperam.com/mcpCommunity MCP server you run locally from the Python/ folder
Tools50+ tools across 9 domains — Blueprint authoring, materials, VFX, animation, landscape, AI/BT, cinematics, PCG, and moreBasic toolset — scene manipulation, actor management, world building, and foundational Blueprint operations
Blueprint supportFull lifecycle — batched narrow tools (bp_create, bp_variable, bp_component, bp_nodes, bp_wire, bp_commit), Graph authoring, contract verification, PIE runtime testingFoundational — add_node, connect_nodes, create_variable, create_function with 23+ node types
Unreal pluginFlopAI plugin — installed separately via flopperam.com/unreal-agentUnrealMCP plugin — bundled in this repo under UnrealMCP/
Server instructionsRich per-tool LLM guidance, cross-tool relationship mapping, error recovery patternsBasic tool descriptions
SetupOne URL + API key, no local dependenciesClone repo, Python 3.12+, run server locally
Works withCursor, Claude Code, Windsurf, VS Code Copilot, Cline, any MCP clientSame

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.

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.

1. Get an API key at flopperam.com/account

2. Install the FlopAI Unreal plugin — see flopperam.com/docs (Installation tab)

3. Add the config to your IDE

Cursor — .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "flopperam-unreal": {
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code — run in your terminal:

claude mcp add -H "Authorization: Bearer YOUR_API_KEY" --transport http flopperam-unreal https://agent.flopperam.com/mcp

VS Code / Copilot — .vscode/mcp.json:

{
  "servers": {
    "flopperam-unreal": {
      "type": "http",
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline / Local LLMs (Ollama, LM Studio, etc.):

{
  "mcpServers": {
    "flopperam-unreal": {
      "type": "streamableHttp",
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Verify the server shows as connected in your IDE and start prompting.

Hosted Flop MCP — Full Tool List (50+)

CategoryToolsDescription
Blueprint Authoringbp_create, bp_class, bp_variable, bp_component, bp_graph, bp_nodes, bp_wire, bp_input, bp_commit, bp_author, bp_dry_run, bp_skillsFull Blueprint lifecycle — create Actor/Pawn/Character BPs, add variables/components/events/functions, wire graphs with ~40 node types, compile and verify
Blueprint Inspectionbp_brief, bp_inspect, bp_exportRead-only orientation — 21 targeted query ops, full GraphSpec JSON export
Scene & Levelscene_query, scene_brief, scene_compose, actor_inspect, level_inspect, search_assets, asset_references, project_contextFind actors by class/label/tag with spatial filters, declarative spawn/modify/delete, Content Browser search, dependency graphs
Materials & Shadingmaterial_inspect, material_editCreate materials/instances/functions/Parameter Collections, author expression graphs
VFXniagara_inspect, niagara_edit, niagara_script_edit, chaos_editNiagara particle systems, reusable script modules, Geometry Collection destruction
Animationanimation_inspect, animation_edit, animation_graph_edit, ik_rig_edit, ik_retargetSequences, montages, BlendSpaces, AnimBP graph authoring, IK rigs + retargeting
UMG / Widgetswidget_inspect, widget_editWidget tree inspection + editing, styles, animation, MVVM, event binding
AI & Abilitiesbehavior_tree, gas_edit, tag_registry_editBTs, Blackboards, AI Controllers, EQS, Gameplay Abilities/Effects, Attribute Sets, Gameplay Tags
Landscape & Foliagelandscape_inspect, landscape_edit, foliage_inspect, foliage_editSculpting, semantic terrain features, paint layers, heightmap import/export, foliage scattering
Cinematics & Audiosequencer_edit, metasound_edit, sound_asset_editLevel Sequences with camera cuts, MetaSound procedural audio, SoundCue graphs
Proceduralpcg_graph_editPCG graphs with generators, samplers, filters, mesh spawners
Data Assetsasset_factoryEnums, structs, DataTables, DataAssets, Enhanced Input bundles
Editor & Diagnosticseditor_actions, editor_log, performance_audit, window_capture, cpp_sourceSave/undo/redo, Output Log, perf analysis, viewport screenshots, C++ source + Live Coding
Runtime Verificationpie_test_bp, pie_test_scenePIE test harnesses with 30+ assertion types
Executionpython_execution, unreal_api, skillsArbitrary Python in-editor, 15,000+ API lookups, on-demand workflow docs

Open-Source Local MCP (This Repo)

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.

If you want the full 50+ tool experience, use the Hosted Flop MCP instead.

CategoryToolsDescription
Blueprint Visual Scriptingadd_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_functionBlueprint programming with 23+ node types, variables with full property control, custom functions
Blueprint Analysisread_blueprint_content, analyze_blueprint_graph, get_blueprint_variable_details, get_blueprint_function_detailsInspect Blueprint structure, event graphs, execution flow, variables, and functions
World Buildingcreate_town, construct_house, construct_mansion, create_tower, create_arch, create_staircaseBuild architectural structures and settlements
Epic Structurescreate_castle_fortress, create_suspension_bridge, create_aqueductMassive engineering marvels and medieval fortresses
Level Designcreate_maze, create_pyramid, create_wallGame levels and puzzles
Physics & Materialsspawn_physics_blueprint_actor, set_physics_properties, get_available_materials, apply_material_to_actor, apply_material_to_blueprint, set_mesh_material_colorPhysics simulations and material systems
Blueprint Systemcreate_blueprint, compile_blueprint, add_component_to_blueprint, set_static_mesh_propertiesVisual scripting and custom actor creation
Actor Managementget_actors_in_level, find_actors_by_name, delete_actor, set_actor_transform, get_actor_material_infoScene object control and inspection

Full setup guide: LOCAL_SETUP.md (includes macOS compilation steps)

The Flop Agent — flopperam.com

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.

  • Dynamic workflows — decomposes complex requests into steps and adapts when something goes wrong
  • Unreal-native reasoning — tuned prompts, specialized routing, deep knowledge of UE APIs and Blueprints
  • Full Blueprint creation and editing — create new Blueprints, add variables/components/events/functions, update graph logic, compile and validate
  • World building — creates materials, places actors, builds structures, and verifies as it goes
  • Code execution — executes commands directly inside the editor
  • Multiple AI models — routes to the best model per task (Opus for reasoning, Flash for lookups)
  • Chat inside Unreal — embedded browser panel, no window switching
  • Text/image to 3D — three quality tiers (Good, High Quality, Very High Quality)

Supports Unreal Engine 5.5, 5.6, and 5.7. Full docs at flopperam.com/docs.

Flop AI creating a health system in BP_MyPlayer2 from a natural language prompt Flop AI building a full combat system in BP_Combat99 with health, armor, stamina, combo, and more

See It In Action

Watch our comprehensive tutorial for complete setup and usage:

Check out these examples on our channel:

Architecture

Hosted Flop MCP

graph TB
    A[AI Client<br/>Cursor / Claude Code / Windsurf / Cline] -->|MCP Protocol<br/>Streamable HTTP| B[Flop MCP Server<br/>agent.flopperam.com/mcp]
    B -->|WebSocket| C[FlopAI Plugin<br/>C++ / Python Bridge]
    C -->|Native API| D[Unreal Engine 5.5+<br/>Editor & Runtime]
    
    B --> E[50+ Tools]
    E --> F[Blueprint Authoring]
    E --> G[Scene & Level]
    E --> H[Materials & VFX]
    E --> I[Animation & AI]
    E --> J[Landscape & Foliage]
    E --> K[Cinematics & Audio]

Open-Source Local MCP

graph TB
    A[AI Client<br/>Cursor / Claude / Windsurf] -->|MCP Protocol<br/>stdio| B[Python Server<br/>unreal_mcp_server_advanced.py]
    B -->|TCP Socket| C[UnrealMCP Plugin<br/>C++]
    C -->|Native API| D[Unreal Engine 5.5+<br/>Editor]
    
    B --> E[Tools]
    E --> F[World Building]
    E --> G[Physics & Materials]
    E --> H[Blueprint System]
    E --> I[Actor Management]

Community & Support

Get Help

License

MIT License — Build amazing things freely.