rachitkumarrastogi avatar

Unity MCP Server

rachitkumarrastogi/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 tools

Public 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.

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).


View the full README on GitHub

Details

Repository
github.com/rachitkumarrastogi/unity-mcp-server
Category
Design & Creative
Package
unity-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Design & Creative MCP servers

View all
1admin978 avatarCanvas Mcpadmin978/canvas-mcpLocal-first MCP server for Canvas LMS. Stdio transport, no third-party broker.4stars
2user0856 avatarSnapRenderuser0856/snaprender-integrationsGive AI agents eyes: screenshot any URL as PNG, JPEG, WebP or PDF, or read it as markdown.0stars
3alexalexalex222 avatarFrontend Design Loop MCPalexalexalex222/frontend-design-loop-mcpDesign-first MCP for coding agents that improves websites with screenshot-grounded iteration.2stars
4erajasekar avatarAI Diagram Makererajasekar/ai-diagram-maker-mcpGenerate software diagrams from natural language, code, ASCII, images, Mermaid.2stars
5philpof102-svg avatarMainstreetphilpof102-svg/mainstreetReputation oracle for AI agents on Base: SAFE/CAUTION/BLOCK + 0-100 score before you pay. x402+MCP2stars
6chrischall avatarCanvas Parent Mcpchrischall/canvas-parent-mcpCanvas LMS (Instructure) for Claude — courses, grades, assignments, planner, files1stars