Unity MCP Server

io.github.rachitkumarrastogiPublished by GitHub account rachitkumarrastogiv1.7.0Updated Oct 24, 2026

MCP server for Unity: 130+ tools, Unity 6 skills, AI/ML discovery. No Editor.

VerifiedSTDIODesktop onlyFiles & Storage Developer Tools

Server details

Identifier: io.github.rachitkumarrastogi/unity-mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account rachitkumarrastogi for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.rachitkumarrastogi%2Funity-mcp-server.svg)](https://sourceweft.com/mcp/io.github.rachitkumarrastogi%2Funity-mcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that gives AI assistants read-only access to a Unity project's files, settings, scenes, prefabs, scripts and assets without opening the Unity

What you can do: Inspect project and build configuration: project info, build scenes, player, quality, physics, graphics, audio, XR and version control settings, packages and Unity Hub projects. Explore code and assemblies: list scripts and assembly definitions, find scripts by content, read a script's public API, and trace assembly dependencies and cycles. Survey scenes and prefabs: list scenes, summarize hierarchies, find objects by component or tag, and inspect prefab contents and dependencies. Browse assets and references: search by name or extension, read .meta files, find what references an asset, and detect broken asset or script references. Review content areas such as materials and shaders, animator
When to use it: Useful when an assistant needs to answer questions about an existing Unity project or help with refactoring, audits and release checks without the Unity Editor running. Suited to developers, testers and designers who want project structure, asset references and build readiness surfaced in chat.
Requirements: Runs as a local process over stdio; needs Node.js 18+ and the UNITY_PROJECT_PATH environment variable set to the absolute path of the Unity project root. The server is built from source (npm install and build) and configured in the MCP client's config file.

Before you install

The server reads the project folder, so the assistant can see project files, settings and repository docs; point UNITY_PROJECT_PATH only at projects you are comfortable exposing to the client. It is read-only and does not open the Editor, so it cannot make changes or run builds itself.

Installation

In SourceWeft

Open Unity MCP Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

[npm version] [MCP Registry]

[Cursor / IDE → Unity MCP Server → Unity Project]

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_PATH 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:

Client	Notes
Cursor	Add server to MCP settings; set `UNITY_PROJECT_PATH` in `env`.
Claude Desktop	Add to `claude_desktop_config.json`; same command + env pattern.
Claude Code	MCP support including tools.
VS Code	Use an MCP extension (e.g. GenAI / Copilot MCP); configure server and `UNITY_PROJECT_PATH`.
Windsurf	Add MCP server with command and env.
Continue	Configure MCP server in Continue settings.
Cline	MCP tools and resources.
Other	Any client that supports MCP tools over stdio (e.g. Zed, Roo Code, LibreChat, custom agents).

Configuration is the same everywhere: command = node, args = path to dist/index.js, env = UNITY_PROJECT_PATH = 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	💻 Code & assemblies	🎬 Scenes & prefabs	📁 Assets & references
🎨 Materials & shaders	🎞️ Animation	🖼️ 2D & sprites	✨ Rendering
📝 TextMeshPro & UI	🎮 Input	🏷️ Tags & layers	🌐 Addressables & localization
🔊 Audio	🧪 Testing & docs	🔄 CI & version control	🔌 Integrations
⚡ Speed & productivity	🔍 Meta	🤖 AI & ML

📦 Project & build

Tool	Description	Example prompt to type
`get_project_info`	Path, Unity version, build scene count, player/product name	"What's my project path and Unity version?" · "Show build scene count and player name"
`list_build_scenes`	Scenes in EditorBuildSettings (build order)	"Which scenes are in the build?" · "List build scenes in order"
`get_player_settings`	Product name, company, bundle ID, version	"What are the player settings?" · "Show bundle ID and company name"
`list_packages`	Packages from manifest.json	"List installed Unity packages"
`get_quality_settings`	Quality levels	"What are the quality settings?"
`get_scripting_defines`	Global and per-assembly defines	"Show scripting defines" · "What defines are set per assembly?"
`get_physics_settings`	Physics / Physics2D settings	"What are the physics settings?"
`get_graphics_settings`	Graphics settings (GraphicsSettings.asset)	"Show graphics settings"
`get_time_settings`	Time / fixed timestep (TimeManager.asset)	"What's the fixed timestep?" · "Show time settings"
`get_build_target_info`	Active build target / platform	"What's the current build target?"
`get_feature_set_inference`	Infer Unity 6 feature sets from packages (2D, ECS, AR, etc.)	"What feature sets does this project use?"
`get_project_version`	Bundle version	"What's the bundle version?"
`get_changelog`	CHANGELOG contents	"Show the changelog"
`get_audio_settings`	AudioManager.asset (global volume, reverb, DSP buffer)	"What are the audio settings?"
`get_navigation_settings`	NavMesh/agent settings from ProjectSettings	"Show NavMesh / navigation settings"
`get_xr_settings`	XR/VR project settings	"What XR or VR settings are configured?"
`get_script_execution_order`	Script execution order (MonoManager)	"Show script execution order"
`get_version_control_settings`	Serialization mode, visible meta files	"What's the version control / serialization setup?"
`get_layer_collision_matrix`	Layer collision matrix and layer names	"Show layer collision matrix" · "What layers collide?"
`get_cloud_services_config`	Unity Cloud / Unity Connect config	"Is Unity Cloud configured?"
`get_package_dependency_graph`	Package dependency graph (manifest + lock)	"Show package dependency graph"
`list_package_samples`	Samples folders under Packages	"List package samples"
`list_unity_hub_projects`	List Unity projects from Unity Hub (no project path required)	"List my Unity Hub projects"

💻 Code & assemblies

Tool	Description	Example prompt to type
`list_assemblies`	Assembly definitions with references, platforms	"List assembly definitions"
`get_assembly_for_path`	Assembly that contains a given script or folder path	"Which assembly contains Assets/Scripts/Player.cs?"
`list_scripts_by_assembly`	C# script paths in a given assembly (by name or asmdef path)	"List scripts in Assembly-CSharp" · "What scripts are in MyGame.Runtime?"
`list_asmdef_references`	Assembly names that reference a given assembly (reverse deps)	"Who depends on MyGame.Core?"
`list_scripts`	C# scripts (optional folder filter)	"List all C# scripts" · "Show scripts in Assets/Scripts"
`find_scripts_by_content`	By type/pattern (e.g. MonoBehaviour)	"Find scripts that extend MonoBehaviour"
`get_assembly_dependency_graph`	Nodes and edges	"Show assembly dependency graph"
`list_editor_scripts`	Scripts in Editor folders	"List editor scripts"
`list_visual_scripting_assets`	Bolt / Unity Visual Scripting .asset files	"List Visual Scripting assets"
`get_script_public_api`	Parse C# script: class name, base type, public methods/fields	"What's the public API of PlayerController.cs?"

🎬 Scenes & prefabs

Tool	Description	Example prompt to type
`list_all_scenes`	All .unity files under Assets	"List all scenes"
`get_scene_summary`	Root GameObjects, component count	"Summarize MainMenu.unity" · "What's in this scene?"
`get_scene_components_by_type`	GameObjects in a scene with a component type (e.g. Camera, Light)	"Which GameObjects have a Camera in Game.unity?"
`get_scene_objects_by_tag`	GameObjects in a scene with a given tag (e.g. Spawn)	"Find objects with tag Spawn in this scene"
`get_all_components_by_type`	All Cameras/Lights/etc. across all scenes	"List all Cameras in the project"
`get_scene_hierarchy_flat`	Flat list of GameObjects in a scene (name and layer)	"List all objects in Main.unity with their layers"
`get_lighting_scene_info`	Lighting assets and GI workflow mode for a scene	"What lighting does Main.unity use?"
`list_prefabs`	Prefabs (optional path prefix)	"List all prefabs" · "List prefabs in Assets/Prefabs"
`list_prefab_variants`	Prefabs that are variants of another prefab	"List prefab variants"
`list_prefabs_with_component`	Prefabs that contain a component type (e.g. Animator)	"Which prefabs have an Animator?"
`get_prefab_summary`	Prefab summary: root name, component count, component types	"Summarize Hero.prefab" · "What's in this prefab?"
`get_prefab_script_guids`	Script GUIDs used by a prefab	"What scripts does Hero.prefab use?"
`list_subscenes`	ECS/DOTS .subscene assets	"List subscenes"

📁 Assets & references

Tool	Description	Example prompt to type
`get_asset_folder_tree`	Folder tree under Assets	"Show asset folder tree"
`list_assets_by_extension`	By extension (e.g. .png, .fbx)	"List all .png textures" · "List FBX models"
`find_references`	Assets referencing a path or GUID	"What references this asset?" · "Find what uses Assets/Textures/hero.png"
`list_large_assets`	Files over N MB (default 5)	"List large assets" · "What's over 10 MB?"
`list_video_clips`	Video clip assets (.mp4, .mov, .webm, etc.)	"List video clips"
`list_legacy_font_assets`	Legacy fonts (.fontsettings, .ttf, .otf) — not TMP	"List legacy fonts"
`list_render_textures`	RenderTexture assets	"List render textures"
`list_terrain_data`	TerrainData and TerrainLayer assets	"List terrain data"
`list_lighting_settings_assets`	Lighting-related .asset files	"List lighting settings assets"
`search_assets_by_name`	Search Assets (and optionally Packages) by name pattern	"Search assets named 'hero'"
`get_texture_meta`	Texture .meta (maxSize, dimensions, spriteMode, PPU)	"What's the import settings for hero.png?"
`search_project`	Combined search: name pattern, script pattern, and/or referrers of path	"Search project for X" · "What references this path?"
`get_meta_for_asset`	Read .meta for any asset path (guid, importer keys)	"Show .meta for Assets/Models/character.fbx"
`get_broken_asset_refs`	Prefabs/scenes/materials with any missing GUID reference	"Find broken asset references"
`list_scriptable_objects`	.asset files that are ScriptableObject instances	"List all ScriptableObject assets"

🎨 Materials & shaders

Tool	Description	Example prompt to type
`list_materials`	Materials (optional folder)	"List all materials" · "List materials in Assets/Materials"
`list_materials_using_shader`	Materials that use a given shader (GUID or path)	"Which materials use Standard shader?"
`list_shaders`	.shader in Assets and Packages	"List shaders"
`list_shader_graphs`	Shader Graph assets	"List Shader Graph assets"
`list_vfx_graphs`	VFX Graph assets	"List VFX Graph assets"

🎞️ Animation

Tool	Description	Example prompt to type
`list_animator_controllers`	.controller assets	"List animator controllers"
`list_animation_clips`	.anim assets	"List animation clips"
`get_animator_states`	State names from a controller	"What states are in Player.controller?"
`get_animator_transitions`	State names and from/to transitions from a controller	"Show animator transitions in Player.controller"
`list_timeline_playables`	Timeline .playable assets	"List Timeline playables"
`list_avatar_masks`	Avatar Mask (.mask) assets	"List avatar masks"
`list_animator_override_controllers`	AnimatorOverrideController assets	"List animator override controllers"

🖼️ 2D & sprites

Tool	Description	Example prompt to type
`list_sprite_atlases`	Sprite Atlas assets	"List sprite atlases"
`list_tilemap_assets`	Tilemap-related assets	"List tilemap assets"
`list_sprite_assets`	Textures configured as sprites (spriteMode in .meta)	"List sprite assets"

✨ Rendering

📝 TextMeshPro & UI

Tool	Description	Example prompt to type
`list_tmp_fonts`	TMP/font assets	"List TextMeshPro fonts"
`get_tmp_settings_path`	TMP Settings asset path	"Where is TMP Settings?"
`list_ui_documents`	.uxml and .uss (UI Toolkit)	"List UI Toolkit documents" · "List UXML and USS files"

🎮 Input

Tool	Description	Example prompt to type
`get_input_axes`	InputManager axes	"What's in the Input Manager?" · "Show input axes"
`list_input_action_assets`	New Input System .inputactions	"List Input System action assets"
`get_input_actions_summary`	Action maps and actions from a file	"Summarize Player.inputactions"

🏷️ Tags & layers

🌐 Addressables & localization

🔊 Audio

🧪 Testing & docs

Tool	Description	Example prompt to type
`list_test_assemblies`	Test assembly definitions	"List test assemblies"
`get_repo_docs`	README, CONTRIBUTING, .cursorrules, etc.	"Show repo docs" · "What's in the README?"
`read_agent_docs`	.agents/AGENT.md, optional REPO_UNDERSTANDING.md	"Read agent docs" · "Show AGENT.md"

🔄 CI & version control

Tool	Description	Example prompt to type
`list_ci_configs`	.github/workflows, Jenkinsfile, unity-cloud-build	"List CI configs" · "Show GitHub workflows"
`list_presets`	.preset assets	"List presets"
`get_git_lfs_tracked`	LFS patterns from .gitattributes	"What does Git LFS track?"
`get_plastic_config`	Plastic SCM config	"Show Plastic SCM config"

🔌 Integrations (config discovery only)

Tool	Description	Example prompt to type
`get_playfab_config`	Title ID, config paths	"Is PlayFab configured?"
`list_figma_related_assets`	Figma folder / named assets	"List Figma-related assets"
`get_firebase_config`	GoogleServices path, project ID	"Show Firebase config"
`get_steam_config`	steam_appid.txt, Steamworks path	"Is Steam configured?"
`get_discord_config`	Discord SDK path	"Show Discord config"
`get_fmod_config`	Banks path, bank files	"Show FMOD config"
`get_wwise_config`	Sound banks, project paths	"Show Wwise config"
`list_substance_assets`	.sbsar, .sbs	"List Substance assets"
`list_speedtree_assets`	.spm, .stm	"List SpeedTree assets"
`list_lottie_assets`	Lottie JSON assets	"List Lottie assets"
`get_analytics_or_crash_config`	Sentry, Crashlytics, BugSnag, etc.	"What analytics or crash reporting is set up?"
`get_ads_config`	Unity Ads, AdMob, ironSource presence	"Is ads SDK configured?"
`get_multiplayer_stack`	Netcode / multiplayer packages and scripts	"What multiplayer stack does this use?"
`get_ugs_cloud_stack`	Unity Gaming Services / Cloud Code inventory	"Is UGS or Cloud Code set up?"

🧱 Unity 6 coverage

Tool	Description	Example prompt to type
`list_build_profiles`	Unity 6 Build Profile assets	"List build profiles"
`get_physics_stack`	Unity Physics / Physics Core 2D / classic physics	"Audit the physics stack"
`get_optimization_package_inventory`	Adaptive Performance + Project Auditor	"Is Adaptive Performance installed?"
`get_accessibility_stack`	Accessibility APIs and packages	"Any accessibility APIs in use?"
`list_cinemachine_assets`	Cinemachine cameras and related assets	"List Cinemachine assets"
`get_platform_build_hints`	Android/WebGL PlayerSettings snippets	"Show platform build hints"
`get_render_pipeline_migration_hints`	BIRP vs URP/HDRP migration risk	"Are we still on Built-in RP?"
`get_localization_stack`	Localization package + locale tables	"Audit localization setup"

⚡ Speed & productivity

Tool	Description	Example prompt to type
`get_project_stats`	One-shot stats: scripts, prefabs, scenes, materials, animations, assemblies, packages	"Give me project stats" · "How many prefabs and scenes?"
`get_scene_referenced_assets`	Asset paths referenced by a scene (build size / impact)	"What assets does Main.unity reference?"
`detect_assembly_cycles`	Circular refs in assembly definitions (fix compile errors)	"Detect assembly cycles" · "Any circular assembly refs?"
`find_script_references`	C# files that reference a type/class name (refactoring)	"Find references to PlayerController"
`get_broken_script_refs`	Prefabs/scenes with missing script refs	"Find prefabs with missing script"
`get_prefab_dependencies`	Asset paths referenced by a prefab (impact analysis)	"What does Hero.prefab depend on?"
`get_release_readiness`	One-shot: version, build scenes, packages, broken refs, cycles, large assets	"Is the project release ready?" · "Run release readiness check"
`get_build_size_estimate`	Build size estimate: total size and largest assets from build scenes	"What's the build size?" · "Show largest assets in the build"

🤖 AI & ML

Tool	Description	Example prompt to type
`get_ai_stack_summary`	One-shot AI audit: packages, models, scripts, ML-Agents YAMLs	"What AI does this project use?" · "Run an AI stack audit"
`get_ai_ml_package_inventory`	ML-Agents, Sentis, Barracuda, AI Navigation, Muse, Unity AI	"List AI/ML Unity packages"
`list_ml_model_assets`	`.onnx`, `.nn`, `.pt`, `.tflite`, `.pb` model files	"List ONNX models in the project"
`find_ai_related_scripts`	C# with Sentis, ML-Agents, NavMesh, behavior trees, LLM APIs	"Which scripts use ML-Agents or Sentis?"
`list_ml_agents_training_configs`	ML-Agents trainer YAML configs	"Find ML-Agents training configs"
`list_ai_prompt_or_config_assets`	Prompt/RAG-like JSON or MD under Assets	"Any LLM prompt assets in Assets?"
`list_ai_skills`	Bundled skills by Unity domain (39: scenes, multiplayer, build profiles, …)	"List Unity skills"
`read_ai_skill`	Read skill by id (e.g. `unity-scenes-workflow`, `unity-multiplayer-netcode`)	"Read the unity-ai-audit skill"

🔍 Meta

Tool	Description	Example prompt to type
`search_tools`	Find relevant tools by intent (e.g. find references, missing script). Omit query to list all tools by category.	"What Unity tools do you have?" · "Find tools for references" · "List all tools by category"

Using search_tools — Pass an optional query to filter tools by name, description, or category. Omit query to get the full catalog grouped by category.

Intent	Example query	Tools you get (conceptually)
Find what references an asset	`find references`	`find_references`, `search_project`, …
Fix missing script on prefabs	`missing script`	`get_broken_script_refs`, …
Work with textures	`texture`	`get_texture_meta`, `list_assets_by_extension`, …
List or inspect prefabs	`prefab`	`list_prefabs`, `list_prefabs_with_component`, `get_prefab_dependencies`, …
Scenes and build order	`scene` or `build`	`list_all_scenes`, `list_build_scenes`, `get_scene_summary`, …
C# scripts and APIs	`script` or `assembly`	`list_scripts`, `get_script_public_api`, `find_scripts_by_content`, …
Animation	`animation` or `animator`	`list_animator_controllers`, `list_animation_clips`, …
List everything (no filter)	(omit query)	All tools, grouped by category

All tools read from the project filesystem only.

Real-life examples

Copy-paste these into Claude, Cursor, or any MCP client (with this server configured and UNITY_PROJECT_PATH set). The AI will pick the right tools.

Role	Example prompt
Developer	"Which assembly contains Assets/Scripts/Player.cs?" · "List scripts in MyGame.Runtime" · "Who depends on MyGame.Core?" · "Are there assembly dependency cycles?" · "Run release readiness check"
Tester	"Which scenes are in the build?" · "List assemblies that have test in the name" · "Is the project release ready?" · "What's the build size and largest assets?"
Game developer	"Which prefabs have an Animator?" · "Summarize Hero.prefab" · "Show animator transitions in Player.controller" · "List input action assets"
Game designer	"Which materials use Standard shader?" · "List all ScriptableObject assets" · "Summarize Main.unity" · "What lighting does Main.unity use?" · "List all objects in Main.unity with their layers"

What to type in Claude / Cursor or any other MCP Client

In Claude, Cursor, or any MCP client, ask in natural language; the AI picks the right tool. Use the Example prompt to type column in each tools table above — those are the phrases to type in chat to get that result.

Prerequisites

Node.js 18+
UNITY_PROJECT_PATH — Absolute path to your Unity project root (set in your MCP client)

Installation

bash

git clone https://github.com/rachitkumarrastogi/unity-mcp-server.gitcd unity-mcp-servernpm installnpm run build

git clone https://github.com/rachitkumarrastogi/unity-mcp-server.gitcd unity-mcp-servernpm installnpm run build

The server uses stdio; your MCP client starts it automatically.

Configuration

Example for Cursor (same idea for Claude Desktop, VS Code + MCP, Windsurf, etc.):

json

{  "mcpServers": {    "unity": {      "command": "node",      "args": ["/absolute/path/to/unity-mcp-server/dist/index.js"],      "env": {        "UNITY_PROJECT_PATH": "/absolute/path/to/YourUnityProject"      }    }  }}

{  "mcpServers": {    "unity": {      "command": "node",      "args": ["/absolute/path/to/unity-mcp-server/dist/index.js"],      "env": {        "UNITY_PROJECT_PATH": "/absolute/path/to/YourUnityProject"      }    }  }}

Replace the paths with your actual paths. For Claude Desktop, add an entry under mcpServers in claude_desktop_config.json with the same command, args, and env. For VS Code, use your MCP extension’s config to add the server and UNITY_PROJECT_PATH. Other clients follow the same pattern in their own config files.

Development

Run built: node dist/index.js
Run dev: npm run dev or npx tsx src/index.ts

Integration with Unity Editor

Current workflow: The AI runs inside your IDE (Cursor, VS Code with MCP, Claude Desktop, Windsurf, or another MCP-capable client). This server provides the AI with read-only access to your project (scenes, scripts, settings, and related assets). You run Unity Editor separately to open scenes, enter Play mode, and build. The AI uses the server to inspect the project and to suggest changes, answer questions, and assist with refactoring.
Future compatibility: This server implements the standard MCP protocol over stdio and requires a single environment variable (UNITY_PROJECT_PATH). If Unity Editor gains built-in MCP client support, you could connect it to this server using the same configuration: command node, arguments pointing to dist/index.js, and UNITY_PROJECT_PATH set in the environment. No changes to this codebase would be required.

Security

This repository does not include game code, assets, or secrets. The Unity project path is supplied at runtime by your MCP client. The server is suitable for public and private use.

Documentation

MCP Registry — Discover and install this server from the official registry.
Guides: Quick start · Publish · Tools by role
Skills: Unity-domain agent skills
Changelog: CHANGELOG.md

Source: README.md at commit 33fbb7e

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.7.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Tool	Description	Example prompt to type
`get_addressables_info`	Groups and config path	"What Addressables groups are there?"
`get_localization_tables`	Localization table files	"List localization tables"

Tool	Description	Example prompt to type
`list_audio_clips`	.wav, .mp3, .ogg, .aiff	"List audio clips"
`list_audio_mixers`	Audio Mixer assets	"List audio mixers"