Skip to content

Commit 38ecd14

Browse files
Merge pull request #8875 from MicrosoftDocs/main
Auto Publish – main to live - 2026-04-15 17:00 UTC
2 parents 9029eef + 84b7229 commit 38ecd14

2 files changed

Lines changed: 43 additions & 43 deletions

File tree

articles/azure-mcp-server/includes/tools/supported-azure-services.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
129129
| [Azure Pricing](../../tools/azure-pricing.md) | `pricing` | Get Azure retail pricing, cost estimates, and billing details for services, SKUs, and regions. |
130130
| [Azure Quick Review CLI](../../tools/azure-compliance-quick-review.md) | `extension` | Generate compliance and security reports for Azure resources. |
131131
| [Azure Quotas](../../tools/azure-quotas.md) | `quota` | Manage Azure resource quotas and limits. |
132-
| [Azure Resource Health](../../tools/azure-resource-health.md) | `resourcehealth` | Check the health status of Azure resources. |
132+
| [Azure Resource Health](../../tools/azure-resource-health.md) | `resourcehealth` | Check availability status, view health events, and track service-impacting issues for Azure resources. |
133133
| [Azure Well-Architected Framework](../../tools/azure-well-architected-framework.md) | `wellarchitectedframework` | Get architectural best practices, design patterns, and recommendations for Azure services based on the five Well-Architected Framework pillars. |
134134
| [Azure Workbooks](../../tools/azure-monitor.md) | `workbooks` | Create, manage, and update Azure Workbooks for data visualization and reporting. |
135135
| [Resource Groups](../../tools/resource-group.md) | `group` | List Azure resource groups and list resources within a group. |
Lines changed: 42 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,69 @@
11
---
2-
title: Azure Resource Health Tools
3-
description: Learn how to use the Azure MCP Server with Azure Resource Health.
2+
title: Azure MCP Server tools for Azure Resource Health
3+
description: Use Azure MCP Server tools to manage resource health and availability of Azure resources with natural language prompts from your IDE.
44
author: diberry
55
ms.author: diberry
6-
ms.date: 02/25/2026
7-
content_well_notification:
8-
- AI-contribution
9-
ai-usage: ai-assisted
6+
ms.service: azure-mcp-server
107
ms.topic: concept-article
11-
ms.custom: build-2025
8+
ms.date: 03/24/2026
9+
reviewer: shdesmu
1210
tool_count: 2
13-
mcp-cli.version: 2.0.0-beta.22+b6fc38c7fd6e025a7fd1dff42e49516225cae21b
14-
---
15-
# Azure Resource Health tools for the Azure MCP Server overview
11+
mcp-cli.version: 2.0.0-beta.39
12+
---
13+
14+
# Azure MCP Server tools for Azure Resource Health
15+
16+
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.
1617

17-
The Azure MCP Server enables you to monitor resource health and availability by using natural language prompts. With this capability, you can quickly check the status of your Azure resources without needing to remember complex command syntax.
18+
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](/azure/service-health/resource-health-overview).
1819

19-
[Azure Service Health](/azure/service-health/) helps you stay informed and get support when Azure services are having issues that affect you now, or could cause issues in the future. Azure Service Health includes three main components - Azure Status, Service Health, and Resource Health.
20+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
2021

21-
## Get availability status
22+
## Get resource health availability status
2223

23-
<!-- resourcehealth availability-status get -->
24+
<!-- @mcpcli resourcehealth availability-status get -->
2425

25-
Get the availability and health status for your Azure resources. This command displays the health status of a specific virtual machine, storage account, or other resources. You can also list the availability status for all resources in a subscription or resource group to identify health issues and availability problems.
26+
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. You can check the health of Azure resources such as virtual machines and storage accounts.
2627

2728
Example prompts include:
2829

29-
- Get the availability status for resource `resourceId`.
30-
- Show me the health status of the virtual machine `vm_name`.
31-
- What is the availability status of storage account `storage_account_name` in resource group `resource_group_name`?
32-
- List availability status for all resources in subscription `subscription`.
33-
- Show me the health status of all resources in resource group `resource_group_name`.
34-
- What resources in subscription `subscription` have health issues?
30+
- "Get the availability status for resource 'vm-web-01'."
31+
- "What is the Azure Resource Health availability status of the storage account 'mystorageacct'?"
32+
- "What is the availability status of virtual machine 'app-server-01' in resource group 'rg-prod'?"
33+
- "Get Azure Resource Health availability status for all resources in my subscription."
34+
- "Show me the health status of all my Azure resources."
35+
- "What resources in resource group 'rg-monitoring' have health issues?"
3536

