llms.txt Content
# Unity MCP Pro
> 280+ AI-powered tools connecting Claude, Cursor, and AI assistants to the Unity editor via the Model Context Protocol (MCP).
## Overview
Unity MCP Pro is an MCP server + Unity plugin that gives AI assistants real-time access to the Unity editor through a WebSocket connection. The AI can create scenes, manage GameObjects, edit C# scripts, set up physics, configure lighting, animate, build players, manage prefabs, generate terrain, add particles, handle audio, create UI, work with timelines, splines, ECS, netcode, XR, shader graphs, and more — all from a single conversation with full Undo/Redo support.
## Architecture
AI Assistant <--stdio/MCP--> Node.js Server (TypeScript) <--WebSocket:6605--> Unity Editor Plugin (C#)
The Unity plugin runs a WebSocket client inside the editor that connects to the MCP server on 127.0.0.1:6605-6609. The MCP server translates MCP tool calls into editor commands. All mutations go through Unity's Undo system. Features heartbeat monitoring, exponential backoff auto-reconnect, and multi-port scanning.
## 280+ Tools across 52 Categories
- Project (7): project info, project settings, asset tree, asset search, search in files, set project setting, resource preview
- Scene (6): hierarchy, create/open/save scene, play/stop scene
- GameObject (11): add/delete/rename, get/update/add components, set transform, duplicate, move, select, find
- Script (6): list/read/create/edit scripts, attach to GameObjects, compilation errors
- Editor (5): console logs, clear console, refresh AssetDatabase, execute menu item, performance monitors
- Prefab (6): create/instantiate/inspect/apply overrides/revert overrides/unpack
- Material & Shader (6): create material, get/set properties, assign material, list/create shaders
- Physics (6): colliders, rigidbodies, physics layers, collision matrix, raycasts, joints
- Lighting (5): lights, lighting settings, skybox, bake lighting, reflection probes
- Animation (7): animation clips, keyframes,