# unity-mcp | Coplay | Knowledge Base | Instagit

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

GitHub Stars: 12.1k

Repository: https://github.com/CoplayDev/unity-mcp

---

## Articles

### [How to Contribute to the Unity MCP Project: A Complete Developer Guide](/CoplayDev/unity-mcp/how-to-contribute-to-unity-mcp-project)

Learn how to contribute to the Unity MCP project. Fork the CoplayDev/unity-mcp repo, code, test, and submit a pull request to join development.

- Tags: how-to-guide
- Published: 2026-07-07

### [What Is the Licensing for Unity MCP?](/CoplayDev/unity-mcp/what-is-licensing-for-unity-mcp)

Understand the Unity MCP licensing. The MIT License allows free use, modification, and distribution of the software with proper attribution. Learn more.

- Tags: licensing-information
- Published: 2026-07-07

### [How to Manage Build Settings with Unity MCP: A Complete Guide](/CoplayDev/unity-mcp/how-to-manage-build-settings-with-unity-mcp)

Master Unity MCP build settings management. Learn to programmatically read and modify Unity Editor build settings using JSON commands over Model Context Protocol. Automate your builds efficiently.

- Tags: how-to-guide
- Published: 2026-07-07

### [Is Unity MCP Suitable for Mobile Development? A Technical Analysis](/CoplayDev/unity-mcp/is-unity-mcp-suitable-for-mobile-development)

Discover if Unity MCP is suitable for mobile development. Our technical analysis confirms Android & iOS build support with `manage_build` tool, provided Unity Editor has mobile modules.

- Tags: technical-analysis
- Published: 2026-07-07

### [How to Extend Unity MCP Functionality: A Complete Developer Guide](/CoplayDev/unity-mcp/how-to-extend-unity-mcp-functionality)

Discover how to extend Unity MCP functionality with our complete guide. Learn to implement a three-layer architecture using Python, C#, and a transport bridge for seamless integration. Get started today.

- Tags: how-to-guide
- Published: 2026-07-07

### [Unity MCP Compatibility: Supported Unity Versions from 2021.3 LTS to 6.x](/CoplayDev/unity-mcp/what-versions-of-unity-are-compatible-with-unity-mcp)

Discover Unity MCP compatibility explore supported Unity versions from 2021.3 LTS to Unity 6.x. Ensure seamless integration for your projects.

- Tags: compatibility-guide
- Published: 2026-07-07

### [How to Troubleshoot Common Unity MCP Errors: A Complete Guide](/CoplayDev/unity-mcp/how-to-troubleshoot-common-unity-mcp-errors)

Troubleshoot common Unity MCP errors effectively. Learn to inspect ErrorResponse objects for connection, compilation, and API issues with this complete guide from CoplayDev/unity-mcp.

- Tags: how-to-guide
- Published: 2026-07-07

### [Unity MCP Performance Considerations: Optimization Guide for the Model Context Protocol Bridge](/CoplayDev/unity-mcp/performance-considerations-for-unity-mcp)

Optimize Unity MCP performance with this guide. Overcome transport latency, API overhead, and serialization issues for massive speedups using batch execution and connection caching.

- Tags: performance
- Published: 2026-07-07

### [How to Handle Dependencies with Unity MCP: Complete Setup and Detection Guide](/CoplayDev/unity-mcp/how-to-handle-dependencies-with-unity-mcp)

Master Unity MCP dependency handling with our setup and detection guide. Learn how DependencyManager streamlines installations and validation for your projects.

- Tags: how-to-guide
- Published: 2026-07-07

### [Assets/Plugins/UnityMCP/Runtime: The Core Runtime Bridge for Unity MCP](/CoplayDev/unity-mcp/role-of-assets-plugins-unitymcp-runtime)

Discover the core Unity MCP runtime bridge. This essential C# assembly facilitates communication between Unity and Python MCP servers via JSON-RPC, version shims, and type serialization.

- Tags: api-reference
- Published: 2026-07-07

### [How the Unity MCP Editor Script Works: Architecture and Command Flow](/CoplayDev/unity-mcp/how-editor-script-in-unity-mcp-works)

Explore the Unity MCP editor script architecture. Learn how the CommandRegistry processes tools via reflection and handles sync async command invocation for efficient Unity development.

- Tags: architecture
- Published: 2026-07-07

