Scene / Create

How to Call

bash
1unity-mcp-cli run-tool scene-create --input '{
2  "path": "string_value",
3  "newSceneSetup": "string_value",
4  "newSceneMode": "string_value"
5}'

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

bash
1unity-mcp-cli run-tool scene-create --input-file args.json

Or pipe via stdin (recommended):

bash
1unity-mcp-cli run-tool scene-create --input-file - <<'EOF'
2{"param": "value"}
3EOF

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

Input JSON Schema

json
1{
2  "type": "object",
3  "properties": {
4    "path": {
5      "type": "string"
6    },
7    "newSceneSetup": {
8      "$ref": "#/$defs/UnityEditor.SceneManagement.NewSceneSetup"
9    },
10    "newSceneMode": {
11      "$ref": "#/$defs/UnityEditor.SceneManagement.NewSceneMode"
12    }
13  },
14  "$defs": {
15    "UnityEditor.SceneManagement.NewSceneSetup": {
16      "type": "string",
17      "enum": [
18        "EmptyScene",
19        "DefaultGameObjects"
20      ]
21    },
22    "UnityEditor.SceneManagement.NewSceneMode": {
23      "type": "string",
24      "enum": [
25        "Single",
26        "Additive"
27      ]
28    }
29  },
30  "required": [
31    "path"
32  ]
33}

Output

Output JSON Schema

json
1{
2  "type": "object",
3  "properties": {
4    "result": {
5      "$ref": "#/$defs/com.IvanMurzak.Unity.MCP.Runtime.Data.SceneDataShallow",
6      "description": "Scene reference. Used to find a Scene."
7    }
8  },
9  "$defs": {
10    "com.IvanMurzak.Unity.MCP.Runtime.Data.SceneDataShallow": {
11      "type": "object",
12      "properties": {
13        "Name": {
14          "type": "string"
15        },
16        "IsLoaded": {
17          "type": "boolean"
18        },
19        "IsDirty": {
20          "type": "boolean"
21        },
22        "IsSubScene": {
23          "type": "boolean"
24        },
25        "IsValidScene": {
26          "type": "boolean",
27          "description": "Whether this is a valid Scene. A Scene may be invalid if, for example, you tried to open a Scene that does not exist. In this case, the Scene returned from EditorSceneManager.OpenScene would return False for IsValid."
28        },
29        "RootCount": {
30          "type": "integer"
31        },
32        "path": {
33          "type": "string",
34          "description": "Path to the Scene within the project. Starts with 'Assets/'"
35        },
36        "buildIndex": {
37          "type": "integer",
38          "description": "Build index of the Scene in the Build Settings."
39        },
40        "instanceID": {
41          "type": "integer",
42          "description": "instanceID of the UnityEngine.Object. If this is '0', then it will be used as 'null'."
43        }
44      },
45      "required": [
46        "IsLoaded",
47        "IsDirty",
48        "IsSubScene",
49        "IsValidScene",
50        "RootCount",
51        "buildIndex",
52        "instanceID"
53      ],
54      "description": "Scene reference. Used to find a Scene."
55    }
56  },
57  "required": [
58    "result"
59  ]
60}