Prepare 0.5.8 release (#1032)

* Updated CHANGELOGs

* Updated the VS Code CHANGELOG after merging main

* Updated various docs

* Updated CHANGELOGs

* Fixed broken link

Author: vcolin7

CHANGELOG.md

@@ -2,13 +2,16 @@
 
 The Azure MCP Server updates automatically by default whenever a new release comes out 🚀. We ship updates twice a week on Tuesdays and Thursdays 😊
 
-## 0.5.8 (Unreleased)
+## 0.5.8 (2025-08-21)
 
 ### Features Added
 
-- Added support for listing knowledge indexes in Azure AI Foundry projects via the command `azmcp-foundry-knowledge-index-list`. [[#1004](https://github.com/Azure/azure-mcp/pull/1004)]
-- Added support for getting an Azure Function App via the command `azmcp-functionapp-get`. [[#970](https://github.com/Azure/azure-mcp/pull/970)]
-- Introduced `BaseAzureResourceService` class to perform Azure Resource read operations using Azure Resource Graph queries. [[#938](https://github.com/Azure/azure-mcp/pull/938)]
+- Added support for listing knowledge indexes in Azure AI Foundry projects via the command `azmcp_foundry_knowledge_index_list`. [[#1004](https://github.com/Azure/azure-mcp/pull/1004)]
+- Added support for getting details of an Azure Function App via the command `azmcp_functionapp_get`. [[#970](https://github.com/Azure/azure-mcp/pull/970)]
+- Added the following Azure Managed Lustre commands: [[#1003](https://github.com/Azure/azure-mcp/issues/1003)]
+  - `azmcp_azuremanagedlustre_filesystem_list`: List available Azure Managed Lustre filesystems.
+  - `azmcp_azuremanagedlustre_filesystem_required-subnet-size`: Returns the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem.
+- Added support for designing Azure Cloud Architecture through guided questions via the command `azmcp_cloudarchitect_design`. [[#890](https://github.com/Azure/azure-mcp/pull/890)]
 - Added support for the following Azure MySQL operations: [[#855](https://github.com/Azure/azure-mcp/issues/855)]
   - `azmcp_mysql_database_list` - List all databases in a MySQL server.
   - `azmcp_mysql_database_query` - Executes a SELECT query on a MySQL Database. The query must start with SELECT and cannot contain any destructive SQL operations for security reasons.
@@ -18,13 +21,13 @@ The Azure MCP Server updates automatically by default whenever a new release com
   - `azmcp_mysql_server_list` - List all MySQL servers in a subscription & resource group.
   - `azmcp_mysql_server_param_get` - Retrieve a specific parameter of a MySQL server.
   - `azmcp_mysql_server_param_set` - Set a specific parameter of a MySQL server to a specific value.
-- Adds telemetry for tracking service area when calling tools. [[#1024](https://github.com/Azure/azure-mcp/pull/1024)]
+- Added telemetry for tracking service area when calling tools. [[#1024](https://github.com/Azure/azure-mcp/pull/1024)]
 
 ### Breaking Changes
 
 - Renamed the following Storage tool option names: [[#1015](https://github.com/Azure/azure-mcp/pull/1015)]
-  - Renamed `azmcp-storage-account-create` `account-name` to `account`.
-  - Renamed `azmcp-storage-blob-batch-set-tier` `blob-names` to `blobs`.
+  - `azmcp_storage_account_create`: `account-name` → `account`.
+  - `azmcp_storage_blob_batch_set-tier`: `blob-names` → `blobs`.
 
 ### Bugs Fixed
 
@@ -33,13 +36,14 @@ The Azure MCP Server updates automatically by default whenever a new release com
 
 ### Other Changes
 
+- Introduced the `BaseAzureResourceService` class to allow performing Azure Resource read operations using Azure Resource Graph queries. [[#938](https://github.com/Azure/azure-mcp/pull/938)]
 - Refactored SQL service implementation to use Azure Resource Graph queries instead of direct ARM API calls. [[#938](https://github.com/Azure/azure-mcp/pull/938)]
   - Removed dependency on `Azure.ResourceManager.Sql` package by migrating to Azure Resource Graph queries, reducing package size and improving startup performance.
 - Enhanced `BaseAzureService` with `EscapeKqlString` method for safe KQL query construction across all Azure services. [[#938](https://github.com/Azure/azure-mcp/pull/938)]
   - Fixed KQL string escaping in Workbooks service queries.
 - Standardized Azure Storage command descriptions, option names, and parameter names for consistency across all storage commands. Updated JSON serialization context to remove unused model types and improve organization. [[#1015](https://github.com/Azure/azure-mcp/pull/1015)]
-- Update to .NET 10 SDK to prepare for .NET tool packing.
-- Enhance `bestpractices` and `azureterraformbestpractices` tool descriptions to better work with the vscode copilot tool grouping feature. [[#1029](https://github.com/Azure/azure-mcp/pull/1029)]
+- Updated to .NET 10 SDK to prepare for .NET tool packing.
+- Enhanced `bestpractices` and `azureterraformbestpractices` tool descriptions to better work with the vscode copilot tool grouping feature. [[#1029](https://github.com/Azure/azure-mcp/pull/1029)]
 
 #### Dependency Updates
 
@@ -49,11 +53,6 @@ The Azure MCP Server updates automatically by default whenever a new release com
 ## 0.5.7 (2025-08-19)
 
 ### Features Added
-- Added the following Azure Managed Lustre commands:
-  - `azmcp-azuremanagedlustre-filesystem-list`: List available Azure Managed Lustre filesystem. [[#1001](https://github.com/Azure/azure-mcp/issues/1001)]
-  - `azmcp-azuremanagedlustre-filesystem-required-subnet-size`: Returns the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem. [[#1002](https://github.com/Azure/azure-mcp/issues/1002)]
-
-- Added new command for designing Azure Cloud Architecture through guided questions. [[#890](https://github.com/Azure/azure-mcp/pull/890)]
 - Added support for the following Azure Deploy and Azure Quota operations: [[#626](https://github.com/Azure/azure-mcp/pull/626)]
   - `azmcp_deploy_app_logs_get` - Get logs from Azure applications deployed using azd.
   - `azmcp_deploy_iac_rules_get` - Get Infrastructure as Code rules.

README.md

@@ -64,14 +64,20 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * "Get Azure Data Explorer databases in cluster 'mycluster'"
 * "Sample 10 rows from table 'StormEvents' in Azure Data Explorer database 'db1'"
 
+### ⚡ Azure Managed Lustre
+
+* "List the Azure Managed Lustre clusters in resource group 'my-resourcegroup'"
+* "How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?"
+
 ### 📊 Azure Monitor
 
 * "Query my Log Analytics workspace"
 
-### ⚡ Azure Managed Lustre
+### 🔧 Azure Resource Management
 
-* "List the Azure Managed Lustre clusters in resource group 'my-resourcegroup'"
-* "How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?"
+* "List my resource groups"
+* "List my Azure CDN endpoints"
+* "Help me build an Azure application using Node.js"
 
 ### 🗄️ Azure SQL Database
 
@@ -81,12 +87,6 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * "List all elastic pools in my Azure SQL server 'myserver'"
 * "List Active Directory administrators for my Azure SQL server 'myserver'"
 
-### 🔧 Azure Resource Management
-
-* "List my resource groups"
-* "List my Azure CDN endpoints"
-* "Help me build an Azure application using Node.js"
-
 ### 💾 Azure Storage
 
 * "List my Azure storage accounts"
@@ -149,17 +149,17 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * Sample rows from a table
 * Query using KQL
 
-### 🐘 Azure Database for PostgreSQL - Flexible Server
+### 🐬 Azure Database for MySQL - Flexible Server
 
 * List and query databases.
 * List and get schema for tables.
 * List, get configuration and get parameters for servers.
 
-### 🐬 Azure Database for MySQL - Flexible Server
+### 🐘 Azure Database for PostgreSQL - Flexible Server
 
 * List and query databases.
 * List and get schema for tables.
-* List, get configuration and get parameters for servers.
+* List, get configuration and get/set parameters for servers.
 
 ### 🛠️ Azure Developer CLI (azd) Extension
 
@@ -187,10 +187,6 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * List Azure Function Apps
 * Get details for a specific Function App
 
-### 🚀 Azure Managed Grafana
-
-* List Azure Managed Grafana
-
 ### 🔑 Azure Key Vault
 
 * List, create, and import certificates
@@ -207,6 +203,16 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * List, create load tests
 * Get, list, (create) run and rerun, update load test runs
 
+
+### 🚀 Azure Managed Grafana
+
+* List Azure Managed Grafana
+
+### ⚡ Azure Managed Lustre
+
+* List Azure Managed Lustre filesystems
+* Get the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem
+
 ### 🏪 Azure Marketplace
 
 * Get details about Marketplace products
@@ -228,6 +234,11 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
 * Query Azure Monitor metrics for resources with time series data
 * List available metric definitions for resources
 
+### 🏥 Azure Service Health
+
+* Get the availability status for a specific resource
+* List availability statuses for all resources in a subscription or resource group
+
 ### ⚙️ Azure Native ISV Services
 
 * List Monitored Resources in a Datadog Monitor

docs/azmcp-commands.md

@@ -120,6 +120,9 @@ azmcp server start \
 ### Azure AI Foundry Operations
 
 ```bash
+# List knowledge indexes in an AI Foundry project
+azmcp foundry knowledge index list --endpoint <endpoint>
+
 # Deploy an AI Foundry model
 azmcp foundry models deploy --subscription <subscription> \
                             --resource-group <resource-group> \
@@ -142,9 +145,6 @@ azmcp foundry models list [--search-for-free-playground <search-for-free-playgro
                           [--publisher <publisher>] \
                           [--license <license>] \
                           [--model-name <model>]
-
-# List knowledge indexes in an AI Foundry project
-azmcp foundry knowledge index list --endpoint <endpoint>
 ```
 
 ### Azure AI Search Operations
@@ -1127,19 +1127,19 @@ azmcp bicepschema get --resource-type <resource-type> \
 ```bash
 # Design Azure cloud architectures through guided questions
 azmcp cloudarchitect design [--question <question>] \
-                           [--question-number <question-number>] \
-                           [--total-questions <total-questions>] \
-                           [--answer <answer>] \
-                           [--next-question-needed <true/false>] \
-                           [--confidence-score <confidence-score>] \
-                           [--architecture-component <architecture-component>]
+                            [--question-number <question-number>] \
+                            [--total-questions <total-questions>] \
+                            [--answer <answer>] \
+                            [--next-question-needed <true/false>] \
+                            [--confidence-score <confidence-score>] \
+                            [--architecture-component <architecture-component>]
 
 # Example:
 # Start an interactive architecture design session
 azmcp cloudarchitect design --question "What type of application are you building?" \
-                           --question-number 1 \
-                           --total-questions 5 \
-                           --confidence-score 0.1
+                            --question-number 1 \
+                            --total-questions 5 \
+                            --confidence-score 0.1
 ```
 
 ## Response Format

docs/e2eTestPrompts.md

@@ -96,18 +96,18 @@ This file contains prompts used for end-to-end testing to ensure each tool is in
 
 | Tool Name | Test Prompt |
 |:----------|:----------|
-| azmcp-mysql-database-list | List all MySQL databases in server \<server> |
-| azmcp-mysql-database-list | Show me the MySQL databases in server \<server> |
-| azmcp-mysql-database-query | Show me all items that contain the word \<search_term> in the MySQL database \<database> in server \<server> |
-| azmcp-mysql-server-config-get | Show me the configuration of MySQL server \<server> |
-| azmcp-mysql-server-list | List all MySQL servers in my subscription |
-| azmcp-mysql-server-list | Show me my MySQL servers |
-| azmcp-mysql-server-list | Show me the MySQL servers in my subscription |
-| azmcp-mysql-server-param-get | Show me the value of connection timeout in seconds in my MySQL server \<server>  |
-| azmcp-mysql-server-param-set | Set connection timeout to 20 seconds for my MySQL server \<server> |
-| azmcp-mysql-table-list | List all tables in the MySQL database \<database> in server \<server> |
-| azmcp-mysql-table-list | Show me the tables in the MySQL database \<database> in server \<server> |
-| azmcp-mysql-table-schema-get | Show me the schema of table \<table> in the MySQL database \<database> in server \<server> |
+| azmcp_mysql_database_list | List all MySQL databases in server \<server> |
+| azmcp_mysql_database_list | Show me the MySQL databases in server \<server> |
+| azmcp_mysql_database_query | Show me all items that contain the word \<search_term> in the MySQL database \<database> in server \<server> |
+| azmcp_mysql_server_config_get | Show me the configuration of MySQL server \<server> |
+| azmcp_mysql_server_list | List all MySQL servers in my subscription |
+| azmcp_mysql_server_list | Show me my MySQL servers |
+| azmcp_mysql_server_list | Show me the MySQL servers in my subscription |
+| azmcp_mysql_server_param_get | Show me the value of connection timeout in seconds in my MySQL server \<server>  |
+| azmcp_mysql_server_param_set | Set connection timeout to 20 seconds for my MySQL server \<server> |
+| azmcp_mysql_table_list | List all tables in the MySQL database \<database> in server \<server> |
+| azmcp_mysql_table_list | Show me the tables in the MySQL database \<database> in server \<server> |
+| azmcp_mysql_table_schema_get | Show me the schema of table \<table> in the MySQL database \<database> in server \<server> |
 
 ## Azure Database for PostgreSQL
 
@@ -147,15 +147,15 @@ This file contains prompts used for end-to-end testing to ensure each tool is in
 
 | Tool Name | Test Prompt |
 |:----------|:----------|
-| azmcp-functionapp_get | Describe the function app <function_app_name> in resource group <resource_group_name> |
-| azmcp-functionapp_get | Get configuration for function app <function_app_name> |
-| azmcp-functionapp_get | Get function app status for <function_app_name> |
-| azmcp-functionapp_get | Get information about my function app <function_app_name> in <resource_group_name> |
-| azmcp-functionapp_get | Retrieve host name and status of function app <function_app_name> |
-| azmcp-functionapp_get | Show function app details for <function_app_name> in <resource_group_name> |
-| azmcp-functionapp_get | Show me the details for the function app <function_app_name> |
-| azmcp-functionapp_get | Show plan and region for function app <function_app_name> |
-| azmcp-functionapp_get | What is the status of function app <function_app_name>? |
+| azmcp_functionapp_get | Describe the function app <function_app_name> in resource group <resource_group_name> |
+| azmcp_functionapp_get | Get configuration for function app <function_app_name> |
+| azmcp_functionapp_get | Get function app status for <function_app_name> |
+| azmcp_functionapp_get | Get information about my function app <function_app_name> in <resource_group_name> |
+| azmcp_functionapp_get | Retrieve host name and status of function app <function_app_name> |
+| azmcp_functionapp_get | Show function app details for <function_app_name> in <resource_group_name> |
+| azmcp_functionapp_get | Show me the details for the function app <function_app_name> |
+| azmcp_functionapp_get | Show plan and region for function app <function_app_name> |
+| azmcp_functionapp_get | What is the status of function app <function_app_name>? |
 | azmcp_functionapp_list | List all function apps in my subscription |
 | azmcp_functionapp_list | Show me my Azure function apps |
 | azmcp_functionapp_list | What function apps do I have? |
@@ -209,6 +209,14 @@ This file contains prompts used for end-to-end testing to ensure each tool is in
 |:----------|:----------|
 | azmcp_grafana_list | List all Azure Managed Grafana in one subscription |
 
+## Azure Managed Lustre
+
+| Tool Name | Test Prompt |
+|:----------|:----------|
+| azmcp_azuremanagedlustre_filesystem_list | List the Azure Managed Lustre filesystems in my subscription <subscription_name> |
+| azmcp_azuremanagedlustre_filesystem_list | List the Azure Managed Lustre filesystems in my resource group <resource_group_name> |
+| azmcp_azuremanagedlustre_filesystem_required-subnet-size | Tell me how many IP addresses I need for <filesystem_size> of <amlfs_sku> |
+
 ## Azure Marketplace
 
 | Tool Name | Test Prompt |
@@ -254,14 +262,6 @@ This file contains prompts used for end-to-end testing to ensure each tool is in
 | azmcp_monitor_workspace_list | Show me the Log Analytics workspaces in my subscription |
 | azmcp_monitor_workspace_log_query | Show me the logs for the past hour in the Log Analytics workspace <workspace_name> |
 
-## Azure Managed Lustre
-
-| Tool Name | Test Prompt |
-|:----------|:----------|
-| azmcp-azuremanagedlustre-filesystem-list | List the Azure Managed Lustre filesystems in my subscription <subscription_name> |
-| azmcp-azuremanagedlustre-filesystem-list | List the Azure Managed Lustre filesystems in my resource group <resource_group_name> |
-| azmcp-azuremanagedlustre-filesystem-required-subnet-size | Tell me how many IP addresses I need for <filesystem_size> of <amlfs_sku> |
-
 ## Azure Native ISV
 
 | Tool Name | Test Prompt |