Unity MCP Server
io.github.rachitkumarrastogi/unity-mcp-server·v1.7.0·5 starsMCP server for Unity: 130+ tools, Unity 6 skills, AI/ML discovery. No Editor.
5 stars142 downloads/wk
Reviews
Write oneNobody has reviewed Unity MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Unity MCP Server tools (100, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
find_referencesFind all assets (scenes, prefabs, materials, etc.) that reference the given asset. Pass asset path (e.g. Assets/Texture.png) or GUID.
find_scripts_by_contentFind C# scripts that contain a type or pattern (e.g. MonoBehaviour, ScriptableObject, or custom). Optionally filter by namespace.
get_addressables_infoGet Addressables groups and config path if the project uses Addressables.
get_ads_configDetect ad SDK presence (Unity Ads, AdMob, ironSource).
get_all_components_by_typeGet all occurrences of a component type across all scenes (scene path + GameObject name).
get_analytics_or_crash_configDetect analytics/crash reporting services (Unity, Sentry, Crashlytics, BugSnag).
get_animator_statesGet state names from an Animator Controller (.controller) file.
get_animator_transitionsGet state names and transitions (from/to) from an Animator Controller.
get_assembly_dependency_graphGet assembly definition dependency graph (nodes and edges).
get_assembly_for_pathGet the assembly (asmdef name and path) that contains the given asset path (script or folder).
get_asset_folder_treeGet a tree of Assets folder (directories and file names). Useful for understanding project layout.
get_audio_settingsGet AudioManager.asset (global volume, reverb, DSP buffer).
get_broken_asset_refsList prefabs, scenes, materials with any missing GUID reference (not only scripts).
get_changelogRead CHANGELOG.md or CHANGELOG if present.
get_cloud_services_configGet Unity Cloud / Unity Connect config if present.
get_discord_configDetect Discord SDK path in Plugins.
get_firebase_configGet Firebase config (GoogleServices path, project ID). No secrets.
get_fmod_configGet FMOD config (banks path, bank files).
get_git_lfs_trackedGet Git LFS patterns from .gitattributes.
get_input_actions_summaryGet action maps and actions from an .inputactions file.
get_input_axesGet input axes from InputManager (name, descriptive name, positive button).
get_layer_collision_matrixGet layer collision matrix and layer names from TagManager/DynamicsManager.
get_lighting_scene_infoGet lighting-related info for a scene: referenced lighting assets and GI workflow mode if present.
get_localization_tablesList localization table files under Assets/Localization if present.
get_meta_for_assetRead .meta for any asset path (guid and key-value pairs).
get_navigation_settingsGet NavMesh/agent settings from ProjectSettings if present.
get_package_dependency_graphGet package dependency graph (nodes and edges from manifest + lock).
get_physics_settingsGet Physics/DynamicsManager or Physics2D settings (key-value).
get_plastic_configGet Plastic SCM config (.plastic, workspace name).
get_player_settingsGet Player/ProjectSettings (product name, company, bundle ID, version, etc.).
get_playfab_configGet PlayFab config (title ID, config paths) from project. No secrets.
get_prefab_script_guidsGet script GUIDs (MonoBehaviour) referenced by a prefab.
get_prefab_summaryGet a short summary of a prefab: root name, component count, and component type names.
get_project_infoGet Unity project info: path, Unity version, build scene count, player/product name.
get_project_versionGet project/bundle version from PlayerSettings.
get_quality_settingsGet QualitySettings (quality levels) from ProjectSettings.
get_repo_docsRead README, CONTRIBUTING, .cursorrules, CODING_STANDARDS, STYLE if present at project root.
get_scene_components_by_typeGet GameObjects in a scene that have a given component type (e.g. Camera, Light).
get_scene_hierarchy_flatGet a flat list of all GameObjects in a scene (name and layer).
get_scene_objects_by_tagGet GameObjects in a scene that have a given tag (e.g. Spawn, Respawn).
get_scene_summaryGet a short summary of a scene: root GameObject names and approximate component count.
get_script_execution_orderwrite actionGet script execution order (MonoManager: script GUID and order).
get_scripting_definesGet global and per-assembly scripting define symbols.
get_steam_configGet Steam config (steam_appid.txt, Steamworks path).
get_tags_and_layersGet Tags and Layers from TagManager.
get_texture_metaGet texture .meta info (maxTextureSize, width/height, spriteMode, spritePixelsToUnits) for a texture path.
get_tmp_settings_pathGet path to TMP Settings asset if present.
get_version_control_settingsGet Unity version control settings (serialization mode, visible meta files).
get_wwise_configGet Wwise config (sound banks, project paths).
get_xr_settingsGet XR/VR project settings (XRSettings.asset).
list_all_scenesList all .unity scene files under Assets (not only build-indexed).
list_animation_clipsList all Animation Clip (.anim) assets.
list_animator_controllersList all Animator Controller (.controller) assets.
list_animator_override_controllersList AnimatorOverrideController .controller assets.
list_asmdef_referencesList assembly names that reference the given assembly (reverse dependencies).
list_assembliesList assembly definitions (.asmdef) with path, name, references, platforms.
list_assets_by_extensionList assets by file extension (e.g. .png, .fbx, .mp3). Optionally under a folder.
list_audio_clipsList audio clip files (.wav, .mp3, .ogg, .aiff) under Assets.
list_audio_mixersList Audio Mixer (.mixer) assets.
list_avatar_masksList Avatar Mask (.mask) assets used by Animator.
list_build_scenesList scenes in EditorBuildSettings (build order) as JSON.
list_ci_configsList CI config files (.github/workflows, Jenkinsfile, unity-cloud-build).
list_editor_scriptsList C# scripts in Editor folders or with Editor in path.
list_figma_related_assetsList assets in Figma folder or with figma in path.
list_input_action_assetsList New Input System .inputactions assets.
list_large_assetsList assets over a size threshold (default 5 MB).
list_legacy_font_assetsList legacy font assets (.fontsettings, .ttf, .otf) — not TMP.
list_lighting_settings_assetsList lighting-related .asset files (LightingSettings, lightmap, etc.).
list_lottie_assetsList Lottie-related JSON assets.
list_materialsList .mat materials; optionally under a folder. Includes shader GUID when readable.
list_materials_using_shaderList material paths that use a given shader (pass shader GUID or asset path).
list_package_samplesList Samples folders or sample paths under Packages.
list_packagesList Unity packages from Packages/manifest.json (and optional packages-lock.json).
list_prefab_variantsList prefabs that are variants of another prefab.
list_prefabsList all .prefab files. Optionally filter by path prefix under Assets.
list_prefabs_with_componentList prefabs that contain a given component type (e.g. Animator, Rigidbody).
list_presetsList .preset assets.
list_render_pipelinesList render pipeline assets and volume profiles (URP/HDRP).
list_render_texturesList RenderTexture (.renderTexture) assets.
list_scriptable_objectsList .asset files that are ScriptableObject instances (data assets).
list_scriptsList all C# scripts under Assets. Optionally filter by folder prefix (e.g. Scripts).
list_scripts_by_assemblyList C# script paths that belong to a given assembly (by name or asmdef path).
list_shader_graphsList Shader Graph (.shadergraph) assets.
list_shadersList all .shader files in Assets and Packages.
list_speedtree_assetsList SpeedTree .spm and .stm assets.
list_sprite_assetsList textures configured as sprites (spriteMode in .meta).
list_sprite_atlasesList Sprite Atlas (.spriteatlas) assets.
list_substance_assetsList Substance .sbsar and .sbs assets.
list_terrain_dataList TerrainData and TerrainLayer .asset files.
list_test_assembliesList assembly definitions that look like test assemblies (path contains test/editor).
list_tilemap_assetsList tilemap-related .asset files.
list_timeline_playablesList Timeline .playable assets.
list_tmp_fontsList TMP/font-related assets.
list_ui_documentsList UI Toolkit .uxml and .uss files.
list_unity_hub_projectsList Unity Hub projects (basenames only by default; set UNITY_MCP_ALLOW_HUB_PATHS=1 for full paths). Does not require UNITY_PROJECT_PATH.
list_vfx_graphsList VFX Graph (.vfx) assets.
list_video_clipsList video clip assets (.mp4, .mov, .webm, .avi, .asf).
read_agent_docsRead .agents/AGENT.md and optionally REPO_UNDERSTANDING.md.
search_assets_by_nameSearch Assets (and optionally Packages) by file or folder name pattern (e.g. Player, *Menu*).
search_projectCombined search: by asset name pattern, script content pattern, and/or referrers of an asset path. Returns assets, scripts, and optionally referrers.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan25 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 50 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Unity MCP Server compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 48,273 servers
- Tools
- 100
- the typical server has 7
- Tools that change things
- 1%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 83% of 28,534 servers
- Downloads a week
- 142
- more than 70% of 11,915 servers with a package
What its tools let an agent do: 99 read · 1 change
Install Unity MCP Server in Claude Code, Cursor or VS Code
Runs npx -y unity-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add unity-mcp-server -- npx -y unity-mcp-server
What the publisher says
From the Unity MCP Server repository's README, as published. We do not edit it. Read it on GitHub
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 UNITYPROJECTPATH per project in your MCP config.
- MCP-native — Works with any client that supports the Model Context Protocol (tools over stdio).
Supported IDEs and clients
This server uses the standard MCP protocol over stdio and exposes tools. Any IDE or app that can run an MCP server and pass environment variables will work. Commonly used clients include:
Configuration is the same everywhere: command = node, args = path to dist/index.js, env = UNITYPROJECTPATH = your Unity project root. See Configuration below for a Cursor example; other clients use the same structure in their own config format.
Tools
Expand a category below to see the tools it includes.
📦 Project & build
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Unity MCP Server: common questions
- Is Unity MCP Server safe?
- Yes, by our scan: it is graded A (88/100). Read the Unity MCP Server safety report
- How do I install Unity MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Unity MCP Server need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Unity MCP Server maintained?
- The last commit was 90 days ago (2026-08-04). The latest release is v1.7.0.
- How does Unity MCP Server compare with other MCP servers?
- safety score 88/100 (higher than 75% of 48,273 servers); tools 100 (the typical server has 7); tools that change things 1% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.