### [How to Debug Unity MCP: A Complete Guide for Python Server and Unity Editor](/CoplayDev/unity-mcp/how-to-debug-unity-mcp)

Debug Unity MCP effectively by inspecting the Python server with debug_request_context and the Unity Editor using McpLog. Get our complete guide now.

- Tags: how-to-guide
- Published: 2026-07-07

### [Where to Find the Main Source Files in Unity MCP: A Complete Guide](/CoplayDev/unity-mcp/where-can-i-find-main-source-files-in-unity-mcp)

Locate Unity MCP main source files easily. Discover Python server code in Server/src/ and Unity Editor package in MCPForUnity/. Your complete guide awaits.

- Tags: how-to-guide
- Published: 2026-07-07

### [How to Customize Unity MCP Features: A Complete Guide to Tool Groups and Extensions](/CoplayDev/unity-mcp/how-to-customize-unity-mcp-features)

Customize Unity MCP features by toggling tool groups via manage_tools or extending with custom Python server tools and C# Unity handlers. Master MCP customization.

- Tags: how-to-guide
- Published: 2026-07-07

### [Unity MCP Configuration Options: Complete Guide to JSON Settings and C# Models](/CoplayDev/unity-mcp/what-are-configuration-options-for-unity-mcp)

Explore Unity MCP configuration options in this complete guide. Learn to manage JSON settings and C# models for seamless server connection and reconnection behavior.

- Tags: deep-dive
- Published: 2026-07-07

### [How to Set Up Unity MCP for a New Project: Complete Setup Guide](/CoplayDev/unity-mcp/how-to-set-up-unity-mcp-for-new-project)

Easily set up Unity MCP for your new project with this complete guide. Connect AI assistants to Unity using a Python server and C# bridge. Follow our step-by-step instructions for a seamless integration.

- Tags: getting-started
- Published: 2026-07-07

### [Unity API Verification Workflow with unity_reflect in MCP: A Complete Guide](/CoplayDev/unity-mcp/unity-api-verification-workflow-with-unity-reflect-in-mcp)

Master the Unity API verification workflow with unity_reflect in MCP. Explore type metadata, member signatures, and extension methods programmatically. Accelerate your development process today.

- Tags: how-to-guide
- Published: 2026-07-06

### [How to Use Unity MCP CLI Commands via the HTTP API](/CoplayDev/unity-mcp/using-unity-mcp-cli-commands-via-http-api)

Automate Unity MCP using HTTP API commands. Learn how to interact with the Unity MCP server language-agnostically via the /mcp endpoint for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-06

### [Unity MCP UnityCompatShims: Cross-Version Unity API Compatibility Layer](/CoplayDev/unity-mcp/unity-mcp-unitycompatshims-for-version-compatibility)

Ensure seamless Model Context Protocol operation across Unity 2021 LTS to Unity 6.x CoreCLR with Unity MCP UnityCompatShims.  Avoid CS0618 warnings and crashes with this compatibility layer.

- Tags: internals
- Published: 2026-07-06

### [How the MCP Server Handles Unity Domain Reload and Script Compilation](/CoplayDev/unity-mcp/how-does-mcp-server-handle-unity-domain-reload-and-script-compilation)

Learn how the MCP server handles Unity domain reloads and script compilation. Discover automatic reconnection, state persistence, and expected disconnect management for a seamless workflow.

- Tags: internals
- Published: 2026-07-06

### [Security Considerations for Remote Unity MCP Server: Authentication, Isolation, and Fail-Closed Design](/CoplayDev/unity-mcp/security-considerations-for-remote-unity-mcp-server)

Secure your remote Unity MCP server with API keys, user isolation, and fail-closed design. Learn essential security practices to prevent unauthorized access and data leaks.

- Tags: best-practices
- Published: 2026-07-06

### [Difference Between MCP Resources and Tools in Unity MCP](/CoplayDev/unity-mcp/difference-between-mcp-resources-and-tools)

Learn the difference between Unity MCP resources and tools. Discover how MCP resources provide read-only Unity state data while MCP tools enable read-write modifications to the Unity editor via distinct decorators and invocatio...

- Tags: deep-dive
- Published: 2026-07-06

### [Targeting Specific Unity Instances by Name, Hash, or Port in MCP](/CoplayDev/unity-mcp/targeting-specific-unity-instances-by-name-hash-or-port-in-mcp)

