Skip to content

Commit eb6d282

Browse files
Merge pull request #7597 from MicrosoftDocs/main
Auto Publish – main to live - 2025-07-29 17:00 UTC
2 parents 93e6762 + c8ce155 commit eb6d282

25 files changed

+1994
-57
lines changed

articles/azure-mcp-server/TOC.yml

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,18 +15,30 @@ items:
1515
href: tools/ai-search.md
1616
- name: Azure App Configuration
1717
href: tools/app-configuration.md
18+
- name: Azure best practices
19+
href: tools/azure-best-practices.md
20+
- name: Azure Bicep schema
21+
href: tools/azure-bicep-schema.md
1822
- name: Azure Cache for Redis
1923
href: tools/azure-cache-for-redis.md
2024
- name: Azure CLI Extension
2125
href: tools/azure-cli-extension.md
26+
- name: Azure Cosmos DB
27+
href: tools/cosmos-db.md
2228
- name: Azure Data Explorer
2329
href: tools/azure-data-explorer.md
2430
- name: Azure DB for PostgreSQL
2531
href: tools/postgresql.md
26-
- name: Azure Cosmos DB
27-
href: tools/cosmos-db.md
32+
- name: Azure Foundry
33+
href: tools/azure-foundry.md
34+
- name: Azure Grafana
35+
href: tools/azure-grafana.md
2836
- name: Azure Key Vault
2937
href: tools/key-vault-key.md
38+
- name: Azure Kubernetes Service
39+
href: tools/azure-aks.md
40+
- name: Azure Load Testing
41+
href: tools/azure-load-testing.md
3042
- name: Azure Monitor
3143
href: tools/monitor.md
3244
- name: Azure RBAC
@@ -35,9 +47,13 @@ items:
3547
href: tools/azure-native-isv.md
3648
- name: Azure Service Bus
3749
href: tools/service-bus.md
50+
- name: Azure SQL
51+
href: tools/azure-sql.md
3852
- name: Azure Storage
3953
href: tools/storage.md
4054
- name: Resource Group
4155
href: tools/resource-group.md
4256
- name: Subscription
4357
href: tools/subscription.md
58+
- name: Terraform best practices for Azure
59+
href: tools/azure-terraform-best-practices.md

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

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
ms.author: diberry
44
ms.service: azure-mcp-server
55
ms.topic: include
6-
ms.date: 07/01/2025
6+
ms.date: 07/22/2025
77
---
88

