Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/davidbuenov/dbv-mcp-server/llms.txt

Use this file to discover all available pages before exploring further.

Before running the Unreal MCP Web Client, ensure your environment meets the requirements listed below — covering the Unreal Engine version, operating system, Python runtime, required plugins, and network ports.

​
Unreal Engine

  • Version: 5.8 or later
  • Project type: C++ project (Blueprint-only projects cannot link the additional Build.cs dependencies required by some toolset plugins)
  • The built-in MCP server ships with UE 5.8 — no separate install is needed

​
Operating System

Windows, macOS, and Linux are all supported. The start/stop scripts (start.sh / stop.sh for macOS/Linux, start.cmd / stop.cmd for Windows) handle platform differences automatically.

​
Python

  • Version: Python 3.x — Python 3.12 is recommended for best compatibility with asyncio and type-annotation features used in server.py
  • Confirm Python is on your PATH by running python --version in a terminal

​
Required packages

Install with a single command: 
pip install fastapi uvicorn httpx
PackagePurpose
fastapiASGI web framework that powers the proxy server and REST endpoints
uvicornASGI server that runs the FastAPI application
httpxAsync HTTP client used to forward requests from the proxy to Unreal’s MCP server

​
Optional packages (guide crawling only)

pip install playwright
playwright install chromium
playwright is only required if you want to crawl or update the local conceptual guides knowledge base (scrape_ue_guides.py). The Chromium browser is needed to bypass Cloudflare Bot Management on Epic’s documentation portal. It is not needed for any normal proxy or agent workflow.

​
Required Unreal Engine Plugins

Enable these in your .uproject Plugins array. See the Quickstart for the exact JSON snippet.
Plugin NamePurposeRequired?
ModelContextProtocolStarts the built-in MCP server on port 8000Required
ToolsetRegistryToolset registry subsystem — manages toolset discovery and list_toolsets / describe_toolsetRequired
MCPClientToolsetExposes the core call_tool MCP tool used by all agent callsRequired
PythonScriptPluginEnables Python scripting inside Unreal Engine so RunPython tool calls workRequired
EditorToolsetAdds 100+ editor tools covering viewport, scene, assets, Blueprints, and materialsStrongly recommended
AutomationTestToolsetDiscover and run Unreal automation tests via MCP tool callsOptional
SlateInspectorToolsetUI interaction tools — mouse clicks, widget snapshots, Slate tree inspectionOptional

​
Network Ports

PortServiceNotes
8000Unreal Engine MCP serverOpened automatically when Auto Start Server is enabled
5000Local FastAPI proxy (server.py)Started by start.sh / start.cmd
The proxy must run on localhost. Unreal’s built-in MCP server only accepts connections from localhost or 127.0.0.1 — requests originating from any other address or hostname will be refused. Do not attempt to expose port 8000 on an external network interface.
The MCP server only listens on HTTP (port 8000). Do not attempt HTTPS — it will fail the TLS handshake. Both server.py and bridge.py connect to http://localhost:8000/mcp without TLS, which is the only supported configuration.

​
Web Browser

Any modern browser with ES6+ and SSE support works: Chrome, Edge, Firefox, or Safari. The web client uses Vanilla JavaScript with no compile step — no Node.js or bundler is required.

Build docs developers (and LLMs) love

Get started for freeTalk to us