Skip to content

Commit cc0c9b3

Browse files
Merge pull request #7620 from MicrosoftDocs/main
Auto Publish – main to live - 2025-08-04 17:00 UTC
2 parents 7966ce5 + 986831f commit cc0c9b3

File tree

13 files changed

+186
-59
lines changed

13 files changed

+186
-59
lines changed

articles/azure-mcp-server/includes/tools/global-parameters-list.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use the Azure MCP Server with Azure Key Vault keys.
44
keywords: azure mcp server, azmcp, key vault
55
author: diberry
66
ms.author: diberry
7-
ms.date: 05/14/2025
7+
ms.date: 07/23/2025
88
content_well_notification:
99
- AI-contribution
1010
ai-usage: ai-assisted
@@ -13,19 +13,29 @@ ms.custom: build-2025
1313
---
1414
## Tool parameters
1515

16-
The Azure MCP Server tools define parameters for data they need to complete tasks. For example, these parameters may include the subscription ID, an account name, or a resource group.
16+
The Azure MCP Server tools define parameters for the data they need to complete tasks. For example, these parameters might include the subscription ID, an account name, or a resource group.
1717

18-
The data used for these parameters may be included in the prompt you use to call a tool, or it may be established in the previous conversation context. If the data is available from the conversation context, the Azure MCP Server can use that information without requiring you to repeat it in every prompt. This context creates a more natural conversational experience while still ensuring all necessary data is available for the tools.
18+
You might include the data for these parameters in the prompt you use to call a tool, or the previous conversation context might establish the data. If the conversation context provides the data, the Azure MCP Server can use that information without requiring you to repeat it in every prompt. This context creates a more natural conversational experience while still ensuring all necessary data is available for the tools.
1919

20-
The parameters specific to each tool are documented in the tools reference articles. All of the tools also share the following global parameters.
20+
The tools reference articles document the parameters specific to each tool. All of the tools also share the following global parameters.
2121

2222
| Parameter | Description |
2323
|-----------------|-------------------|
24-
| **Subscription** | Azure subscription ID for target resources. Required. |
25-
| **Tenant Id** | Azure tenant ID for authentication. |
26-
| **Authentication method** | Authentication method ('credential', 'key', 'connectionString'). Default is 'credential'. |
27-
| **Maximum retries** | Maximum retry attempts for failed operations. Default is 3. |
28-
| **Retry delay** | Delay between retry attempts (seconds). Default is 2. |
29-
| **Retry delay maximum** | Maximum delay between retries (seconds). Default is 10. |
30-
| **Retry mode** | Retry strategy ('fixed' or 'exponential'). Default is 'exponential'. |
31-
| **Retry network timeout** | Network operation timeout (seconds). Default is 100. |
24+
| **Subscription** | [Azure subscription](/azure/cloud-adoption-framework/ready/azure-best-practices/initial-subscriptions) ID or name for target resources. This parameter identifies the Azure subscription that contains the resources you want to manage. You can use either the subscription GUID or the display name. Required for most operations. |
25+
| **Tenant Id** | [Azure tenant](/azure/cloud-adoption-framework/ready/landing-zone/design-area/azure-ad-define) ID for authentication. This parameter specifies the Microsoft Entra ID tenant to authenticate against. Can be either the GUID identifier or the display name of your Entra ID tenant. Optional - uses default tenant if not specified. |
26+
| **Authentication method** | [Authentication method](/entra/identity/authentication/concept-authentication-methods) to use for Azure operations. Options include `credential` (Azure CLI/managed identity), `key` (access key), or `connectionString`. Default is `credential`, which uses Azure CLI authentication or managed identity. |
27+
| **Maximum retries** | Maximum number of retry attempts for failed operations before giving up. Controls how many times the system attempts to retry a failed request. Default is 3 retries. |
28+
| **Retry delay** | Initial delay in seconds between retry attempts. For exponential backoff, this value is used as the base delay that gets multiplied on each retry. Default is 2 seconds. |
29+
| **Retry delay maximum** | Maximum delay in seconds between retries, regardless of the retry strategy. This parameter caps the delay time to prevent excessively long waits. Default is 10 seconds. |
30+
| **Retry mode** | Retry strategy to use when operations fail. `fixed` uses consistent delays between retries, while `exponential` increases the delay between each attempt. Default is `exponential` for better handling of temporary issues. |
31+
| **Retry network timeout** | Network operation timeout in seconds. When operations take longer than this timeout, they are canceled and might be retried if retries are enabled. Default is 100 seconds. |
32+
33+
Example prompts include:
34+
35+
- **Set subscription**: "Use subscription 'my-subscription-id' for all operations"
36+
- **Use tenant ID**: "Authenticate using tenant ID 'my-tenant-id'"
37+
- **Set authentication method**: "Use 'credential' authentication for this session"
38+
- **Configure retries**: "Set maximum retries to 5 with a 3-second delay
39+
- **Set retry mode**: "Use 'fixed' retry mode with a maximum delay of 5 seconds"
40+
- **Set network timeout**: "Set network timeout to 120 seconds for all operations"
41+
- **Configure retry parameters**: "Use exponential retry mode with a maximum of 4 retries and a delay of 2 seconds"

