scene-open

name	scene-open
description	Open a Unity scene asset in Single or Additive mode. Returns the post-open list of all opened scenes. Use 'assets-find' to locate the scene asset first.

Scene / Open

Open scene from the project asset file. Use 'assets-find' tool to find the scene asset first.

Inputs

• sceneRef — AssetObjectRef pointing at a SceneAsset. Throws if the asset cannot be resolved or is not a SceneAsset.
• loadSceneMode (default Single):
  • Single — closes the currently opened scenes and opens this one.
  • Additive — keeps the currently opened scenes and opens this one alongside them.

How to Call

unity-mcp-cli run-tool scene-open --input '{
  "sceneRef": "string_value",
  "loadSceneMode": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool scene-open --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool scene-open --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Name	Type	Required	Description
sceneRef	any	Yes	Reference to UnityEngine.Object asset instance. It could be Material, ScriptableObject, Prefab, and any other Asset. Anything located in the Assets and Packages folders.
loadSceneMode	string	No	Open scene mode. Single: closes the current scenes and opens a new one. Additive: keeps the current scene and opens additional one.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "sceneRef": {
      "$ref": "#/$defs/AIGD.AssetObjectRef"
    },
    "loadSceneMode": {
      "type": "string",
      "enum": [
        "Single",
        "Additive",
        "AdditiveWithoutLoading"
      ]
    }
  },
  "$defs": {
    "System.Type": {
      "type": "string"
    },
    "AIGD.AssetObjectRef": {
      "type": "object",
      "properties": {
        "instanceID" 
           
           
        
         
           
           
        
         
           
           
        
         
           
           
        
      
       
        
      
       
    
  
   
    
  

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/AIGD.SceneDataShallow-1"
    }
  },
  "$defs": {
    "AIGD.SceneDataShallow": {
      "type": "object",
      "properties": {
        "Name": {
          "type": "string"
        },
        "IsLoaded": {
          "type": "boolean"
        },
        "IsDirty": {
          "type": "boolean"
        },
        "IsSubScene": {