Skip to main content
Glama

Move, Rename, or Remove Mounted Equipment

modify_equipment
Destructive

Move, rename, or remove mounted devices and sub-modules in an active rack, recalculating cable splines and rerunning validation.

Instructions

Move, rename, or destructively remove an existing mounted device or child sub-module in the active rack, recalculate 3D cable splines, and re-run 5-stage validation. 'instance_id' resolves across top-level devices and carrier sub-modules, and required fields depend on 'action': 'move' updates 'u_position' and 'face' on rackmount gear or 'slot_id' and optional 'parent_carrier_id' across carriers for sub-modules with primary fields taking precedence over 'new_*' aliases, 'rename' updates or clears 'hostname', and 'remove' cascades to child sub-modules plus attached cables and external endpoints when 'remove_connected_cables' is true. Pushes the prior state onto the undo stack and updates rack.yaml atomically, or returns status 'INVALID' without mutating state when 'instance_id' or a target carrier is unknown. Use to update or delete a mounted instance; use mount_equipment to add new hardware, or disconnect_cables to remove cables while keeping devices mounted.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "instance_id": "<instance_id>",
      "action": "<action>"
    },
    "name": "modify_equipment"
  }
}

Input Schema

NameRequiredDescriptionDefault
faceNoNew mounting face ("front" or "rear") when action is "move" on a rackmount device (takes precedence over new_face).
actionYesModification operation: "move" relocates a device, "rename" updates its hostname, and "remove" deletes the device instance.
slot_idNoTarget slot_id inside parent_carrier_id when action is "move" on a child sub-module.
hostnameNoNew logical hostname when action is "rename" (takes precedence over new_hostname).
new_faceNoOptional alias for face when action is "move".
u_positionNoNew 1-indexed U position when action is "move" on a direct rackmount device (takes precedence over new_u_position).
instance_idYesExisting mounted device or child sub-module instance_id to modify.
new_hostnameNoOptional alias for hostname when action is "rename".
new_u_positionNoOptional alias for u_position when action is "move".
parent_carrier_idNoTarget parent carrier instance_id when action is "move" on a child sub-module.
remove_connected_cablesNoWhen action is "remove", whether to automatically disconnect all cables and external endpoints attached to the removed device (default: true).

Output Schema