articles/azure-mcp-server/tools/tools.json

Lines changed: 117 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
11
{
2-
3-
42
"azure-app-configuration": {
53
"root": "azmcp appconfig",
64
"tools": [
@@ -1744,5 +1742,122 @@
17441742
]
17451743
}
17461744
]
1745+
},
1746+
"azure-bicepschema": {
1747+
"root": "azmcp bicepschema",
1748+
"tools": [
1749+
{
1750+
"name": "get --resource-type",
1751+
"description": "Execute the get --resource-type operation.",
1752+
"params": [
1753+
{
1754+
"name": "resource-type",
1755+
"description": "The resource type",
1756+
"required": true
1757+
}
1758+
]
1759+
}
1760+
]
1761+
},
1762+
"azure-grafana": {
1763+
"root": "azmcp grafana",
1764+
"tools": [
1765+
{
1766+
"name": "list --subscription",
1767+
"description": "Execute the list --subscription operation.",
1768+
"params": [
1769+
{
1770+
"name": "subscription",
1771+
"description": "The subscription",
1772+
"required": true
1773+
}
1774+
]
1775+
}
1776+
]
1777+
},
1778+
"azure-foundry": {
1779+
"root": "azmcp foundry",
1780+
"tools": [
1781+
{
1782+
"name": "models list",
1783+
"description": "List models.",
1784+
"params": []
1785+
},
1786+
{
1787+
"name": "models deploy --subscription",
1788+
"description": "Execute the models deploy --subscription operation.",
1789+
"params": [
1790+
{
1791+
"name": "subscription",
1792+
"description": "The subscription",
1793+
"required": true
1794+
}
1795+
]
1796+
},
1797+
{
1798+
"name": "models deployments list --endpoint",
1799+
"description": "Execute the models deployments list --endpoint operation.",
1800+
"params": [
1801+
{
1802+
"name": "endpoint",
1803+
"description": "The endpoint",
1804+
"required": true
1805+
}
1806+
]
1807+
}
1808+
]
1809+
},
1810+
"azure-quick-review": {
1811+
"root": "azmcp extension azqr",
1812+
"tools": [
1813+
{
1814+
"name": "generate report",
1815+
"description": "Generate compliance and security reports for Azure resources to identify non-compliant configurations.",
1816+
"params": [
1817+
{
1818+
"name": "subscription",
1819+
"description": "The Azure subscription ID or name to scan for compliance issues",
1820+
"required": true
1821+
},
1822+
{
1823+
"name": "resource-group",
1824+
"description": "The name of the Azure resource group to scope the scan to a specific resource group",
1825+
"required": false
1826+
}
1827+
]
1828+
}
1829+
]
1830+
},
1831+
"azure-azureterraformbestpractices": {
1832+
"root": "azmcp azureterraformbestpractices",
1833+
"tools": [
1834+
{
1835+
"name": "get",
1836+
"description": "Execute the get operation.",
1837+
"params": []
1838+
}
1839+
]
1840+
},
1841+
"azure-bestpractices": {
1842+
"root": "azmcp bestpractices",
1843+
"tools": [
1844+
{
1845+
"name": "azurefunctions get-code-generation",
1846+
"description": "Execute the azurefunctions get-code-generation operation.",
1847+
"params": [],
1848+
"status": "new"
1849+
},
1850+
{
1851+
"name": "azurefunctions get-deployment",
1852+
"description": "Execute the azurefunctions get-deployment operation.",
1853+
"params": [],
1854+
"status": "new"
1855+
},
1856+
{
1857+
"name": "general get",
1858+
"description": "Get general.",
1859+
"params": []
1860+
}
1861+
]
17471862
}
17481863
}