Target specific Unity instances in MCP by name, hash, or port. Unity instance middleware and registry efficiently resolve your target for seamless development. Learn how to connect precisely.

- Tags: how-to-guide
- Published: 2026-07-06

### [How to Use Paging with MCP manage_scene, manage_gameobject, and manage_asset in Unity](/CoplayDev/unity-mcp/using-paging-with-mcp-manage-scene-manage-gameobject-manage-asset)

Learn to implement paging with Unity MCP's manage_scene, manage_gameobject, and manage_asset tools. Safely handle large datasets using cursor-based pagination for efficient data management.

- Tags: how-to-guide
- Published: 2026-07-06

### [Unity MCP PluginRegistry and PluginHub Architecture: How the Bridge Connects AI Clients to Unity](/CoplayDev/unity-mcp/unity-mcp-pluginregistry-and-pluginhub-architecture)

Explore the Unity MCP PluginRegistry and PluginHub architecture. Discover how this bridge enables seamless bidirectional communication between Python MCP servers and the Unity Editor using JSON commands and reflection.

- Tags: architecture
- Published: 2026-07-06

### [How UnityInstanceMiddleware Enables Session-Based Routing in MCP](/CoplayDev/unity-mcp/how-does-unityinstancemiddleware-enable-session-based-routing-in-mcp)

Learn how UnityInstanceMiddleware enables session-based routing in MCP. It maps client IDs to Unity instance identifiers for isolated, concurrent request routing in multiple Unity Editor sessions.

- Tags: internals
- Published: 2026-07-06

### [Unity MCP WebSocket Hub Session Management Explained](/CoplayDev/unity-mcp/unity-mcp-websocket-hub-session-management-explained)

Unlock Unity MCP WebSocket hub session management. Learn how this CoplayDev repository ensures stable AI assistant connections with registration, keep-alive, and auto-reconnect.

- Tags: deep-dive
- Published: 2026-07-06

### [How to Debug Unity MCP Connection Issues: WebSocket and HTTP Troubleshooting Guide](/CoplayDev/unity-mcp/debugging-unity-mcp-connection-issues)

Troubleshoot Unity MCP connection issues like WebSocket and HTTP errors. Learn to debug invalid endpoints and WebSocket lifecycle mismatches with our guide.

- Tags: how-to-guide
- Published: 2026-07-06

### [How MCP Custom Tool Service Handles Project-Scoped Tools in Unity](/CoplayDev/unity-mcp/how-does-mcp-custom-tool-service-handle-project-scoped-tools)

Discover how MCP custom tool service manages project-scoped tools in Unity. Learn about per-project definitions and visibility scope in the CoplayDev/unity-mcp repository.

- Tags: how-to-guide
- Published: 2026-07-06

### [Enabling and Using Tool Groups in Unity MCP (VFX, Animation, UI, Testing)](/CoplayDev/unity-mcp/enabling-and-using-tool-groups-in-unity-mcp-vfx-animation-ui-testing)

Easily activate Unity MCP tool groups like VFX, Animation, UI, and Testing using the manage tools function. Streamline your workflow and boost productivity today.

- Tags: how-to-guide
- Published: 2026-07-06

### [Unity MCP stdio vs HTTP Transport Modes: Implementation and Configuration Guide](/CoplayDev/unity-mcp/unity-mcp-stdio-vs-http-transport-modes)

Unity MCP stdio vs HTTP transport: discover implementation and configuration for local and remote connections. Master CoplayDev/unity-mcp TransportManager for seamless workflows.

- Tags: how-to-guide
- Published: 2026-07-06

### [How to Configure API Key Authentication for a Remote MCP Server](/CoplayDev/unity-mcp/how-to-configure-api-key-authentication-for-remote-mcp-server)

Learn to configure API key authentication for your remote MCP server. Set http_remote_hosted to True, define your validation endpoint, and secure requests with X-Api-Key header validation.

- Tags: how-to-guide
- Published: 2026-07-06

### [How Multi-Instance Routing Works in Unity MCP: A Complete Technical Guide](/CoplayDev/unity-mcp/how-does-multi-instance-routing-work-in-unity-mcp)

Unlock multi-instance routing in Unity MCP with this technical guide. Discover how session-based middleware and stable keys ensure efficient request routing to the correct Unity editor instance.

- Tags: deep-dive
- Published: 2026-07-06