editor-selection-get

name	editor-selection-get
description	Get information about the current Selection in the Unity Editor — active object, active transform, selected GameObjects, transforms, instance IDs, and asset GUIDs (each enrichment is opt-in). Pair with 'editor-selection-set' to change the selection.

Editor / Selection / Get

Get information about the current Selection in the Unity Editor. Use 'editor-selection-set' tool to set the selection.

Toggles (default off where indicated to keep responses small)

• includeGameObjects (default false) — populate GameObjects[].
• includeTransforms (default false) — populate Transforms[] as ComponentRefs.
• includeInstanceIDs (default false) — populate InstanceIDs[].
• includeAssetGUIDs (default false) — populate AssetGUIDs[] from project-window selection.
• includeActiveObject (default true) — populate ActiveObject as a generic ObjectRef.
• includeActiveTransform (default true) — populate ActiveTransform as a ComponentRef.

ActiveGameObject and ActiveInstanceID are always populated.

How to Call

unity-mcp-cli run-tool editor-selection-get --input '{
  "includeGameObjects": false,
  "includeTransforms": false,
  "includeInstanceIDs": false,
  "includeAssetGUIDs": false,
  "includeActiveObject": false,
  "includeActiveTransform": false
}'

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

unity-mcp-cli run-tool editor-selection-get --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool editor-selection-get --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
includeGameObjects	boolean	No
includeTransforms	boolean	No
includeInstanceIDs	boolean	No
includeAssetGUIDs	boolean	No
includeActiveObject	boolean	No
includeActiveTransform	boolean	No

Input JSON Schema

{
  "type": "object",
  "properties": {
    "includeGameObjects": {
      "type": "boolean"
    },
    "includeTransforms": {
      "type": "boolean"
    },
    "includeInstanceIDs": {
      "type": "boolean"
    },
    "includeAssetGUIDs": {
      "type": "boolean"
    },
    "includeActiveObject": {
      "type": "boolean"
    },
    "includeActiveTransform": {
      "type": "boolean"
    }
  }
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/AIGD.SelectionData"
    }
  },
  "$defs": {
    "AIGD.GameObjectRef-1": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AIGD.GameObjectRef",
        "description": "Find GameObject in opened Prefab or in the active Scene."
      }
    },
    "AIGD.GameObjectRef": {
      "type": "object",
      "properties": {
        "instanceID": {
          "type": "integer"