Subchapter 9.2
references/mcp-and-cli-tools.mdMarkdown3 KBView on GitHub
Prefer Azure MCP tools for Azure control-plane discovery where they support the Azure Local resource type, then use generated Azure CLI/PowerShell commands when a documented operation requires command execution. Azure MCP does not currently expose a dedicated Azure Local tool namespace; treat support as partial through generic Azure, Azure Resource Graph, documentation, monitor/resource health, and Bicep schema surfaces.
| Tool | Use |
|---|---|
mcp_azure_mcp_subscription_list | Discover subscription scope. |
mcp_azure_mcp_group_list | Discover resource groups. |
mcp_azure_mcp_extension_cli_generate | Generate Azure CLI or Azure Resource Graph commands for Azure Local/Arc inventory and operations. |
mcp_azure_mcp_monitor | Query logs/metrics when Azure Monitor or Log Analytics is configured. |
mcp_azure_mcp_resourcehealth | Check resource health where supported. |
mcp_azure_mcp_documentation | Retrieve current Microsoft Learn content. |
mcp_azure_mcp_bicepschema | Inspect ARM/Bicep schemas for Azure Local resource types such as Microsoft.AzureStackHCI/clusters when authoring templates. |
Do not assume public Azure service-specific MCP tools are interchangeable with Azure Local. For example, public Azure VM and AKS tools may not cover Arc VMs or AKS on Azure Local; confirm the resource provider/type and use ARG, generated CLI, or documented PowerShell when the dedicated MCP tool does not match.
Use Azure CLI for Azure control-plane operations:
az account show
az group list -o table
az graph query -q "Resources | where type =~ 'microsoft.azurestackhci/clusters' | project name, resourceGroup, location" -o table
az resource show --ids <resource-id>
az monitor activity-log list --resource-id <resource-id> --max-events 20For Azure Local VM operations, use the Azure Local VM management docs to determine the required extension/CLI commands and parameters. Do not assume public Azure VM commands have identical behavior for Azure Local VMs enabled by Azure Arc.
Use PowerShell when Microsoft Learn specifies Azure Local lifecycle, update, or local cluster commands. Confirm the command is supported for the user’s Azure Local version before execution.
Common categories:
Ask the user to confirm direct administrative access to an Azure Local machine before local commands. Local access may be required for:
--first, --query, or projection for large Azure Resource Graph queries.