Skip to main content

Connect your agent

The server speaks MCP over Streamable HTTP at http://127.0.0.1:9321/uea-mcp. Any client that supports HTTP transports works.

Claude Code​

.mcp.json in the project (or claude mcp add --transport http unreal http://127.0.0.1:9321/uea-mcp):

{
  "mcpServers": {
    "unreal": { "type": "http", "url": "http://127.0.0.1:9321/uea-mcp" }
  }
}

Cursor​

.cursor/mcp.json:

{ "mcpServers": { "unreal": { "url": "http://127.0.0.1:9321/uea-mcp" } } }

VS Code (Copilot agent mode)​

.vscode/mcp.json:

{ "servers": { "unreal": { "type": "http", "url": "http://127.0.0.1:9321/uea-mcp" } } }

Codex CLI / Gemini CLI​

Both accept HTTP servers in their MCP config; use the same URL.

Checking the connection​

curl http://127.0.0.1:9321/health

returns the engine version and the number of tools. The repository also ships Tools/uea_smoke.py, which initialises a session, lists the tools and calls edit.ping.

Security​

Only loopback connections are accepted (requests with a non-localhost Origin header are rejected). There is no authentication because the endpoint is never exposed outside the machine; do not port-forward it.