UniCortex MCP server
Commit Nov 9, 2026Allows AI agents to control the Unity Editor externally through tools for scene manipulation, GameObject management, and editor automation.
Also known as VeyronSakai/UniCortex
- Stars
- 1
- Tools
- 85
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is UniCortex MCP?
UniCortex allows AI agents to control the Unity Editor externally through tools for scene manipulation, GameObject management, and editor automation. It exposes 85 tools, such as ping_editor, enter_play_mode, exit_play_mode.
Summary generated from the project's README
About UniCortex MCP server
UniCortex provides a way for AI agents and developers to control the Unity Editor from outside the application. It functions as an MCP server for agents like Claude Code or as a CLI tool for terminal-based commands. To use it, you must first install the UniCortex Unity package into your project using a Git URL via the Unity Package Manager. The system requires Unity 2022.3 or later and the .NET 10 SDK.
Users can interact with the editor through a wide range of specialized tools. These include commands for scene manipulation, GameObject management, and component property adjustments. The server can also handle editor automation tasks such as entering play mode, managing modal dialogs, running tests, and capturing screenshots of the Scene or Game views. It supports complex operations like modifying animation curves, managing prefabs, and simulating user input through the Unity Input System.
What you can do with it
- 1Automate Scene and Object ManagementAn AI agent can create new scenes, search for specific GameObjects, and modify their hierarchy or properties.
- 2Control Editor Playback and StateDevelopers can use the tools to start play mode, pause execution, or advance the editor frame by frame.
- 3Modify Component and Asset DataThe server allows for the programmatic adjustment of serialized properties on components and ScriptableObjects.
- 4Simulate User Interaction in Play ModeYou can instruct an agent to perform mouse clicks, drags, or keyboard presses to test UI and gameplay.
- 5Capture Visual FeedbackAn AI can take screenshots of the Game or Scene views to verify visual changes in the editor.
Written from the project's README. Every use case is checked against a quote from it.
UniCortex MCP tools 85
Detected from the READMEping_editorenter_play_modeexit_play_modeget_editor_statuspause_editorunpause_editorstep_editorreload_domainundoredosaveget_active_platform
| ping_editor | — | |
| enter_play_mode | — | |
| exit_play_mode | — | |
| get_editor_status | — | |
| pause_editor | — | |
| unpause_editor | — | |
| step_editor | — | |
| reload_domain | — | |
| undo | — | |
| redo | — | |
| save | — | |
| get_active_platform | — |
Show all 85 toolsShow fewer tools
switch_platformget_editor_dialogsclick_editor_dialog_buttoncreate_sceneopen_sceneget_hierarchyfind_game_objectscreate_game_objectdelete_game_objectmodify_game_objectduplicate_game_objectadd_componentremove_componentget_component_propertiesset_component_propertycreate_scriptable_objectget_scriptable_object_propertiesset_scriptable_object_propertycreate_animation_clipget_animation_curvesset_animation_curveremove_animation_curvecreate_prefabinstantiate_prefabopen_prefabclose_prefabrefresh_asset_databaseselect_project_window_assetget_console_logsclear_console_logsrun_testsexecute_menu_itemfocus_scene_viewcapture_scene_viewfocus_game_viewcapture_game_viewget_game_view_sizeget_game_view_size_listset_game_view_sizeadd_game_view_sizeget_game_view_scaleset_game_view_scaleget_play_mode_view_typeset_play_mode_view_typeget_simulator_device_listset_simulator_deviceget_screen_safe_areaget_all_recordersadd_movie_recorderremove_movie_recorderstart_movie_recorderstop_movie_recorderpress_keytype_textclick_mousedrag_mousemove_mouseget_ui_pointer_targetscreate_timelineget_timeline_tracksget_timeline_track_propertiesget_timeline_clip_propertiesadd_timeline_trackremove_timeline_trackbind_timeline_trackadd_timeline_clipremove_timeline_clipmodify_timeline_clipset_timeline_clip_propertyset_timeline_track_propertyplay_timelinestop_timelineevaluate_timeline
| switch_platform | — | |
| get_editor_dialogs | — | |
| click_editor_dialog_button | — | |
| create_scene | — | |
| open_scene | — | |
| get_hierarchy | — | |
| find_game_objects | — | |
| create_game_object | — | |
| delete_game_object | — | |
| modify_game_object | — | |
| duplicate_game_object | — | |
| add_component | — | |
| remove_component | — | |
| get_component_properties | — | |
| set_component_property | — | |
| create_scriptable_object | — | |
| get_scriptable_object_properties | — | |
| set_scriptable_object_property | — | |
| create_animation_clip | — | |
| get_animation_curves | — | |
| set_animation_curve | — | |
| remove_animation_curve | — | |
| create_prefab | — | |
| instantiate_prefab | — | |
| open_prefab | — | |
| close_prefab | — | |
| refresh_asset_database | — | |
| select_project_window_asset | — | |
| get_console_logs | — | |
| clear_console_logs | — | |
| run_tests | — | |
| execute_menu_item | — | |
| focus_scene_view | — | |
| capture_scene_view | — | |
| focus_game_view | — | |
| capture_game_view | — | |
| get_game_view_size | — | |
| get_game_view_size_list | — | |
| set_game_view_size | — | |
| add_game_view_size | — | |
| get_game_view_scale | — | |
| set_game_view_scale | — | |
| get_play_mode_view_type | — | |
| set_play_mode_view_type | — | |
| get_simulator_device_list | — | |
| set_simulator_device | — | |
| get_screen_safe_area | — | |
| get_all_recorders | — | |
| add_movie_recorder | — | |
| remove_movie_recorder | — | |
| start_movie_recorder | — | |
| stop_movie_recorder | — | |
| press_key | — | |
| type_text | — | |
| click_mouse | — | |
| drag_mouse | — | |
| move_mouse | — | |
| get_ui_pointer_targets | — | |
| create_timeline | — | |
| get_timeline_tracks | — | |
| get_timeline_track_properties | — | |
| get_timeline_clip_properties | — | |
| add_timeline_track | — | |
| remove_timeline_track | — | |
| bind_timeline_track | — | |
| add_timeline_clip | — | |
| remove_timeline_clip | — | |
| modify_timeline_clip | — | |
| set_timeline_clip_property | — | |
| set_timeline_track_property | — | |
| play_timeline | — | |
| stop_timeline | — | |
| evaluate_timeline | — |
Configuration
UNICORTEX_CLI_PROJECTUNICORTEX_PROJECT_PATHUNICORTEX_URL
| Name | Description | |
|---|---|---|
| UNICORTEX_CLI_PROJECT | — | |
| UNICORTEX_PROJECT_PATH | — | |
| UNICORTEX_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableveyronsakai/unicortex is public and reachablegithub.com/veyronsakai/unicortex ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/veyronsakai/unicortex ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model85 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubUniCortex
[!CAUTION] This project is still under active development. The API and command structure may change without notice.
A toolkit for controlling Unity Editor externally via REST API, MCP (Model Context Protocol), and CLI.
UniCortex can be used in two ways:
- As an MCP server for AI agents such as Claude Code or Codex CLI
- As a CLI tool for direct terminal-based control
In both cases, you must install the UniCortex Unity package into the target Unity project first.
Requirements
- Unity 2022.3 or later
- .NET 10 SDK (for MCP server and CLI)
Installation
Add via Unity Package Manager using a Git URL:
- Open Package Manager
- Click the
+button - Select "Add package from git URL"
- Enter the following URL:
https://github.com/VeyronSakai/UniCortex.git
Use UniCortex as an MCP Server
Use this mode when you want an MCP client to call Unity operations as tools. The UniCortex Unity package must be installed in the target Unity project.
MCP Server Setup
Add the following MCP server configuration to your MCP client's settings file (e.g., .mcp.json, claude_desktop_config.json, etc.). Refer to your client's documentation for the exact configuration location.
{
"mcpServers": {
"Unity": {
"type": "stdio",
"command": "bash",
"args": ["-c", "dotnet run --project ${UNICORTEX_PROJECT_PATH}/Library/PackageCache/com.veyron-sakai.uni-cortex@*/Tools~/UniCortex.Mcp/"],
"env": {
"UNICORTEX_PROJECT_PATH": "/path/to/your/unity/project"
}
}
}
}
Replace /path/to/your/unity/project with the absolute path of your Unity project. After saving the configuration, restart the client to apply the changes.
The MCP server reads the port number from Library/UniCortex/config.json (written automatically when Unity Editor starts) and connects to the HTTP server.
No pre-build or tool installation is required. The MCP server is built and started automatically via dotnet run.
Alternatively, you can specify the URL directly via the UNICORTEX_URL environment variable (takes priority over UNICORTEX_PROJECT_PATH):
{
"mcpServers": {
"Unity": {
"type": "stdio",
"command": "bash",
"args": ["-c", "dotnet run --project ${UNICORTEX_PROJECT_PATH}/Library/PackageCache/com.veyron-sakai.uni-cortex@*/Tools~/UniCortex.Mcp/"],
"env": {
"UNICORTEX_PROJECT_PATH": "/path/to/your/unity/project",
"UNICORTEX_URL": "http://localhost:12345"
}
}
}
}
Available MCP Tools
The MCP server exposes the following built-in tools.
Editor Control
| Tool | Description |
|---|---|
ping_editor |
Check connectivity with the Unity Editor |
enter_play_mode |
Start Play Mode |
exit_play_mode |
Stop Play Mode |
get_editor_status |
Get the current state of the Unity Editor (play mode, paused) |
pause_editor |
Pause the Unity Editor. Use with step_editor for frame-by-frame control |
unpause_editor |
Unpause the Unity Editor |
step_editor |
Advance the Unity Editor by one frame while paused |
reload_domain |
Request script recompilation (domain reload) |
undo |
Undo the last operation |
redo |
Redo an undone operation |
save |
Save the currently active stage (Scene, Prefab, Timeline, etc.) |
get_active_platform |
Get the active build target platform |
switch_platform |
Switch the active build target platform (reimports assets and recompiles scripts) |
Editor Dialog
| Tool | Description |
|---|---|
get_editor_dialogs |
Get the modal dialogs that the Unity Editor itself shows (e.g. "Saving failed"), not the game's UI, with their title, message, and button labels |
click_editor_dialog_button |
Click a button of an open Editor dialog by its label to close it |
While a modal dialog is open, the Unity Editor cannot answer the other tools. These tools read the dialog with the OS window APIs instead, so they work while the Editor is blocked. They need UNICORTEX_PROJECT_PATH and support macOS and Windows. On macOS, allow the app that runs the MCP server (e.g. your terminal or AI agent app) in System Settings > Privacy & Security > Accessibility.
Scene
| Tool | Description |
|---|---|
create_scene |
Create a new empty scene and save it at the specified asset path |
open_scene |
Open a scene by path |
get_hierarchy |
Get the GameObject hierarchy tree of every loaded scene or the Prefab |
GameObject
| Tool | Description |
|---|---|
find_game_objects |
Search GameObjects in every loaded scene by name or component type, using the Hierarchy window's search syntax |
create_game_object |
Create a new empty GameObject, optionally under a parent at a given sibling index (with RectTransform support for UI) |
delete_game_object |
Delete a GameObject (supports Undo) |
modify_game_object |
Modify name, active state, tag, layer, parent, or sibling order |
duplicate_game_object |
Duplicate a GameObject like the Editor's Duplicate command, keeping prefab instance links (supports Undo) |
Component
| Tool | Description |
|---|---|
add_component |
Add a component to a GameObject |
remove_component |
Remove a component from a GameObject |
get_component_properties |
Get serialized properties of a component |
set_component_property |
Set a serialized property on a component |
Component type arguments are supplied as a fully-qualified type name plus the defining assembly name (e.g. UnityEngine.Rigidbody + UnityEngine.PhysicsModule).
Object reference properties (e.g. PlayableDirector.m_PlayableAsset or a [SerializeField] component field) accept an asset path (Assets/Timelines/Intro.playable), an asset GUID, an instanceId, or null. If the object does not match the field type, a matching component on the GameObject or a matching sub-asset in the same file is assigned instead, and an error is returned when nothing matches.
ScriptableObject
| Tool | Description |
|---|---|
create_scriptable_object |
Create a new ScriptableObject .asset file from a type name |
get_scriptable_object_properties |
Get serialized properties of an existing .asset file |
set_scriptable_object_property |
Set a serialized property on an existing .asset file |
create_scriptable_object takes the ScriptableObject subclass name plus the defining assembly name (e.g. MyNamespace.MyData + Assembly-CSharp). Property paths and value formats match set_component_property.
AnimationClip
| Tool | Description |
|---|---|
create_animation_clip |
Create a new empty AnimationClip .anim file (Loop Time and frame rate configurable) |
get_animation_curves |
Get the settings and all float curves (with keys) of an AnimationClip |
set_animation_curve |
Replace one float curve of an AnimationClip with the given keys (supports Undo) |
remove_animation_curve |
Remove one float curve from an AnimationClip (supports Undo) |
A curve is identified by animatorRelativePath (path relative to the Animator root, e.g. Root/Child), the component type plus its assembly name (e.g. UnityEngine.UI.Image + UnityEngine.UI), and propertyName (e.g. m_Color.a). Each key takes time / value and an optional tangentMode (Free, Auto, ClampedAuto, Linear, Constant).
Prefab
| Tool | Description |
|---|---|
create_prefab |
Save a scene GameObject as a Prefab asset |
instantiate_prefab |
Instantiate a Prefab into the scene |
open_prefab |
Open a Prefab asset in Prefab Mode for editing |
close_prefab |
Close Prefab Mode and return to the main stage |
Asset
| Tool | Description |
|---|---|
refresh_asset_database |
Refresh the Unity Asset Database |
Project Window
| Tool | Description |
|---|---|
select_project_window_asset |
Select an asset in the Project Window, focus the window, and ping it |
Console
| Tool | Description |
|---|---|
get_console_logs |
Get console log entries from the Unity Editor |
clear_console_logs |
Clear all console logs |
Test
| Tool | Description |
|---|---|
run_tests |
Run Unity Test Runner tests and return results |
Menu Item
| Tool | Description |
|---|---|
execute_menu_item |
Execute a Unity Editor menu item by path |
View
| Tool | Description |
|---|---|
focus_scene_view |
Switch focus to the Scene View window |
capture_scene_view |
Capture the Scene View as a PNG image. Works in both Edit Mode and Play Mode, and captures the Prefab contents in Prefab Mode (gizmos and Screen Space - Overlay UI are not included) |
focus_game_view |
Switch focus to the Game View window |
capture_game_view |
Capture the Game View (or the Simulator view) as a PNG at its resolution (Play Mode only), with the device frame in the Simulator view by default, optionally drawing the safe area and cutouts |
get_game_view_size |
Get the current Game View size (width and height in pixels) |
get_game_view_size_list |
Get the list of available Game View sizes (built-in and custom) |
set_game_view_size |
Set the Game View resolution by index from the size list |
add_game_view_size |
Add a fixed resolution to the Game View size list of the current platform without selecting it, and return its index (an existing entry with the same name and size is returned instead) |
get_game_view_scale |
Get the current Game View scale (zoom factor) and its valid range |
set_game_view_scale |
Set the Game View scale (zoom factor); clamped to the valid range |
get_play_mode_view_type |
Get whether the Play Mode window shows the Game view or the Device Simulator view |
set_play_mode_view_type |
Switch the Play Mode window between the Game view and the Device Simulator view |
get_simulator_device_list |
List the devices of the Simulator view with the selected device and rotation |
set_simulator_device |
Select the simulated device and/or its rotation in the Simulator view |
get_screen_safe_area |
Get the screen size, safe area and cutouts (notch) of the Game view or the Simulator view |
Recorder
| Tool | Description |
|---|---|
get_all_recorders |
Get the list of all configured recorders and their settings (requires com.unity.recorder) |
add_movie_recorder |
Add a Movie recorder to the list with name, output path, encoder, quality, audio capture (requires com.unity.recorder) |
remove_movie_recorder |
Remove a Movie recorder from the list by index (requires com.unity.recorder) |
start_movie_recorder |
Start recording with the specified Movie recorder (Play Mode only, requires com.unity.recorder) |
stop_movie_recorder |
Stop recording and save the video file (requires com.unity.recorder) |
Input
| Tool | Description |
|---|---|
press_key |
Press keys via Input System in Play Mode (requires com.unity.inputsystem). Pass several keys for a combination such as Ctrl+S. Use holdDuration to keep them pressed. Does not type text into text fields |
type_text |
Type text (any characters, e.g. Japanese) into the focused text field in Play Mode: uGUI InputField, TMP_InputField or UI Toolkit TextField (requires com.unity.inputsystem) |
click_mouse |
Click (or tap) via Input System in Play Mode (requires com.unity.inputsystem). Accepts either x/y or the instanceId of a UI target (requires com.unity.ugui). Use holdDuration for a long press |
drag_mouse |
Drag (or swipe) from a start to an end over a given time in one call |
move_mouse |
Move the mouse without pressing a button, e.g. for hover |
get_ui_pointer_targets |
List the uGUI objects that can be pressed now in Play Mode, with their rects in Game View coordinates (requires com.unity.ugui) |
Timeline
| Tool | Description |
|---|---|
create_timeline |
Create a new TimelineAsset (.playable file) at the specified asset path (requires com.unity.timeline) |
get_timeline_tracks |
Get an overview of the tracks and clips of a Timeline (types, timing, extrapolation, bindings, AnimationClips) by PlayableDirector or asset path (requires com.unity.timeline) |
get_timeline_track_properties |
Get the serialized properties of a Timeline track (requires com.unity.timeline) |
get_timeline_clip_properties |
Get the serialized properties of a clip's PlayableAsset (requires com.unity.timeline) |
add_timeline_track |
Add a track to a TimelineAsset (requires com.unity.timeline) |
remove_timeline_track |
Remove a track from a TimelineAsset by index (requires com.unity.timeline) |
bind_timeline_track |
Set the binding of a Timeline track on a PlayableDirector (requires com.unity.timeline) |
add_timeline_clip |
Add a default clip to a Timeline track (requires com.unity.timeline) |
remove_timeline_clip |
Remove a clip from a Timeline track by index (requires com.unity.timeline) |
modify_timeline_clip |
Change a clip's start, duration, timeScale, clipIn, ease in/out, and pre/post extrapolation (requires com.unity.timeline) |
set_timeline_clip_property |
Set a serialized property on a clip's PlayableAsset, e.g. its AnimationClip (m_Clip) or the settings of a custom clip (requires com.unity.timeline) |
set_timeline_track_property |
Set a serialized property on a track, e.g. Track Offsets or mute (requires com.unity.timeline) |
play_timeline |
Start playback of a Timeline on a PlayableDirector (requires com.unity.timeline) |
stop_timeline |
Stop playback of a Timeline on a PlayableDirector and reset to the beginning (requires com.unity.timeline) |
evaluate_timeline |
Evaluate a Timeline at the specified time without playing it, e.g. to inspect an intermediate state. Works in Edit Mode (including Prefab Mode) via the Timeline window preview (requires com.unity.timeline) |
Extensions
User-defined extensions in your Unity project are automatically discovered and exposed alongside the built-in tools. See Extension for details.
Use UniCortex as a CLI Tool
Use this mode when you want to control Unity Editor directly from a terminal. As with the MCP server, the UniCortex Unity package must be installed in the target Unity project, and the Unity Editor must be open with the package loaded.
Connection settings
The CLI resolves the Unity Editor endpoint in the following order:
- If
UNICORTEX_URLis set, the CLI connects directly to that URL. - Otherwise, it uses
UNICORTEX_PROJECT_PATHto readLibrary/UniCortex/config.json, which is written when the Unity Editor starts. - If neither is set, the CLI exits with an error.
Choose how to run the CLI
Choose one of the following options depending on how you want to invoke the CLI.
Whichever option you choose, make sure the CLI version matches the UniCortex package version installed in the Unity project. Running via dotnet run --project from Library/PackageCache naturally uses the same package version.
Option 1: Run commands with dotnet run --project
export UNICORTEX_PROJECT_PATH="/path/to/your/unity/project"
export UNICORTEX_CLI_PROJECT=$(echo "${UNICORTEX_PROJECT_PATH}"/Library/PackageCache/com.veyron-sakai.uni-cortex@*/Tools~/UniCortex.Cli)
dotnet run --project "$UNICORTEX_CLI_PROJECT" -- editor ping
dotnet run --project "$UNICORTEX_CLI_PROJECT" -- scene hierarchy
dotnet run --project "$UNICORTEX_CLI_PROJECT" -- game-object find "t:Camera"
dotnet run --project "$UNICORTEX_CLI_PROJECT" -- component property list 1234 UnityEngine.Transform UnityEngine.CoreModule
dotnet run --project "$UNICORTEX_CLI_PROJECT" -- test run --test-mode EditMode
Option 2: Install as a dotnet local tool
Install UniCortex.Cli from NuGet.org as a local tool.
dotnet new tool-manifest
dotnet tool install --local UniCortex.Cli
dotnet tool run unicortex -- editor ping
dotnet tool run unicortex -- scene hierarchy
If the tool is already installed, run dotnet tool update --local UniCortex.Cli instead.
If you share the tool manifest with your team, run dotnet tool restore before the first dotnet tool run ... so the manifest-defined tools are installed locally.
Option 3: Install as a dotnet global tool
Install UniCortex.Cli globally when you want to invoke unicortex directly from your shell.
dotnet tool install --global UniCortex.Cli
unicortex editor ping
unicortex scene hierarchy
If the tool is already installed, run dotnet tool update --global UniCortex.Cli instead.
Argument and output conventions
- Required parameters are positional arguments, for example
scene open Assets/Scenes/Main.unity. - Optional parameters with defaults become named options, for example
game-object modify 1234 --name CameraRig --tag Player. - Boolean options are flags that take no value, for example
game-object modify 1234 --deactivate. - Read/query commands usually print JSON, such as
scene hierarchy,game-object find,component property list, andrecorder all list. - State-changing commands usually print a short status message, such as
editor play,scene open,component add, andtimeline track bind. game-view captureandscene-view capturewrite a PNG file to the path you pass, and recorder commands create media files in the configured output path.
Available CLI Commands
editor
| Command | Description |
|---|---|
editor ping |
Check connectivity with the Unity Editor. |
editor play |
Start Play Mode in the Unity Editor. |
editor stop |
Stop Play Mode in the Unity Editor. |
editor status |
Show the current play/paused state. |
editor pause |
Pause the Unity Editor. |
editor unpause |
Unpause the Unity Editor. |
editor step |
Advance the Unity Editor by one frame while paused. |
editor undo |
Perform Undo. |
editor redo |
Perform Redo. |
editor save |
Save the active stage. |
editor reload-domain |
Request script recompilation. |
editor platform get |
Show the active build target platform. |
editor platform switch <buildTarget> |
Switch the active build target platform (e.g. Android, iOS). |
editor dialog list |
List the modal dialogs open in the Unity Editor with their title, message, and button labels. |
editor dialog click <button> |
Click a button of an open modal dialog by its label (e.g. OK). |
scene
| Command | Description |
|---|---|
scene create |
Create a new empty scene at the specified asset path. |
scene open |
Open a scene by asset path. |
scene hierarchy |
Print the current scene hierarchy as JSON. |
game-object
| Command | Description |
|---|---|
game-object find |
Search GameObjects with the Hierarchy window's search syntax. |
game-object create |
Create a new empty GameObject, optionally under a parent at a given sibling index. |
game-object delete |
Delete a GameObject by instanceId. |
game-object modify |
Rename, reparent, reorder, or change active state, tag, or layer. |
game-object duplicate |
Duplicate a GameObject like the Editor's Duplicate command, keeping prefab instance links. |
component
| Command | Description |
|---|---|
component add |
Add a component to a GameObject. |
component remove |
Remove a component from a GameObject. |
component property list |
Print serialized component properties as JSON. |
component property set |
Set a serialized property by path. |
Component commands accept the fully-qualified component type name plus the defining assembly name (e.g. UnityEngine.Rigidbody UnityEngine.PhysicsModule).
scriptable-object
| Command | Description |
|---|---|
scriptable-object create |
Create a new ScriptableObject .asset file at the specified path. |
scriptable-object property list |
Print serialized properties of an existing .asset file as JSON. |
scriptable-object property set |
Set a serialized property on an existing .asset file by path. |
scriptable-object create accepts the fully-qualified ScriptableObject subclass name plus the defining assembly name (e.g. MyNamespace.MyData Assembly-CSharp).
animation-clip
| Command | Description |
|---|---|
animation-clip create |
Create a new empty AnimationClip .anim file. Supports --loop and --frame-rate. |
animation-clip curve list |
Print the settings and all float curves of an AnimationClip as JSON. |
animation-clip curve set |
Replace one float curve with keys given as a JSON array. Use --animator-relative-path for the path relative to the Animator root. |
animation-clip curve remove |
Remove one float curve. |
prefab
| Command | Description |
|---|---|
prefab create |
Save a scene GameObject as a Prefab asset. |
prefab instantiate |
Instantiate a Prefab into the current scene. |
prefab open |
Open a Prefab in Prefab Mode. |
prefab close |
Close Prefab Mode and return to the main stage. |
test
| Command | Description |
|---|---|
test run |
Run Unity Test Runner tests. Supports filters such as --test-mode, --test-names, --group-names, --category-names, and --assembly-names. |
console
| Command | Description |
|---|---|
console logs |
Read Unity Editor console logs. Fetches every level by default; pass --info, --warning, and/or --error to fetch only those levels (e.g. console logs --error). Add --stack-trace to include stack traces. |
console clear |
Clear Unity Editor console logs. |
asset, project-window, menu
| Command | Description |
|---|---|
asset refresh |
Refresh the Unity Asset Database. |
project-window select |
Select and ping an asset in the Project Window. |
menu execute |
Execute a Unity menu item by path. |
scene-view, game-view, game-view size, game-view scale, game-view view-type, game-view simulator device
| Command | Description |
|---|---|
scene-view focus |
Focus the Scene View window. |
scene-view capture |
Capture the Scene View as a PNG file. Works in Edit Mode and Play Mode, including Prefab Mode. |
game-view focus |
Focus the Game View window. |
game-view capture |
Capture the Game View (or the Simulator view) as a PNG file at its resolution. Play Mode only. In the Simulator view the device frame is drawn by default (--no-device-frame to omit it). --draw-safe-area draws the safe area and cutouts. |
game-view safe-area |
Show the screen size, safe area and cutouts of the Game view or the Simulator view. |
game-view size get |
Show the current Game View size. |
game-view size list |
List available Game View sizes. |
game-view size set |
Set the Game View size by index. |
game-view size add |
Add a fixed resolution (<name> <width> <height>) to the Game View size list without selecting it. |
game-view scale get |
Show the current Game View scale and its valid range. |
game-view scale set |
Set the Game View scale (zoom factor). |
game-view view-type get |
Show whether the Play Mode window shows the Game view or the Simulator view. |
game-view view-type set |
Switch the Play Mode window to GameView or SimulatorView. |
game-view simulator device list |
List the devices of the Simulator view. |
game-view simulator device set |
Select the simulated device (--index) and/or its rotation (--rotation). |
UniCortex MCP questions
What tools does UniCortex MCP provide?
It exposes 85 tools, including ping_editor, enter_play_mode, exit_play_mode, get_editor_status, pause_editor.
How do I install UniCortex in my Unity project?
You can add it via the Unity Package Manager using the specific Git URL provided in the documentation.
Can the MCP server interact with Unity even when a modal dialog is open?
Yes, the tools use OS window APIs to read dialogs, allowing them to function even when the Editor is blocked by a modal window.
Does UniCortex support macOS and Windows?
Yes, the dialog interaction tools support both macOS and Windows, though macOS users may need to grant accessibility permissions.