🔎 Azure AI Search (search engine/vector database)

• List Azure AI Search services
• List indexes and look at their schema and configuration
• Query search indexes

⚙️ Azure App Configuration

• List App Configuration stores
• Manage key-value pairs
• Handle labeled configurations
• Lock/unlock configuration settings

🛡️ Azure Best Practices

• Get secure, production-grade Azure SDK best practices for effective code generation.

🖥️ Azure CLI Extension

• Execute Azure CLI commands directly
• Support for all Azure CLI functionality
• JSON output formatting
• Cross-platform compatibility

📊 Azure Cosmos DB (NoSQL Databases)

• List Cosmos DB accounts
• List and query databases
• Manage containers and items
• Execute SQL queries against containers

🧮 Azure Data Explorer

• List Azure Data Explorer clusters
• List databases
• List tables
• Get schema for a table
• Sample rows from a table
• Query using KQL

🐘 Azure Database for PostgreSQL - Flexible Server

• List and query databases.
• List and get schema for tables.
• List, get configuration and get parameters for servers.

🛠️ Azure Developer CLI (azd) Extension

• Execute Azure Developer CLI commands directly
• Support for template discovery, template initialization, provisioning and deployment
• Cross-platform compatibility

🧮 Azure Foundry

• List Azure Foundry models
• Deploy foundry models
• List foundry model deployments

🚀 Azure Managed Grafana

• List Azure Managed Grafana

🔑 Azure Key Vault

• List and create certificates
• List and create keys
• List and create secrets

☸️ Azure Kubernetes Service (AKS)

• List Azure Kubernetes Service clusters

📦 Azure Load Testing

• List, create load test resources
• List, create load tests
• Get, list, (create) run and rerun, update load test runs

🏪 Azure Marketplace

• Get details about Marketplace products

📈 Azure Monitor

Log Analytics

• List Log Analytics workspaces
• Query logs using KQL
• List available tables

Health Models

• Get health of an entity

Metrics

• Query Azure Monitor metrics for resources with time series data
• List available metric definitions for resources

⚙️ Azure Native ISV Services

• List Monitored Resources in a Datadog Monitor

🛡️ Azure Quick Review CLI Extension

• Scan Azure resources for compliance related recommendations

🔴 Azure Redis Cache

• List Redis Cluster resources
• List databases in Redis Clusters
• List Redis Cache resources
• List access policies for Redis Caches

🏗️ Azure Resource Groups

• List resource groups

🎭 Azure Role-Based Access Control (RBAC)

• List role assignments

🚌 Azure Service Bus

• Examine properties and runtime information about queues, topics, and subscriptions

🗄️ Azure SQL Database

• Show database details and properties
• List the details and properties of all databases
• List SQL server firewall rules
• List elastic pools and their configurations

💾 Azure Storage

• List Storage accounts
• Manage blob containers and blobs
• List and query Storage tables
• List paths in Data Lake file systems
• Get container properties and metadata

📋 Azure Subscription

• List Azure subscriptions

🏗️ Azure Terraform Best Practices

• Get secure, production-grade Azure Terraform best practices for effective code generation and command execution

📊 Azure Workbooks

• List workbooks in resource groups
• Create new workbooks with custom visualizations
• Update existing workbook configurations
• Get workbook details and metadata
• Delete workbooks when no longer needed

🏗️ Bicep

• Get the Bicep schema for specific Azure resource types

Agents and models can discover and learn best practices and usage guidelines for the azd MCP tool. For more information, see AZD Best Practices.

NPX

If you use the default package spec of @azure/mcp@latest, npx will look for a new version on each server start. If you use just @azure/mcp, npx will continue to use its cached version until its cache is cleared.

NPM

If you globally install the cli via npm install -g @azure/mcp it will use the installed version until you manually update it with npm update -g @azure/mcp.

Docker

There is no version update built into the docker image. To update, just pull the latest from the repo and repeat the docker installation instructions.

VS Code

Installation in VS Code should be in one of the previous forms and the update instructions are the same. If you installed the mcp server with the npx command and -y @azure/mcp@latest args, npx will check for package updates each time VS Code starts the server. Using a docker container in VS Code has the same no-update limitation described above.

🐋 Docker Install Steps (Optional)

Microsoft publishes an official Azure MCP Server Docker container on the Microsoft Artifact Registry.

For a step-by-step Docker installation, follow these instructions:

1. Create an .env file with environment variables that match one of the EnvironmentCredential sets. For example, a .env file using a service principal could look like:

   AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
   AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
   AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
   

2. Add .vscode/mcp.json or update existing MCP configuration. Replace /full/path/to/.env with a path to your .env file.

   {
     "servers": {
       "Azure MCP Server": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "--env-file",
           "/full/path/to/.env"
           "mcr.microsoft.com/azure-sdk/azure-mcp:latest",
         ]
       }
     }
   }
   

Optionally, use --env or --volume to pass authentication values.

🤖 Custom MCP Client Install Steps (Optional)

You can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO.

npx -y @azure/mcp@latest server start

🔧 Manual Install Steps (Optional)

For a step-by-step installation, follow these instructions:

1. Add .vscode/mcp.json:

   {
     "servers": {
       "Azure MCP Server": {
         "command": "npx",
         "args": [
           "-y",
           "@azure/mcp@latest",
           "server",
           "start"
         ]
       }
     }
   }
   

   You can optionally set the --namespace <namespace> flag to install tools for the specified Azure product or service.

2. Add .vscode/mcp.json:

   {
     "servers": {
       "Azure Best Practices": {
         "command": "npx",
         "args": [
           "-y",
           "@azure/mcp@latest",
           "server",
           "start",
           "--namespace",
           "bestpractices" // Any of the available MCP servers can be referenced here.
         ]
       }
     }
   }
   

More end-to-end MCP client/agent guides are coming soon!

The Azure MCP Server uses the Azure Identity library for .NET to authenticate to Microsoft Entra ID. For detailed information, see Authentication Fundamentals.

If you're running into any issues with authentication, visit our troubleshooting guide.

For enterprise authentication scenarios, including network restrictions, security policies, and protected resources, see Authentication Scenarios in Enterprise Environments.