One install. One server.

Install uefn-mcp. Your agent is connected.

Run one PowerShell command on the Windows box that has UEFN, then paste one line that points at CONNECT.md. The same process drives the editor and calls https://uefnmcp.com/mcp for Verse grounding. Do not add a second MCP server.

uefn-mcp

One PowerShell command on the Windows box that has UEFN. Source: BizaNator/uefn-mcp. Do not add a second MCP server.

Run the installer

If the client repo is private, the script uses gh or git with your existing GitHub login. The installer writes CONNECT.md and does not dump mcpServers JSON unless you pass -VerbosePaste.
PowerShell
```
irm https://uefnmcp.com/install.ps1 | iex
```
Paste this to your agent

One line. The installer writes the full brief to CONNECT.md (and UEFN-MCP-CONNECT.md on the island when the project is known). That file tells the agent to ASK THE HUMAN for the folder that contains the .uefnproject if needed, verify already-written .mcp.json, and run setup.ps1 so Content\Python is armed. One server only. A portal key is not required.
paste to agent
```
Read %LOCALAPPDATA%\uefn-mcp\CONNECT.md and configure UEFN-MCP according to those instructions.
```

CONNECT.md

The brief on disk tells the agent to verify already-written .mcp.json — do not hand-author. HOSTED_MCP_URL defaults to the hosted grounding endpoint. -VerbosePaste still prints the old mcpServers dump.

uefn-mcp

{
  "mcpServers": {
    "uefn-mcp": {
      "command": "node",
      "args": [
        "<path printed by the installer>\\index.js",
        "--stdio"
      ],
      "env": {
        "HOSTED_MCP_URL": "https://uefnmcp.com/mcp",
        "UEFN_PROJECT_PATH": "<absolute project folder — contains the .uefnproject>",
        "UEFN_PROJECT_ROOT": "<absolute Content/Verse or Plugins/<Plugin>/Content/Verse>"
      }
    }
  }
}

Hosted grounding signs in via browser OAuth on first use. Portal keys (uefn_sk_*) are optional — CI and overrides only. CI / override keys.

Advanced

Cloud-only — no UEFN on this machine

When the box has no editor, you can point an agent at the hosted URL with a Bearer key. This path does not spawn, place, screenshot, play, or compile. Do not use it as a second server next to uefn-mcp.

Optional · no editor

Hosted URL + key

Streamable HTTP at https://uefnmcp.com/mcp. Auth: Authorization: Bearer uefn_sk_…. The REST alias https://uefnmcp.com/mcp-api still works for older connectors.

Project .cursor/mcp.json or the global MCP settings — only if you are not running uefn-mcp:

cloud-only

{
  "mcpServers": {
    "uefnmcp": {
      "url": "https://uefnmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer uefn_sk_YOUR_KEY"
      }
    }
  }
}