Unity

You can run MCP for Unity as an agent that connects Unity Editor tasks with large language models. This server enables natural language control over Unity workflows, letting you manage assets, scenes, scripts, and editor operations through MCP clients that you trust.

How to use

Start by ensuring you have Unity 2021.3 LTS or newer, Python 3.10 or newer with uv installed, and an MCP client such as Claude, Cursor, Windsurf, or VS Code Copilot. Open Unity and enable the MCP for Unity integration, then start the server to expose an MCP endpoint. From your MCP client, configure the connection and then begin issuing natural language prompts to perform Unity tasks, such as creating objects, editing scripts, or adjusting scene settings.

How to install

Prerequisites you need before installing the MCP server:

• Unity 2021.3 LTS or newer
• Python 3.10+ with uv installed
• An MCP client (for example Claude Desktop, Claude Code, Cursor, Windsurf, or VS Code Copilot)

Install the MCP for Unity package in Unity using one of the following methods. Choose the method that matches your preference for installation and updates.

Additional sections

Manual configuration lets you specify how to run the MCP server locally if auto-discovery is not available. Use the HTTP configuration for straightforward, localhost-based setups, or the stdio configuration for local runtimes driven by a command.

Notes on configuration and security

Two common configuration methods are shown for local testing and development. Ensure the HTTP endpoint is accessible as described, and confirm the stdio command line you use matches the exact runtime you employ to start the server.

Troubleshooting

If you encounter issues connecting the Unity Bridge, verify the MCP status in the Unity window, check that the HTTP server started on the expected port, and ensure the client is configured to connect to the correct URL. Review logs for hints about misconfigurations or missing dependencies.

Available tools

apply_text_edits

Apply textual edits to Unity-related scripts or configuration files.

batch_execute

Execute multiple MCP actions in a batch for speed and efficiency.

create_script

Create a new Unity script file from a prompt.

debug_request_context

Inspect the current request context to aid debugging.

delete_script

Remove an existing script from the project.

execute_custom_tool

Run a custom tool defined in the MCP tool suite.

execute_menu_item

Trigger a Unity editor menu item programmatically.

find_gameobjects

Search for GameObjects matching given criteria.

find_in_file

Search within project files for specific content.

get_sha

Retrieve a SHA or version identifier for assets or scripts.

get_test_job

Run or retrieve results for a test job.

manage_animation

Control and edit animation assets and states.

manage_asset

Handle Unity assets such as imports, updates, and organization.

manage_camera

Configure and adjust cameras, including Cinemachine support.

manage_components

Manage Unity components on GameObjects.

manage_graphics

Tune graphics settings, volumes, post-processing, and rendering features.

manage_editor

Interact with Unity editor preferences and settings.

manage_gameobject

Modify GameObjects, hierarchy, and properties.

manage_material

Create and modify materials and shaders.

manage_prefabs

Work with prefabs, their instances, and hierarchies.

manage_probuilder

Edit ProBuilder meshes and workflows.

manage_scene

Edit scenes, lighting, and scene-wide settings.

manage_script

Edit and manage script code and metadata.

manage_script_capabilities

Inspect or modify script capabilities and references.

manage_scriptable_object

Handle ScriptableObjects and their data.

manage_shader

Edit shader graphs and shader properties.

manage_texture

Manage texture assets and settings.

manage_tools

Toggle and access editor tools and modes.

manage_ui

Adjust Unity UI elements and layouts.

manage_vfx

Control visual effects components and assets.

read_console

Read Unity console output for debugging.

refresh_unity

Refresh or reload Unity project state.

run_tests

Execute project or tool tests to verify behavior.

script_apply_edits

Apply scripted edits to code files.

set_active_instance

Route subsequent commands to a selected Unity instance.

validate_script

Validate script syntax and namespace usage.