99
## Available tools
@@ -13,17 +13,25 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
1313
| Tool | Description |
1414
|------|--------------|
1515
| [Azure AI Search](../../tools/ai-search.md) | Manage Azure AI Search resources, including search services, indexes, and queries. |
16+
| [Azure Bicep schema](../../tools/azure-bicep-schema.md) | Retrieve Bicep schemas for Azure resources to use in Infrastructure as Code templates. |
1617
| [Azure App Configuration](../../tools/app-configuration.md) | Manage centralized application settings and feature flags. |
18+
| [Azure best practices](../../tools/azure-best-practices.md) | Get guidance on Azure Functions development, deployment, and Azure SDK usage. |
1719
| [Azure Cache for Redis](../../tools/azure-cache-for-redis.md) | Manage Azure Cache for Redis instances, Redis clusters, and access policies. |
1820
| [Azure CLI Extension](../../tools/azure-cli-extension.md) | Execute Azure CLI commands within the MCP server. |
19-
| [Azure Data Explorer](../../tools/azure-data-explorer.md) | Work with Azure Data Explorer clusters, databases, tables, and queries. |
20-
| [Azure DB for PostgreSQL](../../tools/postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
2121
| [Azure Cosmos DB](../../tools/cosmos-db.md) | Work with Azure Cosmos DB accounts, databases, containers, and documents. |
22-
| [Azure Key Vault keys](../../tools/key-vault-key.md) | Manage keys in Azure Key Vault. |
22+
| [Azure Data Explorer](../../tools/azure-data-explorer.md) | Work with Azure Data Explorer clusters, databases, tables, and queries. |
23+
| [Azure Database for PostgreSQL](../../tools/postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
24+
| [Azure Foundry](../../tools/azure-foundry.md) | Work with Azure AI Foundry models, deployments, and endpoints. |
25+
| [Azure Grafana](../../tools/azure-grafana.md) | List Grafana workspaces.|
26+
| [Azure Key Vault](../../tools/key-vault-key.md) | Manage keys, secrets, certificates in Azure Key Vault. |
27+
| [Azure Kubernetes Service](../../tools/azure-aks.md) | List Azure Kubernetes Service clusters. |
28+
| [Azure Load Testing](../../tools/azure-load-testing.md) | Create, run, and see load testing. |
2329
| [Azure Monitor](../../tools/monitor.md) | Query Azure Monitor logs and metrics. |
24-
| [Azure RBAC](../../tools/azure-rbac.md) | View and manage Azure role-based access control assignments. |
2530
| [Azure Native ISV](../../tools/azure-native-isv.md) | Work with Azure Native ISV services, including Datadog integration for monitoring and observability. |
31+
| [Azure RBAC](../../tools/azure-rbac.md) | View and manage Azure role-based access control assignments. |
2632
| [Azure Service Bus](../../tools/service-bus.md) | Work with Azure Service Bus messaging services. |
33+
| [Azure SQL](../../tools/azure-sql.md) | Work with Azure SQL Database servers, databases, firewall rules, and elastic pools. |
2734
| [Azure Storage](../../tools/storage.md) | List Azure Storage accounts, containers, blobs, and tables. |
2835
| [Resource Groups](../../tools/resource-group.md) | List Azure resource groups. |
2936
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
37+
| [Terraform best practices for Azure](../../tools/azure-terraform-best-practices.md) | Get guidance on implementing Terraform for Azure resources. |
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: Azure Kubernetes Service Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure Kubernetes Service (AKS) to manage your Kubernetes clusters and containers.
4+
keywords: azure mcp server, azmcp, azure kubernetes service, aks, kubernetes, containers
5+
ai-usage: ai-assisted
6+
content_well_notification:
7+
- AI-contribution
8+
author: diberry
9+
ms.author: diberry
10+
ms.service: azure-mcp-server
11+
ms.topic: reference
12+
ms.date: 7/22/2025
13+
---
14+
15+
# Azure Kubernetes Service tools for the Azure MCP Server
16+
17+
The Azure MCP Server lets you manage Azure resources, including Azure Kubernetes Service (AKS) clusters, using natural language prompts. This feature enables you to quickly manage your container workloads without needing to remember complex syntax.
18+
19+
[Azure Kubernetes Service (AKS)](/azure/aks/intro-kubernetes) is a managed container orchestration service that simplifies Kubernetes deployment and management. AKS offers serverless Kubernetes, integrated CI/CD, and enterprise-grade security and governance. With AKS, you can focus on application development rather than infrastructure management.
20+
21+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
22+
23+
24+
## List clusters
25+
26+
<!--
27+
azmcp aks cluster list --subscription
28+
-->
29+
30+
Lists all Azure Kubernetes Service (AKS) clusters in the specified subscription. Use this command to quickly inventory and monitor your AKS deployments across your Azure environment.
31+
32+
Example prompts include:
33+
34+
- **List all clusters**: "Show me all my AKS clusters in my subscription"
35+
- **View cluster inventory**: "Can you list the Kubernetes clusters in resource group 'container-rg' for subscription 'dev-123'?"
36+
- **Check cluster status**: "AKS clusters... dev environment... quick overview"
37+
- **Cluster overview**: "I need a complete inventory of all our Kubernetes deployments across our enterprise subscription with their node counts and versions."
38+
- **Find clusters**: "List clusters in the East US region only"
39+
- **Monitor deployments**: "What's the status of our production AKS clusters? Are they all running properly?"
40+
41+
42+
| Parameter | Required or optional | Description |
43+
|-----------|-------------|-------------|
44+
| Subscription | Required | The ID or name of your Azure subscription containing the AKS clusters. |
45+
46+
47+
## Related content
48+
49+
- [What are the Azure MCP Server tools?](index.md)
50+
- [Get started using Azure MCP Server](../get-started.md)
51+
- [Azure Kubernetes Service documentation](/azure/aks/)
52+
- [Kubernetes best practices](/azure/aks/best-practices)
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Azure best practices tools - Azure MCP Server
3+
description: Use the Azure best practices tools in Azure MCP Server to get guidance on Azure Functions development, deployment, and Azure SDK usage.
4+
keywords: azure mcp server, azmcp, best practices
5+
ms.service: azure-mcp-server
6+
content_well_notification:
7+
- AI-contribution
8+
ai-usage: ai-assisted
9+
ms.topic: reference
10+
ms.date: 07/22/2025
11+
author: diberry
12+
ms.author: diberry
13+
---
14+
15+
# Azure best practices tools
16+
17+
This article describes the best practices tools available in Azure MCP Server that provide guidance on Azure service usage, development, and deployment.
18+
19+
Azure best practices tools offer recommendations for Azure Functions development, deployment strategies, and Azure SDK implementation patterns to help you build robust, secure, and efficient Azure applications.
20+
21+
22+
## Azure Functions
23+
24+
## Get code generation best practices
25+
26+
<!-- azmcp bestpractices azurefunctions get-code-generation -->
27+
28+
Returns best practices for [Azure Functions](/azure/azure-functions/) code generation. Use this tool to get guidance on writing efficient and maintainable Azure Functions code.
29+
30+
Example prompts include:
31+
32+
- **General best practices**: "What are the best practices for Azure Functions code generation?"
33+
- **Show recommendations**: "Show me code generation best practices for Azure Functions."
34+
- **Development guidance**: "I need guidance on writing Azure Functions code, what should I follow?"
35+
- **Recommended patterns**: "What are the recommended patterns for Azure Functions development?"
36+
- **Efficient coding**: "Help me understand how to write efficient Azure Functions code."
37+
38+
### Get deployment best practices
39+
40+
<!-- azmcp bestpractices azurefunctions get-deployment -->
41+
42+
Returns best practices for Azure Functions deployment. Use this tool to get guidance on deploying Azure Functions applications efficiently and securely.
43+
44+
Example prompts include:
45+
46+
- **Deployment best practices**: "What are the best practices for deploying Azure Functions?"
47+
- **CI/CD setup**: "How should I set up CI/CD for my Azure Functions app?"
48+
- **Deployment recommendations**: "Show me deployment recommendations for Azure Functions."
49+
- **Production deployment**: "What's the best way to deploy Azure Functions to production?"
50+
- **Secure pipeline**: "I need guidance on setting up a secure deployment pipeline for Azure Functions."
51+
52+
53+
## Azure SDK
54+
55+
## Get best practices
56+
57+
<!-- azmcp bestpractices general get -->
58+
59+
Returns best practices for secure, production-grade Azure SDK usage. Use this tool to get guidance on implementing Azure services in your applications.
60+
61+
Example prompts include:
62+
63+
- **General best practices**: "What are the best practices for using Azure SDKs?"
64+
- **Implementation guidance**: "Show me guidance on implementing Azure services in my application"
65+
- **Authentication handling**: "How should I handle authentication with Azure SDKs?"
66+
- **Connection management**: "What's the recommended way to manage connections with Azure services?"
67+
- **Secure implementation**: "I need help implementing Azure services securely in my application"
68+
69+
70+
## Related resources
71+
72+
- [Azure Functions documentation](/azure/azure-functions/)
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: Azure Bicep Schema Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure Bicep Schema to retrieve the latest API versions and properties for Azure resources in Bicep templates.
4+
keywords: azure mcp server, azmcp, azure bicep, bicep schema, arm templates, infrastructure as code
5+
ms.service: azure-mcp-server
6+
ms.topic: reference
7+
ms.date: 07/22/2025
8+
content_well_notification:
9+
- AI-contribution
10+
ai-usage: ai-assisted
11+
---
12+
13+
# Azure Bicep Schema tools for the Azure MCP Server
14+
15+
The Azure MCP Server enables you to manage Azure resources, including Azure Bicep schemas, with natural language prompts. With this capability, you can quickly retrieve the latest API versions and property definitions for your Infrastructure as Code templates without needing to remember complex syntax.
16+
17+
[Azure Bicep](/azure/azure-resource-manager/bicep/) is a domain-specific language (DSL) that simplifies the authoring experience for Azure Resource Manager templates. Bicep offers concise syntax, reliable type safety, and support for all resource types and API versions.
18+
19+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
20+
21+
## Get Bicep Resource Schema
22+
23+
<!-- azmcp bicepschema get -->
24+
25+
Gets the Bicep schema for the most recent apiVersion of an Azure resource. This operation helps you ensure your Bicep templates use the correct properties and values when defining Azure resources.
26+
27+
Example prompts include:
28+
29+
- **Get storage account schema**: "Get me the Bicep schema for Microsoft.Storage/storageAccounts"
30+
- **Find service properties**: "How can I use Bicep to create an Azure OpenAI service?"
31+
- **Check API version**: "What's the latest apiVersion for Microsoft.KeyVault/vaults?"
32+
- **Need schema help**: "I'm creating a Bicep template for Microsoft.Cognitive/accounts"
33+
- **Request schema guidance**: "Show me the properties for Microsoft.Web/sites"
34+
35+
| Parameter | Required or optional | Description |
36+
|-----------|-------------|-------------|
37+
| Resource type | Required | The Azure resource type in format '{ResourceProvider}/{ResourceType}' (e.g., 'Microsoft.Storage/storageAccounts', 'Microsoft.Compute/virtualMachines') |
38+
39+
## Related content
40+
41+
- [What are the Azure MCP Server tools?](index.md)
42+
- [Get started using Azure MCP Server](../get-started.md)
43+
- [Azure Bicep documentation](/azure/azure-resource-manager/bicep/)
44+
- [Azure Resource Manager template reference](/azure/templates/)
Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
title: Azure AI Foundry Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure AI Foundry to manage your AI models and deployments.
4+
keywords: azure mcp server, azmcp, azure ai foundry, ai models, model deployment
5+
ms.service: azure-mcp-server
6+
ms.topic: reference
7+
ms.date: 07/24/2025
8+
content_well_notification:
9+
- AI-contribution
10+
ai-usage: ai-assisted
11+
---
12+
13+
# Azure AI Foundry tools for the Azure MCP Server
14+
15+
The Azure MCP Server enables you to manage Azure resources, including Azure AI Foundry models and deployments, with natural language prompts. This capability helps you quickly manage your AI models without needing to remember complex syntax.
16+
17+
[Azure AI Foundry](/azure/ai-foundry/) is a platform for deploying and managing custom AI models in Azure. It provides tools and services for training, fine-tuning, deploying, and monitoring AI models in production environments. With Azure AI Foundry, you can more easily incorporate AI capabilities into your applications.
18+
19+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
20+
21+
## List available models
22+
23+
<!-- azmcp foundry models list -->
24+
25+
Lists all available AI models in Azure AI Foundry. Use this command to view all models that you can deploy or use in your Azure environment.
26+
27+
Example prompts include:
28+
29+
- **View all models**: "Show me all available AI models in Azure AI Foundry"
30+
- **Filter by free usage**: "List all free models available for prototyping in Azure AI Foundry that I can use in the playground"
31+
- **Filter by free usage**: "List all free models available for prototyping in Azure AI Foundry"
32+
- **Filter by publisher**: "Show me models published by Microsoft in Azure AI Foundry"
33+
- **Filter by license**: "What models with Apache license are available in Azure AI Foundry?"
34+
- **Search by name**: "Find the llama model in Azure AI Foundry"
35+
36+
| Parameter | Required or optional | Description |
37+
|-----------|-------------|-------------|
38+
| Search for free playground | Optional | If set to true, returns a list of models from Azure AI Foundry that can also be used with GitHub inference endpoint and GitHub PAT token. If false, returns a list of models from Azure AI Foundry, regardless of GitHub support. To learn more, see [GitHub Models](https://docs.github.com/en/github-models/use-github-models/prototyping-with-ai-models#experimenting-with-ai-models-in-the-playground).|
39+
| Publisher name | Optional | A filter to specify the publisher of the models to retrieve. |
40+
| License name | Optional | A filter to specify the license type of the models to retrieve. |
41+
| Model name | Optional | The name of the model to search for. |
42+
43+
## Deploy a model
44+
45+
<!-- azmcp foundry models deploy -->
46+
47+
Deploys an AI model to your Azure environment. Use this command to deploy selected models from Azure AI Foundry and make them available for use in your applications.
48+
49+
Example prompts include:
50+
51+
- **Deploy with required parameters**: "Deploy GPT-4 model in OpenAI format to my ai-services account in ai-projects resource group with subscription dev-subscription"
52+
- **Specify deployment name**: "Set up a deployment named text-embedding for the Ada embedding model in my AI services account with Standard SKU"
53+
- **Include model version**: "Deploy version 2 of Llama model from Meta to my Azure AI services account with scale capacity of 3"
54+
- **Deploy to specific resource group**: "Create a deployment named content-generation with GPT-4 model in my ai-central service in resource group ml-experiments"
55+
- **Configure scaling**: "Deploy Claude model to my Azure AI service with auto-scaling enabled and maximum capacity of 5"
56+
57+
| Parameter | Required or optional | Description |
58+
|-----------|-------------|-------------|
59+
| Deployment-name | Required | A unique name for this model deployment |
60+
| Model name | Required | The name of the model to deploy |
61+
| Model format | Required | The format of the model (for example, 'OpenAI', 'Meta', 'Microsoft') |
62+
| Azure AI services name | Required | The name of the Azure AI services account to deploy to |
63+
| Resource group | Required | The name of the Azure resource group where the model will be deployed |
64+
| Model version | Optional | The version of the model to deploy |
65+
| Model source | Optional | The source of the model |
66+
| Scale type | Optional | The scale type for the deployment |
67+
| Scale capacity | Optional | The scale capacity for the deployment |
68+
| Sku name | Optional | The SKU name for the deployment |
69+
| Sku capacity | Optional | The SKU capacity for the deployment |
70+
71+
## List model deployments
72+
73+
<!-- azmcp foundry models deployments list -->
74+
75+
Lists all model deployments associated with a specific Azure AI Foundry endpoint. Use this command to monitor and manage your active model deployments. In the following example prompts, replace `https://my-example-resource.openai.azure.com` with your actual Azure AI Foundry endpoint URL.
76+
77+
Example prompts include:
78+
79+
- **List deployments on production**: "Show me all model deployments on my https://my-example-resource.openai.azure.com endpoint"
80+
- **Check specific endpoint**: "What models are currently deployed to the https://my-example-resource.openai.azure.com endpoint?"
81+
- **View regional deployments**: "List all deployments in my https://my-example-resource.openai.azure.com endpoint"
82+
- **Check deployment status**: "Show me the status of all models deployed to our https://my-example-resource.openai.azure.com endpoint"
83+
- **See active models**: "What AI models are running on our https://my-example-resource.openai.azure.com endpoint right now?"
84+
85+
| Parameter | Required or optional | Description |
86+
|-----------|-------------|-------------|
87+
| Endpoint | Required | The endpoint URL for the Azure AI service |
88+
89+
90+
## Related content
91+
92+
- [What are the Azure MCP Server tools?](index.md)
93+
- [Get started using Azure MCP Server](../get-started.md)
94+
- [Azure AI Foundry documentation](/azure/ai-foundry/)
95+
- [Azure AI Services overview](/azure/ai-services/)
96+
- [Deploy and consume models](/azure/ai-foundry/concepts/deployments-overview)

0 commit comments

Comments
 (0)