[ONBOARD] Azure Compute - Addional VM Lifecycle, Extension, and List operations #2341
Description
Service / Tool Name
Azure.Compute.VM
Contacts
Audrey Toney (audreytoney), Haider Agha (haider.agha), Bila Akpan (saakpan)
Intended Agent Scenarios
Intended Agent Scenarios
Enable AI agents to manage Azure VMs and VMSS through natural language commands. This onboarding focuses on
the most common VM lifecycle commands, VM extension commands, and common list commands for VM/VMSS from the ComputeRP API.
MCP Command Summary
| Category | Commands |
|---|---|
| VM Lifecycle | azmcp-compute-vm-power-state |
| VM/VMSS Discovery & List | azmcp-compute-vmss-instance-view azmcp-compute-vm-list-usage azmcp-compute-vm-list-skus azmcp-compute-vm-list-sizes azmcp-compute-vm-ip-list |
| VM Extensions | azmcp-compute-vm-extension-get azmcp-compute-vm-extension-set azmcp-compute-vm-extension-delete |
| VMSS Extensions | azmcp-compute-vmss-extension-get azmcp-compute-vmss-extension-set azmcp-compute-vmss-extension-delete |
| VM Disk Ops | azmcp-compute-vm-disk-attach azmcp-compute-vm-disk-detach |
VM Lifecycle Commands
azmcp-compute-vm-power-state
Perform vm power state commands, including: start a stopped or deallocated virtual machine (start), stop a virtual machine by requesting a guest OS shutdown and deallocating compute resources (stop), immediately deallocate a virtual machine without attempting a guest OS shutdown (deallocate), and restart the operating system of a virtual machine (restart).
Equivalent CLI commands: az vm start, az vm stop, azmcp-compute-vm-deallocate, and azmcp-compute-vm-restart.
Required Parameters
--name(string): Virtual machine name--resource-group(string): Resource group name--subscription(string): Subscription ID or name--state(string): The state change to be applied to the VM (start, stop, deallocate, or restart)
Optional Parameters
--no-wait(bool): Return immediately without waiting for completion- only compatible with stop parameter
--skip-shutdown(bool): Skip guest OS shutdown and force power off
VM/VMSS List Commands
azmcp-compute-vm-list-usage
List compute usage and quotas for a given region.
Equivalent CLI: az vm list-usage
Required Parameters
--location(string): Azure region--subscription(string): Subscription ID or name
azmcp-compute-vm-list-skus
List available VM SKUs and capabilities in a region.
Equivalent CLI: az vm list-skus
Required Parameters
--subscription(string): Subscription ID or name
Optional Parameters
--location(string): Azure region--size(string): Filter by VM size name--query(string): JMESPath query for filtering results
azmcp-compute-vm-list-sizes
List VM sizes available for deployment in a region.
Equivalent CLI: az vm list-sizes
Required Parameters
--location(string): Azure region--subscription(string): Subscription ID or name
azmcp-compute-vm-ip-list
List public and private IP addresses associated with a VM.
Required Parameters
--name(string): Virtual machine name--resource-group(string): Resource group name--subscription(string): Subscription ID or name
azmcp-compute-vmss-list-instances
List VM instances within a scale set.
Equivalent CLI: az vmss list-instances
Required Parameters
--name(string): VM scale set name--resource-group(string): Resource group name--subscription(string): Subscription ID or name
VM/VMSS Extension Operations
azmcp-compute-vm-extension-get
Get or list extensions installed on a virtual machine.
Equivalent CLI:
az vm extension showaz vm extension list
Required Parameters
--vm-name(string): Virtual machine name--resource-group(string): Resource group name--subscription(string): Subscription ID or name
Optional Parameters
--name(string): Extension name (required forshow)--query(string): JMESPath query for filtering results--output(string): Output format (json,table)
azmcp-compute-vm-extension-set
Create or update an extension on a virtual machine.
Equivalent CLI: az vm extension set
Required Parameters
--vm-name(string): Virtual machine name--resource-group(string): Resource group name--name(string): Extension name--publisher(string): Extension publisher (e.g.Microsoft.Compute)--type(string): Extension type--subscription(string): Subscription ID or name
Optional Parameters
--type-handler-version(string): Extension version--settings(string): Public settings JSON--protected-settings(string): Protected settings JSON--auto-upgrade-minor-version(bool): Enable automatic minor version upgrades--no-wait(bool): Return immediately without waiting for completion
azmcp-compute-vm-extension-delete
Delete an extension from a virtual machine.
Equivalent CLI: az vm extension delete
Required Parameters
--vm-name(string): Virtual machine name--resource-group(string): Resource group name--name(string): Extension name--subscription(string): Subscription ID or name
Optional Parameters
--no-wait(bool): Return immediately without waiting for completion
azmcp-compute-vmss-extension-get
Get or list extensions configured on a Virtual Machine Scale Set.
Equivalent CLI:
az vmss extension showaz vmss extension list
Required Parameters
--vmss-name(string): VM scale set name--resource-group(string): Resource group name--subscription(string): Subscription ID or name
Optional Parameters
--name(string): Extension name (required forshow)--query(string): JMESPath query for filtering results--output(string): Output format (json,table)
azmcp-compute-vmss-extension-set
Create or update an extension on a Virtual Machine Scale Set.
Equivalent CLI: az vmss extension set
Required Parameters
--vmss-name(string): VM scale set name--resource-group(string): Resource group name--name(string): Extension name--publisher(string): Extension publisher--type(string): Extension type--subscription(string): Subscription ID or name
Optional Parameters
--type-handler-version(string): Extension version--settings(string): Public settings JSON--protected-settings(string): Protected settings JSON--auto-upgrade-minor-version(bool): Enable automatic minor version upgrades--no-wait(bool): Return immediately without waiting for completion
azmcp-compute-vmss-extension-delete
Delete an extension from a Virtual Machine Scale Set.
Equivalent CLI: az vmss extension delete
Required Parameters
--vmss-name(string): VM scale set name--resource-group(string): Resource group name--name(string): Extension name--subscription(string): Subscription ID or name
Optional Parameters
--no-wait(bool): Return immediately without waiting for completion
VM Disk Operations
azmcp-compute-vm-disk-attach
Attach a managed data disk to a virtual machine.
Equivalent CLI: az vm disk attach
Required Parameters
--vm-name(string): Virtual machine name--resource-group(string): Resource group name--subscription(string): Subscription ID or name
Optional Parameters
--name(string): Disk name or disk resource ID--new(bool): Create and attach a new disk--size-gb(int): Disk size in GB (required when using--new)--sku(string): Disk SKU (Standard_LRS,StandardSSD_LRS,Premium_LRS,UltraSSD_LRS)--lun(int): Logical unit number--caching(string): Disk caching mode (None,ReadOnly,ReadWrite)--enable-write-accelerator(bool): Enable write accelerator (Ultra / Premium only)
azmcp-compute-vm-disk-detach
Detach a managed data disk from a virtual machine.
Equivalent CLI: az vm disk detach
Required Parameters
--vm-name(string): Virtual machine name--resource-group(string): Resource group name--name(string): Disk name or disk resource ID--subscription(string): Subscription ID or name
Optional Parameters
--force-detach(bool): Force detach disk (recovery scenarios only)
API Specification
- API Version: 2025-04-01 (stable)
- Specification:
- Resource Provider: Microsoft.Compute
- Authentication: Azure Resource Manager (ARM) with Azure AD
Timeline
April 2026
Metadata
Metadata
Assignees
Labels
Type
Projects
Status