
Unity MCP Server
Gives your AI assistant read access to Unity projects without opening the Editor. Exposes tools to list build scenes, parse assembly definitions, find scripts by type or content, summarize scene hierarchies, inspect prefabs and materials, read input bindings, and pull project settings like player config, quality levels, and physics parameters. Works by reading the filesystem directly, so you can query project structure, dependencies, and asset metadata from Cursor, Claude Desktop, or any MCP client. Useful when you want an LLM to understand your Unity codebase, suggest refactorings across assemblies, audit scene composition, or generate documentation without context‐switching to the Editor.
- GitHub stars
- 7
- tools
- 77
- auth
- Required
- transport
- STDIO
- env var
- 1
- last updated
- Nov 9, 2026
Tools
77 toolsPublic tool metadata for what this MCP can expose to an agent.
get_project_infoPath, Unity version, build scene count, player/product name
Path, Unity version, build scene count, player/product name
No parameter schema in public metadata yet.
list_build_scenesScenes in EditorBuildSettings (build order)
Scenes in EditorBuildSettings (build order)
No parameter schema in public metadata yet.
get_player_settingsProduct name, company, bundle ID, version
Product name, company, bundle ID, version
No parameter schema in public metadata yet.
list_packagesPackages from manifest.json
Packages from manifest.json
No parameter schema in public metadata yet.
get_quality_settingsQuality levels
Quality levels
No parameter schema in public metadata yet.
get_scripting_definesGlobal and per-assembly defines
Global and per-assembly defines
No parameter schema in public metadata yet.
get_physics_settingsPhysics / Physics2D settings
Physics / Physics2D settings
No parameter schema in public metadata yet.
get_graphics_settingsGraphics settings (GraphicsSettings.asset)
Graphics settings (GraphicsSettings.asset)
No parameter schema in public metadata yet.
get_time_settingsTime / fixed timestep (TimeManager.asset)
Time / fixed timestep (TimeManager.asset)
No parameter schema in public metadata yet.
get_build_target_infoActive build target / platform
Active build target / platform
No parameter schema in public metadata yet.
get_feature_set_inferenceInfer Unity 6 feature sets from packages (2D, ECS, AR, etc.)
Infer Unity 6 feature sets from packages (2D, ECS, AR, etc.)
No parameter schema in public metadata yet.
get_project_versionBundle version
Bundle version
No parameter schema in public metadata yet.
get_changelogCHANGELOG contents
CHANGELOG contents
No parameter schema in public metadata yet.
get_audio_settingsAudioManager.asset (global volume, reverb, DSP buffer)
AudioManager.asset (global volume, reverb, DSP buffer)
No parameter schema in public metadata yet.
get_navigation_settingsNavMesh/agent settings from ProjectSettings
NavMesh/agent settings from ProjectSettings
No parameter schema in public metadata yet.
get_xr_settingsXR/VR project settings
XR/VR project settings
No parameter schema in public metadata yet.
get_script_execution_orderScript execution order (MonoManager)
Script execution order (MonoManager)
No parameter schema in public metadata yet.
get_version_control_settingsSerialization mode, visible meta files
Serialization mode, visible meta files
No parameter schema in public metadata yet.
get_layer_collision_matrixLayer collision matrix and layer names
Layer collision matrix and layer names
No parameter schema in public metadata yet.
get_cloud_services_configUnity Cloud / Unity Connect config
Unity Cloud / Unity Connect config
No parameter schema in public metadata yet.
get_package_dependency_graphPackage dependency graph (manifest + lock)
Package dependency graph (manifest + lock)
No parameter schema in public metadata yet.
list_package_samplesSamples folders under Packages
Samples folders under Packages
No parameter schema in public metadata yet.
list_unity_hub_projectsList Unity projects from Unity Hub (no project path required)
List Unity projects from Unity Hub (no project path required)
No parameter schema in public metadata yet.
list_assembliesAssembly definitions with references, platforms
Assembly definitions with references, platforms
No parameter schema in public metadata yet.
get_assembly_for_pathAssembly that contains a given script or folder path
Assembly that contains a given script or folder path
No parameter schema in public metadata yet.
list_scripts_by_assemblyC# script paths in a given assembly (by name or asmdef path)
C# script paths in a given assembly (by name or asmdef path)
No parameter schema in public metadata yet.
list_asmdef_referencesAssembly names that reference a given assembly (reverse deps)
Assembly names that reference a given assembly (reverse deps)
No parameter schema in public metadata yet.
list_scriptsC# scripts (optional folder filter)
C# scripts (optional folder filter)
No parameter schema in public metadata yet.
find_scripts_by_contentBy type/pattern (e.g. MonoBehaviour)
By type/pattern (e.g. MonoBehaviour)
No parameter schema in public metadata yet.
get_assembly_dependency_graphNodes and edges
Nodes and edges
No parameter schema in public metadata yet.
list_editor_scriptsScripts in Editor folders
Scripts in Editor folders
No parameter schema in public metadata yet.
list_visual_scripting_assetsBolt / Unity Visual Scripting .asset files
Bolt / Unity Visual Scripting .asset files
No parameter schema in public metadata yet.
get_script_public_apiParse C# script: class name, base type, public methods/fields
Parse C# script: class name, base type, public methods/fields
No parameter schema in public metadata yet.
list_all_scenesAll .unity files under Assets
All .unity files under Assets
No parameter schema in public metadata yet.
get_scene_summaryRoot GameObjects, component count
Root GameObjects, component count
No parameter schema in public metadata yet.
get_scene_components_by_typeGameObjects in a scene with a component type (e.g. Camera, Light)
GameObjects in a scene with a component type (e.g. Camera, Light)
No parameter schema in public metadata yet.
get_scene_objects_by_tagGameObjects in a scene with a given tag (e.g. Spawn)
GameObjects in a scene with a given tag (e.g. Spawn)
No parameter schema in public metadata yet.
get_all_components_by_typeAll Cameras/Lights/etc. across all scenes
All Cameras/Lights/etc. across all scenes
No parameter schema in public metadata yet.
get_scene_hierarchy_flatFlat list of GameObjects in a scene (name and layer)
Flat list of GameObjects in a scene (name and layer)
No parameter schema in public metadata yet.
get_lighting_scene_infoLighting assets and GI workflow mode for a scene
Lighting assets and GI workflow mode for a scene
No parameter schema in public metadata yet.
list_prefabsPrefabs (optional path prefix)
Prefabs (optional path prefix)
No parameter schema in public metadata yet.
list_prefab_variantsPrefabs that are variants of another prefab
Prefabs that are variants of another prefab
No parameter schema in public metadata yet.
list_prefabs_with_componentPrefabs that contain a component type (e.g. Animator)
Prefabs that contain a component type (e.g. Animator)
No parameter schema in public metadata yet.
get_prefab_summaryPrefab summary: root name, component count, component types
Prefab summary: root name, component count, component types
No parameter schema in public metadata yet.
get_prefab_script_guidsScript GUIDs used by a prefab
Script GUIDs used by a prefab
No parameter schema in public metadata yet.
list_subscenesECS/DOTS .subscene assets
ECS/DOTS .subscene assets
No parameter schema in public metadata yet.
get_asset_folder_treeFolder tree under Assets
Folder tree under Assets
No parameter schema in public metadata yet.
list_assets_by_extensionBy extension (e.g. .png, .fbx)
By extension (e.g. .png, .fbx)
No parameter schema in public metadata yet.
find_referencesAssets referencing a path or GUID
Assets referencing a path or GUID
No parameter schema in public metadata yet.
list_large_assetsFiles over N MB (default 5)
Files over N MB (default 5)
No parameter schema in public metadata yet.
list_video_clipsVideo clip assets (.mp4, .mov, .webm, etc.)
Video clip assets (.mp4, .mov, .webm, etc.)
No parameter schema in public metadata yet.
list_legacy_font_assetsLegacy fonts (.fontsettings, .ttf, .otf) — not TMP
Legacy fonts (.fontsettings, .ttf, .otf) — not TMP
No parameter schema in public metadata yet.
list_render_texturesRenderTexture assets
RenderTexture assets
No parameter schema in public metadata yet.
list_terrain_dataTerrainData and TerrainLayer assets
TerrainData and TerrainLayer assets
No parameter schema in public metadata yet.
list_lighting_settings_assetsLighting-related .asset files
Lighting-related .asset files
No parameter schema in public metadata yet.
search_assets_by_nameSearch Assets (and optionally Packages) by name pattern
Search Assets (and optionally Packages) by name pattern
No parameter schema in public metadata yet.
get_texture_metaTexture .meta (maxSize, dimensions, spriteMode, PPU)
Texture .meta (maxSize, dimensions, spriteMode, PPU)
No parameter schema in public metadata yet.
search_projectCombined search: name pattern, script pattern, and/or referrers of path
Combined search: name pattern, script pattern, and/or referrers of path
No parameter schema in public metadata yet.
get_meta_for_assetRead .meta for any asset path (guid, importer keys)
Read .meta for any asset path (guid, importer keys)
No parameter schema in public metadata yet.
get_broken_asset_refsPrefabs/scenes/materials with any missing GUID reference
Prefabs/scenes/materials with any missing GUID reference
No parameter schema in public metadata yet.
list_scriptable_objects.asset files that are ScriptableObject instances
.asset files that are ScriptableObject instances
No parameter schema in public metadata yet.
list_materialsMaterials (optional folder)
Materials (optional folder)
No parameter schema in public metadata yet.
list_materials_using_shaderMaterials that use a given shader (GUID or path)
Materials that use a given shader (GUID or path)
No parameter schema in public metadata yet.
list_shaders.shader in Assets and Packages
.shader in Assets and Packages
No parameter schema in public metadata yet.
list_shader_graphsShader Graph assets
Shader Graph assets
No parameter schema in public metadata yet.
list_vfx_graphsVFX Graph assets
VFX Graph assets
No parameter schema in public metadata yet.
list_animator_controllers.controller assets
.controller assets
No parameter schema in public metadata yet.
list_animation_clips.anim assets
.anim assets
No parameter schema in public metadata yet.
get_animator_statesState names from a controller
State names from a controller
No parameter schema in public metadata yet.
get_animator_transitionsState names and from/to transitions from a controller
State names and from/to transitions from a controller
No parameter schema in public metadata yet.
list_timeline_playablesTimeline .playable assets
Timeline .playable assets
No parameter schema in public metadata yet.
list_avatar_masksAvatar Mask (.mask) assets
Avatar Mask (.mask) assets
No parameter schema in public metadata yet.
list_animator_override_controllersAnimatorOverrideController assets
AnimatorOverrideController assets
No parameter schema in public metadata yet.
list_sprite_atlasesSprite Atlas assets
Sprite Atlas assets
No parameter schema in public metadata yet.
list_tilemap_assetsTilemap-related assets
Tilemap-related assets
No parameter schema in public metadata yet.
list_sprite_assetsTextures configured as sprites (spriteMode in .meta)
Textures configured as sprites (spriteMode in .meta)
No parameter schema in public metadata yet.
list_render_pipelinesURP/HDRP pipeline assets, volume profiles
URP/HDRP pipeline assets, volume profiles
No parameter schema in public metadata yet.
Sponsors
Configuration
UNITY_PROJECT_PATH*Absolute path to your Unity project root (required)
Readme
Unity MCP Server
MCP server for Unity — Gives AI assistants structured access to your Unity project from any MCP-capable IDE or app. No Unity Editor required.
Your IDE talks to this server; the server reads your Unity project folder and answers with project info, build scenes, scripts, prefabs, and more — so the AI can help without opening the Editor.
Overview
- Editor-free — Reads only from the project filesystem.
- One server, many projects — Set
UNITY_PROJECT_PATHper project in your MCP config. - MCP-native — Works with any client that supports the Model Context Protocol (tools over stdio).
Details
- Repository
- github.com/rachitkumarrastogi/unity-mcp-server
- Category
- Design & Creative
- Package
unity-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active