articles/includes/dotnet-all.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@
8686
| Playwright | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Developer.Playwright/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Developer.Playwright-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.Playwright_1.0.0-beta.1/sdk/loadtestservice/Azure.Developer.Playwright/) |
8787
| Playwright NUnit | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Developer.Playwright.NUnit/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Developer.Playwright.NUnit-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.Playwright.NUnit_1.0.0-beta.1/sdk/loadtestservice/Azure.Developer.Playwright.NUnit/) |
8888
| Programmable Connectivity | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Communication.ProgrammableConnectivity/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Communication.ProgrammableConnectivity-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Communication.ProgrammableConnectivity_1.0.0-beta.1/sdk/communication/Azure.Communication.ProgrammableConnectivity/) |
89-
| Provisioning | NuGet [1.2.1](https://www.nuget.org/packages/Azure.Provisioning/1.2.1) | [docs](/dotnet/api/overview/azure/Provisioning-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning_1.2.1/sdk/provisioning/Azure.Provisioning/) |
89+
| Provisioning | NuGet [1.3.0](https://www.nuget.org/packages/Azure.Provisioning/1.3.0) | [docs](/dotnet/api/overview/azure/Provisioning-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning_1.3.0/sdk/provisioning/Azure.Provisioning/) |
9090
| Provisioning - Resources | NuGet [0.2.0](https://www.nuget.org/packages/Azure.Provisioning.Resources/0.2.0) | [docs](/dotnet/api/overview/azure/Provisioning.Resources-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [0.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Resources_0.2.0/sdk/provisioning/Azure.Provisioning.Resources/) |
9191
| Purview Account | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Analytics.Purview.Account/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Analytics.Purview.Account-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Purview.Account_1.0.0-beta.1/sdk/purview/Azure.Analytics.Purview.Account/) |
9292
| Purview Administration | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Analytics.Purview.Administration/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Analytics.Purview.Administration-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Purview.Administration_1.0.0-beta.1/sdk/purview/Azure.Analytics.Purview.Administration/) |
@@ -364,7 +364,7 @@
364364
| Resource Management - Sitemanager | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.SiteManager/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SiteManager-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SiteManager_1.0.0-beta.1/sdk/sitemanager/Azure.ResourceManager.SiteManager/) |
365365
| Resource Management - Sphere | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Sphere/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Sphere-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sphere_1.0.1/sdk/sphere/Azure.ResourceManager.Sphere/) |
366366
| Resource Management - Spring App Discovery | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.SpringAppDiscovery/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.SpringAppDiscovery-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SpringAppDiscovery_1.0.0-beta.2/sdk/springappdiscovery/Azure.ResourceManager.SpringAppDiscovery/) |
367-
| Resource Management - SQL | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.3.0)<br>NuGet [1.4.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.4.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Sql-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.3.0/sdk/sqlmanagement/Azure.ResourceManager.Sql/)<br>GitHub [1.4.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.4.0-beta.2/sdk/sqlmanagement/Azure.ResourceManager.Sql/) |
367+
| Resource Management - SQL | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.3.0)<br>NuGet [1.4.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.4.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Sql-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.3.0/sdk/sqlmanagement/Azure.ResourceManager.Sql/)<br>GitHub [1.4.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.4.0-beta.3/sdk/sqlmanagement/Azure.ResourceManager.Sql/) |
368368
| Resource Management - SQL Virtual Machine | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.SqlVirtualMachine/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SqlVirtualMachine-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SqlVirtualMachine_1.1.1/sdk/sqlvirtualmachine/Azure.ResourceManager.SqlVirtualMachine/) |
369369
| Resource Management - Standby Pool | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.StandbyPool/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.StandbyPool-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StandbyPool_1.1.0/sdk/standbypool/Azure.ResourceManager.StandbyPool/) |
370370
| Resource Management - Storage | NuGet [1.4.4](https://www.nuget.org/packages/Azure.ResourceManager.Storage/1.4.4) | [docs](/dotnet/api/overview/azure/ResourceManager.Storage-readme) | GitHub [1.4.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Storage_1.4.4/sdk/storage/Azure.ResourceManager.Storage/) |
@@ -373,6 +373,7 @@
373373
| Resource Management - Storage Mover | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.StorageMover/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.StorageMover-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StorageMover_1.2.1/sdk/storagemover/Azure.ResourceManager.StorageMover/) |
374374
| Resource Management - Storage Pool | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.StoragePool/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.StoragePool-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StoragePool_1.1.1/sdk/storagepool/Azure.ResourceManager.StoragePool/) |
375375
| Resource Management - Storage Sync | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.StorageSync/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.StorageSync-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StorageSync_1.3.0/sdk/storagesync/Azure.ResourceManager.StorageSync/) |
376+
| Resource Management - Storagediscovery | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.StorageDiscovery/1.0.0-beta.1) | | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StorageDiscovery_1.0.0-beta.1/sdk/storagediscovery/Azure.ResourceManager.StorageDiscovery/) |
376377
| Resource Management - Stream Analytics | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.StreamAnalytics/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.StreamAnalytics-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StreamAnalytics_1.2.1/sdk/streamanalytics/Azure.ResourceManager.StreamAnalytics/) |
377378
| Resource Management - Subscriptions | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Subscription/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Subscription-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Subscription_1.1.1/sdk/subscription/Azure.ResourceManager.Subscription/) |
378379
| Resource Management - Support | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Support/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Support-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Support_1.1.1/sdk/support/Azure.ResourceManager.Support/) |

0 commit comments

Comments
 (0)