Your First Tool Call

ClaudeUnreal exposes the hybrid tool surface (13 typed MCP tools + cu CLI for the long tail) through two equivalent terminal modes. Both connect to the same TCP bridge at 127.0.0.1:55557 — pick whichever fits your workflow.

Embedded Terminal

Open Tools → Claude Code Terminal inside the editor. Real-time context bar (selected actors, current level, PIE state) renders next to the prompt. No window switching.

System Terminal

Run claude in your project directory from iTerm, Terminal.app, VS Code, tmux, or any terminal emulator. The plugin auto-writes .mcp.json in the project root so the tools are discovered without manual setup.

Feature comparison

Feature	Embedded	System Terminal
Hot-path MCP tools (13)	✅	✅
cu CLI (long tail)	✅	✅
Viewport screenshots	✅	✅
Blueprint / Actor control	✅	✅
Query selected actors	✅	✅
Real-time context bar	✅	—
Custom terminal setup	—	✅

Verify with ping

Regardless of mode, your first command should be:

ping

Expected response: a JSON success payload including the editor version and current level. If you see a connection error, jump to Troubleshooting.

Note

Once ping succeeds, describe what you want in plain language — “spawn a cube 200 units in front of the camera” or “create a Blueprint called BP_Door with a static mesh and a trigger box”. Claude picks the right tools.