Skip to content

Commit 1d61b6d

Browse files
committed
Merge branch 'diberry/0722-mcp' of https://github.com/diberry/azure-dev-docs-pr into diberry/0722-mcp
2 parents 86feb3c + 9844632 commit 1d61b6d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+2087
-470
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -330,6 +330,11 @@
330330
"redirect_url": "/azure/developer/javascript/how-to/create-static-web-app",
331331
"redirect_document_id": false
332332
},
333+
{
334+
"source_path": "articles/javascript/how-to/create-static-web-app.md",
335+
"redirect_url": "/azure/static-web-apps/",
336+
"redirect_document_id": false
337+
},
333338
{
334339
"source_path": "articles/javascript/how-to/with-web-app/static-web-app-with-swa-cli.md",
335340
"redirect_url": "/azure/static-web-apps/add-api",

CODEOWNERS

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,20 @@
2020
/articles/python/ @bobtabor-msft
2121
/articles/go/ @bobtabor-msft
2222
/articles/cpp/ @ronniegeraghty @antkmsft
23+
/articles/rust/ @ronniegeraghty @heaths @diberry
24+
/articles/javascript/ @diberry
2325

2426
# Tools
25-
/articles/azure-cli/ @alexwolfmsft
26-
/articles/typespect/ @diberry
27+
/articles/azure-developer-cli/ @alexwolfmsft @kristenwomack
28+
/articles/typespec/ @diberry
29+
/articles/azure-mcp-server/ @ms-johnalex @sandeep-sen
30+
/articles/azure-mcp-server/tools @diberry @sandeep-sen
2731

2832
# Azure SDK authentication topics
2933
/articles/go/sdk/authentication/ @scottaddie @chlowell
30-
/articles/java/sdk/authentication/ @scottaddie @g2vinay
34+
/articles/java/sdk/authentication/ @scottaddie @g2vinay @anannya03
3135
/articles/javascript/sdk/authentication/ @scottaddie @KarishmaGhiya @minhanh-phan @maorleger
3236
/articles/python/sdk/authentication/ @scottaddie @pvaneck @xiangyan99
3337
/articles/python/sdk/authorization/ @scottaddie @pvaneck @xiangyan99
3438
/articles/cpp/sdk/authentication/ @scottaddie @antkmsft @ronniegeraghty
39+
/articles/rust/sdk/authentication/ @scottaddie @ronniegeraghty @chlowell @heaths

articles/azure-developer-cli/container-apps-workflows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Use the `container-app-upsert` strategy when:
4141
Here's how to use the `container-app-upsert` strategy in your Bicep files:
4242

4343
```bicep
44-
module api 'br/public:avm/ptn/`azd`/container-app-upsert:0.1.1' = {
44+
module api 'br/public:avm/ptn/azd/container-app-upsert:0.1.2' = {
4545
name: 'api'
4646
params: {
4747
name: 'my-api'

articles/azure-mcp-server/TOC.yml

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,18 +17,28 @@ items:
1717
href: tools/app-configuration.md
1818
- name: Azure best practices
1919
href: tools/azure-best-practices.md
20+
- name: Azure Bicep schema
21+
href: tools/azure-bicep-schema.md
2022
- name: Azure Cache for Redis
2123
href: tools/azure-cache-for-redis.md
2224
- name: Azure CLI Extension
2325
href: tools/azure-cli-extension.md
26+
- name: Azure Cosmos DB
27+
href: tools/cosmos-db.md
2428
- name: Azure Data Explorer
2529
href: tools/azure-data-explorer.md
2630
- name: Azure DB for PostgreSQL
2731
href: tools/postgresql.md
28-
- name: Azure Cosmos DB
29-
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
3036
- name: Azure Key Vault
3137
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
3242
- name: Azure Monitor
3343
href: tools/monitor.md
3444
- name: Azure RBAC
@@ -37,6 +47,8 @@ items:
3747
href: tools/azure-native-isv.md
3848
- name: Azure Service Bus
3949
href: tools/service-bus.md
50+
- name: Azure SQL
51+
href: tools/azure-sql.md
4052
- name: Azure Storage
4153
href: tools/storage.md
4254
- name: Resource Group

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

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,18 +13,24 @@ 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. |
1718
| [Azure best practices](../../tools/azure-best-practices.md) | Get guidance on Azure Functions development, deployment, and Azure SDK usage. |
1819
| [Azure Cache for Redis](../../tools/azure-cache-for-redis.md) | Manage Azure Cache for Redis instances, Redis clusters, and access policies. |
1920
| [Azure CLI Extension](../../tools/azure-cli-extension.md) | Execute Azure CLI commands within the MCP server. |
20-
| [Azure Data Explorer](../../tools/azure-data-explorer.md) | Work with Azure Data Explorer clusters, databases, tables, and queries. |
21-
| [Azure DB for PostgreSQL](../../tools/postgresql.md) | Manage Azure Database for PostgreSQL servers, databases, and tables. |
2221
| [Azure Cosmos DB](../../tools/cosmos-db.md) | Work with Azure Cosmos DB accounts, databases, containers, and documents. |
23-
| [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. |
2429
| [Azure Monitor](../../tools/monitor.md) | Query Azure Monitor logs and metrics. |
25-
| [Azure RBAC](../../tools/azure-rbac.md) | View and manage Azure role-based access control assignments. |
2630
| [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. |
2732
| [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. |
2834
| [Azure Storage](../../tools/storage.md) | List Azure Storage accounts, containers, blobs, and tables. |
2935
| [Resource Groups](../../tools/resource-group.md) | List Azure resource groups. |
3036
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
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: 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)
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Azure Managed Grafana Tools - Azure MCP Server
3+
description: Learn how to use the Azure MCP Server with Azure Managed Grafana to monitor and visualize your metrics and logs.
4+
keywords: azure mcp server, azmcp, azure managed grafana, monitoring, dashboards, visualization
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 Managed Grafana tools for the Azure MCP Server
14+
15+
The Azure MCP Server allows you to manage Azure resources, including Azure Managed Grafana workspaces using natural language prompts. This enables you to quickly manage your monitoring and visualization resources without remembering complex syntax.
16+
17+
[Azure Managed Grafana](/azure/managed-grafana/) is a fully managed service that offers Grafana dashboards as a service. It enables you to analyze metrics, logs, and traces without having to worry about setting up, maintaining, or scaling the Grafana infrastructure.
18+
19+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
20+
21+
## List Grafana workspaces
22+
23+
<!-- azmcp grafana list -->
24+
25+
Lists all Azure Managed Grafana workspaces in your subscription. This command helps you view and manage your Grafana workspace resources across your Azure environment.
26+
27+
Example prompts include:
28+
29+
- **Show all workspaces**: "Show me all Grafana workspaces in my subscription"
30+
- **List monitoring resources**: "What Grafana workspaces do I have available?"
31+
- **Find visualization dashboards**: "List all my Azure Managed Grafana resources"
32+
- **Check workspace status**: "Are there any Grafana workspaces in my dev subscription?"
33+
- **Dashboard inventory**: "I need to see all Grafana workspace resources in my account"
34+
35+
## Related content
36+
37+
- [What are the Azure MCP Server tools?](index.md)
38+
- [Get started using Azure MCP Server](../get-started.md)
39+
- [Azure Managed Grafana documentation](/azure/managed-grafana/)
40+
- [Azure Monitor overview](/azure/azure-monitor/overview)
41+
- [Data visualization in Azure](/azure/architecture/best-practices/monitoring)

0 commit comments

Comments
 (0)