Cursor

Two Ways to Use Cursor

Cursor supports two connection methods with the plugin:

Method	How It Works	Integrated Chat
ACP	Cursor runs inside the editor's chat panel via `cursor-agent acp`	Yes
MCP (standalone)	Cursor IDE connects to the editor's MCP server directly	No — you work in Cursor's own UI

Option 1: ACP Integration (Embedded in Editor)

Cursor CLI has native ACP support. Install Cursor from the plugin's agent registry, and it will appear in the editor's chat panel.

Prerequisites

Cursor CLI installed (the agent binary, installed via agent login or the Cursor IDE)
Authenticate by running agent login in your terminal before first use

MCP Server Discovery

The plugin passes the Unreal MCP server URL to Cursor via the ACP session/new mcpServers parameter. However, Cursor also reads MCP servers from .cursor/mcp.json in the project directory.

If tools are not appearing, create .cursor/mcp.json in your Unreal project root as a fallback:

{
  "mcpServers": {
    "unreal-editor": {
      "url": "http://localhost:9315/mcp"
    }
  }
}

When Cursor discovers MCP servers (whether via ACP or .cursor/mcp.json), it may ask you to approve them before tools become available. Watch for permission prompts in the editor's chat panel and accept them.

Option 2: MCP (Standalone Cursor IDE)

If you prefer to work in the Cursor IDE directly, connect it to the plugin's MCP server.

Prerequisites

Cursor installed
Unreal Editor running with the plugin enabled

Configuration

Create a file at .cursor/mcp.json in your Unreal project folder:

{
  "mcpServers": {
    "unreal-editor": {
      "url": "http://localhost:9315/mcp"
    }
  }
}

Or for global access (all projects), create ~/.cursor/mcp.json:

C:\Users\<username>\.cursor\mcp.json

~/.cursor/mcp.json

{
  "mcpServers": {
    "unreal-editor": {
      "url": "http://localhost:9315/mcp"
    }
  }
}

Verify Connection

Make sure Unreal Editor is running (the MCP server starts automatically on port 9315)
Restart Cursor or reload the window
In Cursor's chat, check that Unreal Editor tools appear under "Available Tools"

Troubleshooting

Issue	Solution
Tools not showing (ACP)	Create `.cursor/mcp.json` in the project directory. Check for unanswered permission prompts in the chat panel
Tools not showing (MCP)	Ensure Unreal Editor is running before starting Cursor
Connection refused	Check that port 9315 is not blocked by firewall. If you changed the port in settings, update `.cursor/mcp.json` to match
Server not found	Verify the plugin is enabled in your project
Permission prompts blocking	Respond to permission requests in the chat panel, or select "Allow Always"
Tools appear inconsistently	Cursor may need `.cursor/mcp.json` as a fallback — see MCP Server Discovery above

The MCP server runs on http://localhost:9315/mcp by default. You can change the port in Project Settings > Plugins > Agent Integration Kit > Server Port. If the default port is occupied, the plugin scans up to 10 higher ports automatically.

Cursor

On this page