Edit

Azure MCP Server tools for Azure Resource Health

The Azure MCP Server lets you manage resource health, including checking availability status, viewing health events, and tracking service-impacting issues across your Azure resources, with natural language prompts.

Azure Resource Health provides information about the health of your individual Azure resources and helps you diagnose and mitigate issues. For more information, see Azure Resource Health documentation.

Note

Tool parameters: The Azure MCP Server tools define parameters for data they need to complete tasks. Some of these parameters are specific to each tool and are documented here. Other parameters are global and shared by all tools. For more information, see Tool parameters.

Get resource health availability status

This tool retrieves the Azure Resource Health availability status for a specific resource or for all resources in a subscription or resource group. It reports whether a resource is Available, Unavailable, Degraded, or Unknown, and includes the reason and details to help you investigate and troubleshoot. Specify a resource ID to check one resource, or specify a resource group to list statuses in that group. If you omit both parameters, the tool lists statuses across the subscription.

Example CLI command

azmcp resourcehealth availability-status get \
  [--resourceId <resource-id>] \
  [--resource-group <resource-group>]
Parameter Type Required Description
resourceId string No The Azure resource ID to get health status for, such as /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vm}.
resource-group string No The Azure resource group name.

Tool annotation hints:

Destructive Idempotent Open World Read Only Secret Local Required
❌ ✅ ❌ ✅ ❌ ❌

Get resource health events

List Azure Service Health events for your subscription to track incidents, planned maintenance, advisories, and security events over a specified time range (for example, the last 30 days). Query planned maintenance, past or ongoing incidents, advisories, and security events to retrieve details about resource availability, potential issues, and timestamps. The tool returns trackingId, title, summary, eventType, status, startTime, endTime, and impactedServices. Filter results by Event type, Status, Tracking ID, time range (Query start time and Query end time), or apply an OData Filter to narrow the results.

Example CLI command

azmcp resourcehealth health-events list \
  [--event-type <event-type>] \
  [--status <status>] \
  [--tracking-id <tracking-id>] \
  [--filter <filter>] \
  [--query-start-time <query-start-time>] \
  [--query-end-time <query-end-time>]
Parameter Type Required Description
event-type string No Filter by event type (ServiceIssue, PlannedMaintenance, HealthAdvisory, Security). If not specified, all event types are included.
status string No Filter by status (Active, Resolved). If not specified, all statuses are included.
tracking-id string No Filter by tracking ID to get a specific service health event.
filter string No Additional OData filter expression to apply to the service health events query.
query-start-time string No Start time for the query in ISO 8601 format (for example, 2024-01-01T00:00:00Z). Events from this time onwards are included.
query-end-time string No End time for the query in ISO 8601 format (for example, 2024-01-31T23:59:59Z). Events up to this time are included.

Tool annotation hints:

Destructive Idempotent Open World Read Only Secret Local Required
❌ ✅ ❌ ✅ ❌ ❌

Related content

  • Last updated on