NameRequiredDescriptionDefault
dataYesEquipment modification result payload.
issuesYesStructured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.
statusYesDeterministic execution outcome: "VALID" when the operation succeeded with 0 validation errors; "INVALID" when precondition or engineering validation errors are present in issues[].
summaryYesConcise human- and agent-readable summary of the tool result and validation status.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changedv0.7.8
    • addedInput schema / properties / hostname / maxLength
      Added value: +160
    • addedInput schema / properties / instance_id / maxLength
      Added value: +100
    • addedInput schema / properties / new_hostname / maxLength
      Added value: +160
    • changedInput schema / properties / new_u_position / maximum
      Previous value: -9007199254740991New value: +60
    • addedInput schema / properties / parent_carrier_id / maxLength
      Added value: +100
    • addedInput schema / properties / slot_id / maxLength
      Added value: +100
    • changedInput schema / properties / u_position / maximum
      Previous value: -9007199254740991New value: +60
  2. Changed12 schema fields changedv0.4.10
    • changedInput schema / properties / action / description
      Previous value: -"Modification operation to apply."New value: +"Modification operation: \"move\" relocates a device, \"rename\" updates its hostname, and \"remove\" deletes the device instance."
    • changedInput schema / properties / face / description
      Previous value: -"New mounting face when moving a rackmount device."New value: +"New mounting face (\"front\" or \"rear\") when action is \"move\" on a rackmount device (takes precedence over new_face)."
    • changedInput schema / properties / hostname / description
      Previous value: -"New hostname when renaming a device."New value: +"New logical hostname when action is \"rename\" (takes precedence over new_hostname)."
    • changedInput schema / properties / instance_id / description
      Previous value: -"Target mounted device or sub-module instance_id."New value: +"Existing mounted device or child sub-module instance_id to modify."
    • changedInput schema / properties / new_face / description
      Previous value: -"Alias for face when moving a rackmount device."New value: +"Optional alias for face when action is \"move\"."
    • changedInput schema / properties / new_hostname / description
      Previous value: -"Alias for hostname when renaming a device."New value: +"Optional alias for hostname when action is \"rename\"."
    • changedInput schema / properties / new_u_position / description
      Previous value: -"Alias for u_position when moving a rackmount device."New value: +"Optional alias for u_position when action is \"move\"."
    • changedInput schema / properties / parent_carrier_id / description
      Previous value: -"Target parent carrier instance_id when moving a sub-module."New value: +"Target parent carrier instance_id when action is \"move\" on a child sub-module."
    • changedInput schema / properties / remove_connected_cables / description
      Previous value: -"Whether to automatically disconnect cables attached to a removed device."New value: +"When action is \"remove\", whether to automatically disconnect all cables and external endpoints attached to the removed device (default: true)."
    • changedInput schema / properties / slot_id / description
      Previous value: -"Target slot_id inside parent_carrier_id when moving a sub-module."New value: +"Target slot_id inside parent_carrier_id when action is \"move\" on a child sub-module."
    • changedInput schema / properties / u_position / description
      Previous value: -"New 1-indexed U position when moving a rackmount device."New value: +"New 1-indexed U position when action is \"move\" on a direct rackmount device (takes precedence over new_u_position)."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "additionalProperties": {},
      +      "description": "Equipment modification result payload.",
      +      "properties": {
      +        "action": {
      +          "description": "Modification operation that was executed.",
      +          "enum": [
      +            "move",
      +            "rename",
      +            "remove"
      +          ],
      +          "type": "string"
      +        },
      +        "instance_id": {
      +          "description": "Target mounted device or sub-module instance_id.",
      +          "type": "string"
      +        },
      +        "removed_cable_ids": {
      +          "description": "Cable IDs automatically disconnected when action is \"remove\".",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "rerouted_cables": {
      +          "description": "Recalculated 3D cable length summaries after moving or removing equipment.",
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "cable_id": {
      +                "description": "Cable connection identifier.",
      +                "type": "string"
      +              },
      +              "raw_arc_length_mm": {
      +                "description": "Recalculated 3D spline arc length in mm.",
      +                "type": "number"
      +              },
      +              "recommended_commercial_mm": {
      +                "description": "Standard commercial cable length bin in mm.",
      +                "type": "number"
      +              },
      +              "required_length_mm": {
      +                "description": "Required cable length with slack in mm.",
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "cable_id",
      +              "raw_arc_length_mm",
      +              "required_length_mm",
      +              "recommended_commercial_mm"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "updated_device": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "propertyNames": {
      +                "type": "string"
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Updated 3D world geometry of the device, or null if removed."
      +        },
      +        "validation": {
      +          "additionalProperties": false,
      +          "description": "Updated 5-stage validation report after the equipment modification.",
      +          "properties": {
      +            "error_count": {
      +              "description": "Total number of blocking ERROR diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "is_valid": {
      +              "description": "True when zero ERROR-level diagnostic issues exist.",
      +              "type": "boolean"
      +            },
      +            "issues": {
      +              "description": "List of all detected ERROR, WARNING, and INFO diagnostic issues.",
      +              "items": {
      +                "additionalProperties": false,
      +                "description": "Single validation finding with deterministic self-correction feedback.",
      +                "properties": {
      +                  "affected_instances": {
      +                    "description": "Device instance IDs involved in this diagnostic issue.",
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "code": {
      +                    "description": "Machine-readable deterministic validation diagnostic code.",
      +                    "enum": [
      +                      "CHASSIS_COLLISION",
      +                      "PLUG_CLEARANCE_COLLISION",
      +                      "FRONT_DOOR_COLLISION",
      +                      "SLOT_DIMENSION_OVERFLOW",
      +                      "SLOT_INCOMPATIBLE",
      +                      "OUT_OF_RACK_BOUNDS",
      +                      "BLUEPRINT_NOT_FOUND",
      +                      "PORT_NOT_FOUND",
      +                      "PORT_ALREADY_OCCUPIED",
      +                      "CONNECTOR_INCOMPATIBLE",
      +                      "SIGNAL_PROTOCOL_INCOMPATIBLE",
      +                      "SPEED_MISMATCH",
      +                      "POE_BUDGET_EXCEEDED",
      +                      "POE_CLASS_EXCEEDED",
      +                      "UPS_OVERLOAD",
      +                      "UNPOWERED_DEVICE",
      +                      "TOP_HEAVY_RACK",
      +                      "NO_FRONT_TO_REAR_PORTAL",
      +                      "THERMAL_AIRFLOW_CONFLICT",
      +                      "THERMAL_HOTSPOT_STACKING",
      +                      "ACOUSTIC_NOISE_HIGH"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "message": {
      +                    "description": "Detailed engineering explanation with exact millimeter/watt figures.",
      +                    "type": "string"
      +                  },
      +                  "remediation_actions": {
      +                    "description": "Optional machine-actionable remediation descriptors.",
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "description": "Structured self-correction action for autonomous agent remediation.",
      +                      "properties": {
      +                        "action_type": {
      +                          "description": "Recommended self-correction operation category.",
      +                          "enum": [
      +                            "move_device",
      +                            "change_cable_type",
      +                            "connect_power",
      +                            "disconnect_cable",
      +                            "redistribute_poe",
      +                            "add_portal_gap",
      +                            "change_rack_depth"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "description": {
      +                          "description": "Human- and agent-readable explanation of the remediation step.",
      +                          "type": "string"
      +                        },
      +                        "suggested_cable_type": {
      +                          "description": "Suggested replacement cable_type (e.g. angled plug or higher speed grade).",
      +                          "type": "string"
      +                        },
      +                        "suggested_face": {
      +                          "description": "Mounting or port face relative to the rack or chassis.",
      +                          "enum": [
      +                            "front",
      +                            "rear"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "suggested_u_positions": {
      +                          "description": "Candidate 1-indexed U positions that resolve the spatial conflict.",
      +                          "items": {
      +                            "exclusiveMinimum": 0,
      +                            "maximum": 9007199254740991,
      +                            "type": "integer"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "target_cable_id": {
      +                          "description": "Cable connection cable_id targeted by this remediation action.",
      +                          "type": "string"
      +                        },
      +                        "target_instance_id": {
      +                          "description": "Device instance_id targeted by this remediation action.",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "action_type",
      +                        "description"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "remediation_suggestions": {
      +                    "description": "Actionable self-correction instructions for the calling LLM agent.",
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "severity": {
      +                    "description": "Severity level of the engineering constraint diagnostic.",
      +                    "enum": [
      +                      "ERROR",
      +                      "WARNING",
      +                      "INFO"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "stage": {
      +                    "description": "Validation pipeline stage (1..5) that produced this finding.",
      +                    "maximum": 5,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "u_range": {
      +                    "additionalItems": false,
      +                    "description": "Inclusive [start_u, end_u] range where the issue occurs.",
      +                    "items": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      }
      +                    ],
      +                    "maxItems": 2,
      +                    "minItems": 2,
      +                    "type": "array"
      +                  }
      +                },
      +                "required": [
      +                  "code",
      +                  "severity",
      +                  "affected_instances",
      +                  "message",
      +                  "remediation_suggestions"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "mechanical_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated mechanical mass, center of gravity, thermal BTU/hr, and acoustic dB(A) metrics.",
      +              "properties": {
      +                "airflow_profile": {
      +                  "default": "uniform-passive",
      +                  "description": "Rack-wide thermal airflow regime classification.",
      +                  "enum": [
      +                    "uniform-front-to-rear",
      +                    "uniform-passive",
      +                    "hybrid-active-passive",
      +                    "mixed-conflict"
      +                  ],
      +                  "type": "string"
      +                },
      +                "available_portal_u_positions": {
      +                  "description": "1-indexed U slots that allow front-to-rear cable pass-through (open U or brush panel).",
      +                  "items": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": -9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "type": "array"
      +                },
      +                "center_of_gravity_y_mm": {
      +                  "description": "Vertical Center of Gravity height from bottom of U1 in millimeters.",
      +                  "type": "number"
      +                },
      +                "combined_noise_db_a": {
      +                  "default": 0,
      +                  "description": "Logarithmic sum of acoustic noise emissions in dB(A) across all mounted devices.",
      +                  "type": "number"
      +                },
      +                "normalized_cog_y": {
      +                  "description": "Normalized vertical Center of Gravity ratio (0.0 = bottom, 1.0 = top; keep <= 0.50).",
      +                  "type": "number"
      +                },
      +                "total_thermal_btu_hr": {
      +                  "default": 0,
      +                  "description": "Total peak thermal dissipation in BTU/hr (1W = 3.41214 BTU/hr).",
      +                  "type": "number"
      +                },
      +                "total_weight_grams": {
      +                  "description": "Total mass of all mounted equipment in grams.",
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "total_weight_grams",
      +                "center_of_gravity_y_mm",
      +                "normalized_cog_y",
      +                "available_portal_u_positions",
      +                "total_thermal_btu_hr",
      +                "combined_noise_db_a",
      +                "airflow_profile"
      +              ],
      +              "type": "object"
      +            },
      +            "power_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated electrical and PoE DAG power analysis.",
      +              "properties": {
      +                "power_sources": {
      +                  "description": "Per-PDU and per-UPS electrical load breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "Load and capacity summary for a mounted PDU or UPS unit.",
      +                    "properties": {
      +                      "capacity_watts": {
      +                        "description": "Maximum rated output capacity of the power source in watts.",
      +                        "type": "number"
      +                      },
      +                      "role": {
      +                        "description": "Electrical source classification (\"pdu\" or \"ups\").",
      +                        "enum": [
      +                          "pdu",
      +                          "ups"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "source_instance_id": {
      +                        "description": "Instance ID of the upstream PDU or UPS unit.",
      +                        "type": "string"
      +                      },
      +                      "total_load_watts": {
      +                        "description": "Cumulative downstream system and PoE load in watts.",
      +                        "type": "number"
      +                      },
      +                      "utilization_percent": {
      +                        "description": "Percentage of rated watt capacity consumed (0..100+).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "source_instance_id",
      +                      "role",
      +                      "capacity_watts",
      +                      "total_load_watts",
      +                      "utilization_percent"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "pse_budgets": {
      +                  "description": "Per-switch PoE budget utilization breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "PoE budget utilization breakdown for a single PSE switch.",
      +                    "properties": {
      +                      "consumed_poe_watts": {
      +                        "description": "Total PoE power drawn by connected Powered Devices (PDs) in watts.",
      +                        "type": "number"
      +                      },
      +                      "downstream_devices": {
      +                        "description": "Instance or endpoint IDs of downstream PoE consumers powered by this switch.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "poe_budget_watts": {
      +                        "description": "Maximum rated PoE output power budget of the switch in watts.",
      +                        "type": "number"
      +                      },
      +                      "pse_instance_id": {
      +                        "description": "Instance ID of the PoE Power Sourcing Equipment (PSE) switch.",
      +                        "type": "string"
      +                      },
      +                      "remaining_poe_watts": {
      +                        "description": "Remaining available PoE power budget in watts (negative if overloaded).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "pse_instance_id",
      +                      "poe_budget_watts",
      +                      "consumed_poe_watts",
      +                      "remaining_poe_watts",
      +                      "downstream_devices"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "total_poe_watts": {
      +                  "description": "Total PoE power draw across all connected PoE devices and external drops in watts.",
      +                  "type": "number"
      +                },
      +                "total_system_watts": {
      +                  "description": "Total peak system power draw across all mounted equipment in watts.",
      +                  "type": "number"
      +                },
      +                "unpowered_active_instances": {
      +                  "description": "Active device instance IDs missing a valid AC, DC, USB-C, or PoE power input.",
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "total_system_watts",
      +                "total_poe_watts",
      +                "pse_budgets",
      +                "power_sources",
      +                "unpowered_active_instances"
      +              ],
      +              "type": "object"
      +            },
      +            "status": {
      +              "description": "Overall rack validation state (\"VALID\" when error_count is 0).",
      +              "enum": [
      +                "VALID",
      +                "INVALID"
      +              ],
      +              "type": "string"
      +            },
      +            "warning_count": {
      +              "description": "Total number of non-blocking WARNING diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "is_valid",
      +            "error_count",
      +            "warning_count",
      +            "issues",
      +            "power_summary",
      +            "mechanical_summary"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "instance_id"
      +      ],
      +      "type": "object"
      +    },
      +    "issues": {
      +      "description": "Structured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.",
      +      "items": {
      +        "additionalProperties": false,
      +        "description": "Single validation finding with deterministic self-correction feedback.",
      +        "properties": {
      +          "affected_instances": {
      +            "description": "Device instance IDs involved in this diagnostic issue.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "code": {
      +            "description": "Machine-readable deterministic validation diagnostic code.",
      +            "enum": [
      +              "CHASSIS_COLLISION",
      +              "PLUG_CLEARANCE_COLLISION",
      +              "FRONT_DOOR_COLLISION",
      +              "SLOT_DIMENSION_OVERFLOW",
      +              "SLOT_INCOMPATIBLE",
      +              "OUT_OF_RACK_BOUNDS",
      +              "BLUEPRINT_NOT_FOUND",
      +              "PORT_NOT_FOUND",
      +              "PORT_ALREADY_OCCUPIED",
      +              "CONNECTOR_INCOMPATIBLE",
      +              "SIGNAL_PROTOCOL_INCOMPATIBLE",
      +              "SPEED_MISMATCH",
      +              "POE_BUDGET_EXCEEDED",
      +              "POE_CLASS_EXCEEDED",
      +              "UPS_OVERLOAD",
      +              "UNPOWERED_DEVICE",
      +              "TOP_HEAVY_RACK",
      +              "NO_FRONT_TO_REAR_PORTAL",
      +              "THERMAL_AIRFLOW_CONFLICT",
      +              "THERMAL_HOTSPOT_STACKING",
      +              "ACOUSTIC_NOISE_HIGH"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "Detailed engineering explanation with exact millimeter/watt figures.",
      +            "type": "string"
      +          },
      +          "remediation_actions": {
      +            "description": "Optional machine-actionable remediation descriptors.",
      +            "items": {
      +              "additionalProperties": false,
      +              "description": "Structured self-correction action for autonomous agent remediation.",
      +              "properties": {
      +                "action_type": {
      +                  "description": "Recommended self-correction operation category.",
      +                  "enum": [
      +                    "move_device",
      +                    "change_cable_type",
      +                    "connect_power",
      +                    "disconnect_cable",
      +                    "redistribute_poe",
      +                    "add_portal_gap",
      +                    "change_rack_depth"
      +                  ],
      +                  "type": "string"
      +                },
      +                "description": {
      +                  "description": "Human- and agent-readable explanation of the remediation step.",
      +                  "type": "string"
      +                },
      +                "suggested_cable_type": {
      +                  "description": "Suggested replacement cable_type (e.g. angled plug or higher speed grade).",
      +                  "type": "string"
      +                },
      +                "suggested_face": {
      +                  "description": "Mounting or port face relative to the rack or chassis.",
      +                  "enum": [
      +                    "front",
      +                    "rear"
      +                  ],
      +                  "type": "string"
      +                },
      +                "suggested_u_positions": {
      +                  "description": "Candidate 1-indexed U positions that resolve the spatial conflict.",
      +                  "items": {
      +                    "exclusiveMinimum": 0,
      +                    "maximum": 9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "type": "array"
      +                },
      +                "target_cable_id": {
      +                  "description": "Cable connection cable_id targeted by this remediation action.",
      +                  "type": "string"
      +                },
      +                "target_instance_id": {
      +                  "description": "Device instance_id targeted by this remediation action.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "action_type",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "remediation_suggestions": {
      +            "description": "Actionable self-correction instructions for the calling LLM agent.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "severity": {
      +            "description": "Severity level of the engineering constraint diagnostic.",
      +            "enum": [
      +              "ERROR",
      +              "WARNING",
      +              "INFO"
      +            ],
      +            "type": "string"
      +          },
      +          "stage": {
      +            "description": "Validation pipeline stage (1..5) that produced this finding.",
      +            "maximum": 5,
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "u_range": {
      +            "additionalItems": false,
      +            "description": "Inclusive [start_u, end_u] range where the issue occurs.",
      +            "items": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              }
      +            ],
      +            "maxItems": 2,
      +            "minItems": 2,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "severity",
      +          "affected_instances",
      +          "message",
      +          "remediation_suggestions"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "status": {
      +      "description": "Deterministic execution outcome: \"VALID\" when the operation succeeded with 0 validation errors; \"INVALID\" when precondition or engineering validation errors are present in issues[].",
      +      "enum": [
      +        "VALID",
      +        "INVALID"
      +      ],
      +      "type": "string"
      +    },
      +    "summary": {
      +      "description": "Concise human- and agent-readable summary of the tool result and validation status.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "summary",
      +    "data",
      +    "issues"
      +  ],
      +  "type": "object"
      +}
  3. Changed6 schema fields changedv0.4.9
    • removedInput schema / additionalProperties
      Removed value: -false
    • removedInput schema / properties / new_face / $ref
      Removed value: -"#/properties/face"
    • addedInput schema / properties / new_face / enum
      Added value: +[
      +  "front",
      +  "rear"
      +]
    • addedInput schema / properties / new_face / type
      Added value: +"string"
    • addedInput schema / properties / new_u_position / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / u_position / maximum
      Added value: +9007199254740991
  4. First observedv0.1.0

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and readOnlyHint=false, but the description adds material context beyond them: cascading deletion of child sub-modules, attached cables and external endpoints when remove_connected_cables is true, an atomic rack.yaml write, an undo-stack push, and a no-op 'INVALID' return for unknown instance_id or carrier. That is exactly the kind of consequence disclosure an agent needs before a destructive call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and destructive caveat are front-loaded, and every clause carries information about actions, precedence, cascade, or error behavior. The middle section is a long run-on sentence packing the action-to-field matrix, which costs some readability, but nothing is redundant with the annotations or schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter mutating tool this is thorough: identity resolution of instance_id across devices and sub-modules, per-action field requirements, cascade scope, atomicity, undo, and invalid-input behavior are all covered, and an output schema exists so return shapes need not be restated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns more by stating cross-field dependencies the schema cannot express, namely which fields apply per action and that primary fields take precedence over the new_* aliases. It stops short of adding format or constraint detail beyond what the schema declares.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb triple plus resource ('Move, rename, or destructively remove an existing mounted device or child sub-module in the active rack'), so the agent immediately knows the operation class and scope. It also names the sibling tools it is not (mount_equipment, disconnect_cables), making it unambiguous against adjacent tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It closes with explicit routing: 'Use to update or delete a mounted instance; use mount_equipment to add new hardware, or disconnect_cables to remove cables while keeping devices mounted.' In addition, it maps each 'action' enum value to the fields it requires, which is the operative when-to-use guidance for this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.