Tools Reference
Complete reference for all 93 tools exposed by azops-mcp, organized by Azure service category.
1. Health & Status (1 tool)
health_check
Check MCP server health and Azure SDK availability.
Parameters: None
Returns: JSON dict with status, dependencies, timestamp, version
2. Subscription & Authentication (8 tools)
list_subscriptions
List all Azure subscriptions you have access to.
Parameters: None
Returns: Formatted list of subscription names, IDs, and states
set_subscription
Set the Azure subscription to use for this session.
Parameters: subscription_id (str, required) — UUID format
Returns: Confirmation with subscription name and state
auth_status
Check Azure authentication status and method.
Parameters: None
Returns: Authentication method, validity, token expiry, subscription source
account_show
Get details of the current Azure subscription (similar to az account show).
Parameters: None
Returns: Subscription name, ID, tenant ID, state, environment
account_clear
Clear cached Azure credentials and subscription override.
Parameters: None
Returns: Confirmation message
account_get_access_token
Get an Azure access token (similar to az account get-access-token).
Parameters: resource (str, optional, default: management.azure.com)
Returns: Masked token, expiry, subscription, tenant
list_locations
List all Azure regions available for the subscription.
Parameters: None
Returns: Region names, display names, types
list_tenants
List Azure AD tenants you have access to.
Parameters: None
Returns: Tenant IDs, display names, domains, types
3. Management Groups (2 tools)
list_management_groups
List all Azure management groups.
Parameters: None
Returns: Management group names, IDs, types
get_management_group
Get details of a management group including its children.
Parameters: group_id (str, required)
Returns: Display name, tenant ID, children
4. RBAC (4 tools)
list_role_definitions
List available Azure role definitions (built-in roles).
Parameters: None
Returns: Role names, IDs, descriptions (max 15)
create_role_assignment
Create a new role assignment (RBAC).
Parameters: principal_id (str), role_definition_name (str), resource_group (str, opt), scope (str, opt)
Returns: Assignment details
delete_role_assignment
Delete a role assignment.
Parameters: assignment_id (str, required)
Returns: Deletion confirmation
list_role_assignments_for_principal
List role assignments for a specific principal.
Parameters: principal_id (str), resource_group (str, opt)
Returns: Role assignments
5. Governance (3 tools)
list_resource_locks
List resource locks in subscription or resource group.
Parameters: resource_group (str, optional)
Returns: Lock names, levels, notes
list_tags
List tags in subscription or on a resource group.
Parameters: resource_group (str, optional)
Returns: Tag key/value pairs
get_activity_log
Get recent Azure activity log (audit log).
Parameters: resource_group (str, opt), days (int, default 1, range 1-7)
Returns: Timestamps, operations, statuses, callers (max 20)
6. Resource Groups (2 tools)
list_resource_groups
List all resource groups in the subscription.
Parameters: None
Returns: Names, locations, provisioning states
list_resources
List resources in a resource group.
Parameters: resource_group (str), resource_type (str, default 'all')
Returns: Resource types, names, locations, statuses
7. Virtual Machines (7 tools)
list_vms
List virtual machines in a resource group.
Parameters: resource_group (str, required)
Returns: VM names, locations, power states, sizes
get_vm_status
Get detailed status of a virtual machine.
Parameters: resource_group (str), vm_name (str)
Returns: Name, location, VM size, power state, OS type
start_vm
Start a virtual machine.
Parameters: resource_group (str), vm_name (str)
Returns: Success confirmation
stop_vm
Stop a virtual machine. VM stays allocated — charges continue.
Parameters: resource_group (str), vm_name (str)
Returns: Success confirmation
restart_vm
Restart a virtual machine.
Parameters: resource_group (str), vm_name (str)
Returns: Success confirmation
deallocate_vm
Deallocate a VM — stops and releases compute. No charges.
Parameters: resource_group (str), vm_name (str)
Returns: Success confirmation
scale_vmss
Scale a Virtual Machine Scale Set.
Parameters: resource_group (str), vmss_name (str), capacity (int, >= 0)
Returns: Previous and new capacity
8. Storage Accounts (2 tools)
list_storage_accounts
List storage accounts in a resource group.
Parameters: resource_group (str, required)
Returns: Account names, locations, provisioning states, kinds
get_storage_status
Get status of a storage account.
Parameters: resource_group (str), account_name (str)
Returns: Name, location, kind, SKU, provisioning state, endpoints
9. App Configuration (6 tools)
appconfig_list
List App Configuration stores.
Parameters: resource_group (str, optional)
Returns: Store names, locations, endpoints, SKUs
appconfig_show
Show details of an App Configuration store.
Parameters: store_name (str), resource_group (str)
Returns: Full store details
appconfig_kv_list
List key-values in a store.
Parameters: store_name (str), resource_group (opt), key_filter (default '*'), label_filter (opt)
Returns: Keys, values, labels, content types (max 50)
appconfig_kv_show
Show a specific key-value.
Parameters: store_name (str), key (str), resource_group (opt), label (opt)
Returns: Key, value, label, content type, last modified, etag
appconfig_kv_set
Set a key-value.
Parameters: store_name (str), key (str), value (str), resource_group (opt), label (opt), content_type (opt)
Returns: Confirmation
appconfig_kv_delete
Delete a key-value.
Parameters: store_name (str), key (str), resource_group (opt), label (opt)
Returns: Deletion confirmation
10. App Service (7 tools)
appservice_plan_list
List App Service plans.
Parameters: resource_group (str, optional)
Returns: Plan names, locations, SKUs, status
appservice_plan_show
Show details of an App Service plan.
Parameters: name (str), resource_group (str)
Returns: Full plan details
webapp_list
List web apps.
Parameters: resource_group (str, optional)
Returns: Web app names, locations, states, hostnames
webapp_show
Show details of a web app.
Parameters: name (str), resource_group (str)
Returns: Full web app details
webapp_start
Start a web app.
Parameters: name (str), resource_group (str)
Returns: Success confirmation
webapp_stop
Stop a web app.
Parameters: name (str), resource_group (str)
Returns: Success confirmation
webapp_restart
Restart a web app.
Parameters: name (str), resource_group (str)
Returns: Success confirmation
11. Web Apps for Containers (7 tools)
webapp_create_for_container
Create a Web App for Containers on Azure App Service.
Parameters: name, resource_group, plan_name, plan_sku, location, image, registry_url/username/password, os_type, startup_command, env_variables, vnet_subnet_id, assign_identity
Returns: Full deployment details
webapp_grant_cr_access
Grant Web App access to Container Registry via RBAC.
Parameters: webapp_name, resource_group, registry_name, registry_resource_group, role (default AcrPull)
Returns: RBAC assignment details
webapp_configure_vnet_integration
Configure VNet integration for a web app.
Parameters: webapp_name (str), resource_group (str), subnet_id (str)
Returns: VNet integration details
webapp_assign_identity
Assign system-assigned managed identity.
Parameters: webapp_name (str), resource_group (str)
Returns: Principal ID, tenant ID, identity type
webapp_view_logs
View web app logs from Azure Monitor.
Parameters: webapp_name (str), resource_group (str), days (int, default 1)
Returns: Activity log entries
webapp_set_container_registry_credentials
Set container registry credentials for a web app.
Parameters: webapp_name, resource_group, registry_url, username, password, os_type
Returns: Credential confirmation
webapp_delete
Delete a web app.
Parameters: name (str), resource_group (str)
Returns: Deletion confirmation
12. Container Registry (20 tools)
acr_list_registries
List container registries.
Parameters: resource_group (str, optional)
Returns: Registry names, locations, SKUs, admin status
acr_show_registry
Get details of a container registry.
Parameters: resource_group (str), registry_name (str)
Returns: Full registry details
acr_create_registry
Create a new container registry.
Parameters: resource_group, registry_name, location (default eastus), sku (default Basic), admin_enabled (default false)
Returns: Created registry details
acr_delete_registry
Delete a container registry.
Parameters: resource_group (str), registry_name (str)
Returns: Deletion confirmation
acr_update_registry
Update a container registry.
Parameters: resource_group, registry_name, admin_enabled (opt)
Returns: Updated registry details
acr_get_credentials
Get login credentials.
Parameters: resource_group (str), registry_name (str)
Returns: Username and passwords
acr_get_login_server
Get login server URL.
Parameters: resource_group (str), registry_name (str)
Returns: Login server URL
acr_list_repositories
List repositories in a registry.
Parameters: resource_group (str), registry_name (str)
Returns: Repository names
acr_list_tags
List tags in a repository.
Parameters: resource_group, registry_name, repository
Returns: Tag names and metadata
acr_show_task
Get details of a registry task.
Parameters: resource_group, registry_name, task_name
Returns: Task details
acr_list_tasks
List tasks in a registry.
Parameters: resource_group (str), registry_name (str)
Returns: Task names and statuses
acr_create_task
Create a registry task.
Parameters: resource_group, registry_name, task_name, platform_os, platform_architecture, platform_variant
Returns: Created task details
acr_delete_task
Delete a registry task.
Parameters: resource_group, registry_name, task_name
Returns: Deletion confirmation
acr_run_task
Run a registry task.
Parameters: resource_group, registry_name, task_name
Returns: Run details
acr_list_builds
List build tasks.
Parameters: resource_group (opt), registry_name (opt)
Returns: Build task names and statuses
acr_show_quotas
Show quota information.
Parameters: resource_group (str), registry_name (str)
Returns: Quota limits and usage
acr_show_usage
Show usage information.
Parameters: resource_group (str), registry_name (str)
Returns: Storage usage details
acr_list_network_rules
List network rules.
Parameters: resource_group (str), registry_name (str)
Returns: Default action, IP rules, VNet rules
acr_update_network_rules
Update network rules.
Parameters: resource_group, registry_name, default_action (default Allow)
Returns: Updated network rule details
acr_reset_client
Reset cached ACR client.
Parameters: None
Returns: Cache cleared confirmation
13. Virtual Networks (9 tools)
vnet_list
List virtual networks.
Parameters: resource_group (str, optional)
Returns: VNet names, locations, address spaces, subnet counts
vnet_show
Show details of a virtual network.
Parameters: name (str), resource_group (str)
Returns: Address space, DNS, DDoS protection, subnets, peerings, tags
vnet_create
Create a virtual network with a default subnet.
Parameters: name, resource_group, address_prefix (default 10.0.0.0/16), location (opt)
Returns: Created VNet details
vnet_delete
Delete a virtual network. Removes all subnets and peerings.
Parameters: name (str), resource_group (str)
Returns: Deletion confirmation
vnet_subnet_list
List subnets in a virtual network.
Parameters: vnet_name (str), resource_group (str)
Returns: Subnet names, prefixes, NSGs, delegations
vnet_subnet_show
Show details of a subnet.
Parameters: vnet_name, subnet_name, resource_group
Returns: Full subnet details
vnet_subnet_create
Create a subnet.
Parameters: vnet_name, subnet_name, resource_group, address_prefix
Returns: Created subnet details
vnet_subnet_delete
Delete a subnet.
Parameters: vnet_name, subnet_name, resource_group
Returns: Deletion confirmation
vnet_peering_list
List peerings for a virtual network.
Parameters: vnet_name (str), resource_group (str)
Returns: Peering names, states, remote VNets
14. Azure AD / Entra ID (9 tools)
aad_list_users
List Azure AD users.
Parameters: filter (str, opt), top (int, default 50)
Returns: Display names, UPNs, object IDs, account status
aad_show_user
Get details of an Azure AD user.
Parameters: user_id (str), user_principal_name (opt)
Returns: Full user profile
aad_create_user
Create a new Azure AD user.
Parameters: display_name, user_principal_name, password, mail_nick_name (opt), department (opt), job_title (opt)
Returns: Created user details
aad_delete_user
Delete an Azure AD user.
Parameters: user_id (str), user_principal_name (opt)
Returns: Deletion confirmation
aad_list_applications
List Azure AD applications.
Parameters: filter (opt), top (int, default 50)
Returns: App display names, app IDs, object IDs
aad_create_application
Create a new Azure AD application.
Parameters: display_name (str), sign_in_audience (default AzureADMyOrg)
Returns: Created application details
aad_list_groups
List Azure AD groups.
Parameters: filter (opt), top (int, default 50)
Returns: Group display names, object IDs, descriptions
aad_verify_tenant
Verify Azure AD tenant information.
Parameters: None
Returns: Tenant ID, display name, country, default domain
aad_reset_client
Reset cached Azure AD client.
Parameters: None
Returns: Cache cleared confirmation
15. Docker Runtime (3 tools)
list_containers
List running Docker containers on the local machine.
Parameters: None
Returns: Container IDs, names, statuses, images
get_container_logs
Retrieve logs from a Docker container.
Parameters: container_id (str), lines (int, default 50)
Returns: Container log output
restart_container
Restart a Docker container.
Parameters: container_id (str, required)
Returns: Restart confirmation
16. Monitoring (3 tools)
get_system_metrics
Get system metrics (CPU, memory, disk usage).
Parameters: None
Returns: CPU usage, memory stats, disk usage
check_service_health
Check health of a system service.
Parameters: service_name (str, required)
Returns: Service status (active/inactive)
get_infrastructure_status
Get overall infrastructure health status.
Parameters: None
Returns: Docker availability, system uptime