Skip to content

AI Agent MCP

This plugin ships a read-only MCP server that lets coding agents (Claude Code, Cursor, Continue, Codex, etc.) look up SDK APIs, Blueprint nodes, Bridge protocol shapes, and known caveats — without guessing.

Install (any MCP host)

Add to your host's .mcp.json (or equivalent):

json
{
  "mcpServers": {
    "unreal-react-bridge": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-plugin>/Resources/MCP",
        "run",
        "unreal_react_bridge_server.py"
      ]
    }
  }
}

Replace <path-to-plugin> with the absolute path to UnrealReactBridge/ (typically <UE-project>/Plugins/UnrealReactBridge).

If you scaffolded with npm create unreal-react-hud, a pre-wired .mcp.json is already in your project root — only the <path-to-plugin> needs filling in.

Tools

ToolPurpose
lookup_sdk(name)React SDK APIs (useUnrealState, UnrealValue, ...)
lookup_bp_node(name)Blueprint nodes / components (Add Web HUD, PushFloat, ...)
lookup_protocol(topic)Bridge Protocol v1 (envelope, handshake, typed payload)
get_known_issue(query)Known caveats (Mac UE 5.7, SDK gotchas, ...)

Resources

  • urb://protocol/v1 — full Bridge Protocol v1 spec
  • urb://reference/react-sdk — all React SDK reference docs
  • urb://reference/bp — all Blueprint reference docs
  • urb://guide/{slug} — individual guide pages
  • urb://examples/{slug} — SDK example projects with code
  • urb://caveats/index — all known issues

Agent can't edit Blueprints

This MCP is read-only by design. If you want an agent that can mutate .uasset files, look at the ClaudeUnreal companion plugin — they're complementary, install both.

Claude Code users

Claude Code also gets a workflow skill (.claude/skills/unreal-react-bridge-dev/) when you check out the plugin repo. It encodes platform footguns (Mac UE 5.7 chat keyboard, Live Coding, ...) so the agent surfaces them proactively without you asking.

Released under the MIT License.