3637
| Parameter | Required or optional | Description |
37-
|-----------|----------|-------------|
38-
| **Resource ID** | Required | The Azure resource ID to get health status for (for example, `/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vm}`). |
38+
|-----------------------|----------------------|-------------|
39+
| **ResourceId** | Optional | The Azure resource ID to get health status for such as `/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vm}`. |
3940

4041
[Tool annotation hints](index.md#tool-annotations-for-azure-mcp-server):
4142

4243
Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
4344

44-
## Get health event list
45+
## Get resource health events
4546

46-
<!-- resourcehealth service-health-events list -->
47+
<!-- @mcpcli resourcehealth health-events list -->
4748

48-
List Azure service health events for a subscription to identify ongoing or past service issues. Provides comprehensive information about service incidents, planned maintenance, advisories, and security events. Supports filtering by event type, status, tracking ID, and custom OData filters.
49-
Equivalent to Azure Service Health API for service events.
49+
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.
5050

5151
Example prompts include:
5252

53-
- "List service health events in subscription `<subscription>`"
54-
- "Show me service health events for subscription `<subscription>` within the last month"
55-
- "What service health issues have occurred recently?"
56-
- "List resolved service health events for my subscription"
57-
- "Show me all ongoing maintenance events for subscription `<subscription>`"
58-
59-
| Parameter | Required or optional | Description |
60-
|----------------|----------------------|-------------|
61-
| **Event type** | Optional | Filter by event type (`ServiceIssue`, `PlannedMaintenance`, `HealthAdvisory`, `Security`). If not specified, all event types are included. |
62-
| **Filter** | Optional | Additional OData filter expression to apply to the service health events query. |
63-
| **Query end time** | Optional | End time for the query in ISO 8601 format (for example, `2024-01-31T23:59:59Z`). Events up to this time will be included. |
64-
| **Query start time** | Optional | Start time for the query in ISO 8601 format (for example, `2024-01-01T00:00:00Z`). Events from this time onwards will be included. |
65-
| **Status** | Optional | Filter by status (`Active`, `Resolved`). If not specified, all statuses are included. |
66-
| **Tracking ID**| Optional | Filter by tracking ID to get a specific service health event. |
53+
- "Show all service health events in my subscription."
54+
- "Show Azure service health events for subscription <subscription_id>."
55+
- "Which service issues occurred in the last 30 days?"
56+
- "List active service health events in my subscription."
57+
- "Show planned maintenance events for my Azure services."
58+
59+
| Parameter | Required or optional | Description |
60+
|-----------------------|----------------------|-------------|
61+
| **Event type** | Optional | Filter by event type (ServiceIssue, PlannedMaintenance, HealthAdvisory, Security). If not specified, all event types are included. |
62+
| **Filter** | Optional | Additional OData filter expression to apply to the service health events query. |
63+
| **Query end time** | Optional | End time for the query in ISO 8601 format (for example, `2024-01-31T23:59:59Z`). Events up to this time will be included. |
64+
| **Query start time** | Optional | Start time for the query in ISO 8601 format (for example, `2024-01-01T00:00:00Z`). Events from this time onwards will be included. |
65+
| **Status** | Optional | Filter by status (Active, Resolved). If not specified, all statuses are included. |
66+
| **Tracking ID** | Optional | Filter by tracking ID to get a specific service health event. |
6767

6868
[Tool annotation hints](index.md#tool-annotations-for-azure-mcp-server):
6969

@@ -73,4 +73,4 @@ Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret:
7373

7474
- [What are the Azure MCP Server tools?](index.md)
7575
- [Get started using Azure MCP Server](../get-started.md)
76-
- [Azure Service Health](/azure/service-health/)
76+
- [Azure Resource Health documentation](/azure/service-health/resource-health-overview)

0 commit comments

Comments
 (0)