Azure MCP Server

All Azure MCP tools in a single server. The Azure MCP Server implements the MCP specification to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the GitHub Copilot for Azure extension in VS Code.

Overview
Installation
- IDE
- Package Manager
  - NuGet
  - NPM
  - Docker
Usage
Support and Reference

Overview

Azure MCP Server supercharges your agents with Azure context across 40+ different Azure services.

Installation

Install Azure MCP Server using either an IDE extension or package manager. Choose one method below.

IDE

Start using Azure MCP with your favorite IDE. We recommend VS Code:

VS Code (Recommended)

Install either the stable or Insiders release of VS Code:
- 💫 Stable release
- 🔮 Insiders release
Install the GitHub Copilot and GitHub Copilot Chat extensions
Install the Azure MCP Server extension

Visual Studio 2022

From within Visual Studio 2022 install GitHub Copilot for Azure (VS 2022):

Go to Extensions | Manage Extensions...
Switch to the Browse tab in Extension Manager
Search for Github Copilot for Azure
Click Install

IntelliJ IDEA

Install either the IntelliJ IDEA Ultimate or IntelliJ IDEA Community edition.
Install the GitHub Copilot plugin.
Install the Azure Toolkit for Intellij plugin.

Manual Setup

Azure MCP Server can also be configured across other IDEs, CLIs, and MCP clients:

Manual setup instructions

Use one of the following options to configure your mcp.json:

Option 1: Configure using .NET tool (dnx)

To use Azure MCP server from .NET, you must have .NET 10 Preview 6 or later installed. This version of .NET adds a command, dnx, which is used to download, install, and run the MCP server from nuget.org.
To verify your .NET version, run the following command in your terminal: dotnet --info

Configure your mcp.json file with the following:

              {
    "mcpServers": {
        "Azure MCP Server": {
            "command": "dnx",
            "args": [
                "Azure.Mcp",
                "--source",
                "https://api.nuget.org/v3/index.json",
                "--yes",
                "--",
                "azmcp",
                "server",
                "start"
            ],
            "type": "stdio"
        }
    }
}
            

Option 2: Configure using Node.js (npm/npx)

To use Azure MCP server from node you must have Node.js (LTS) installed and available on your system PATH — this provides both npm and npx. We recommend Node.js 20 LTS or later. To verify your installation run: node --version, npm --version, and npx --version.

Configure your mcp.json file with the following:

              {
    "mcpServers": {
        "azure-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@azure/mcp@latest",
            "server",
            "start"
            ]
        }
    }
}
            

Note: When manually configuring Visual Studio and Visual Studio Code, use servers instead of mcpServers as the root object.

Client-Specific Configuration

IDE	File Location	Documentation Link
Amazon Q Developer	`~/.aws/amazonq/mcp.json` (global) `.amazonq/mcp.json` (workspace)	AWS Q Developer MCP Guide
Claude Code	`~/.claude.json` or `.mcp.json` (project)	Claude Code MCP Configuration
Claude Desktop	`~/.claude/claude_desktop_config.json` (macOS) `%APPDATA%\Claude\claude_desktop_config.json` (Windows)	Claude Desktop MCP Setup
Cursor	`~/.cursor/mcp.json` or `.cursor/mcp.json`	Cursor MCP Documentation
IntelliJ IDEA	Built-in MCP server (2025.2+) Settings > Tools > MCP Server	IntelliJ MCP Documentation
Visual Studio	`.mcp.json` (solution/workspace)	Visual Studio MCP Setup
VS Code	`.vscode/mcp.json` (workspace) `settings.json` (user)	VS Code MCP Documentation
Windsurf	`~/.codeium/windsurf/mcp_config.json`	Windsurf Cascade MCP Integration

Package Manager

Package manager installation offers several advantages over IDE-specific setup, including centralized dependency management, CI/CD integration, support for headless/server environments, version control, and project portability.

Install Azure MCP Server via a package manager:

NuGet

Install the .NET Tool: Azure.Mcp.

dotnet tool install --global Azure.Mcp

NPM

Install the Node.js package: @azure/mcp.

npm install -g @azure/mcp

Docker

Run the Azure MCP server as a Docker container for easy deployment and isolation. The container image is available at mcr.microsoft.com/azure-sdk/azure-mcp.

Docker instructions

Create an env file with Azure credentials

Create a .env file with Azure credentials (see EnvironmentCredential options):

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

Configure your MCP client to use Docker

Add or update existing mcp.json. Replace /full/path/to/your/.env with the actual .env file path.

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

To use Azure Entra ID, review the troubleshooting guide.

Usage

Getting Started

Open GitHub Copilot in VS Code or IntelliJ and switch to Agent mode.
Click refresh on the tools list
- You should see the Azure MCP Server in the list of tools
Try a prompt that tells the agent to use the Azure MCP Server, such as List my Azure Storage containers
- The agent should be able to use the Azure MCP Server tools to complete your query
Check out the documentation and review the troubleshooting guide for commonly asked questions
We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server
- 👉 Open an issue in the public repository

What can you do with the Azure MCP Server?

✨ The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:

🧮 Azure AI Foundry

List Azure Foundry models
Deploy foundry models
List foundry model deployments
List knowledge indexes
Get knowledge index schema configuration

🔎 Azure AI Search

"What indexes do I have in my Azure AI Search service 'mysvc'?"
"Let's search this index for 'my search query'"

🎤 Azure AI Services Speech

"Convert this audio file to text using Azure Speech Services"
"Recognize speech from my audio file with language detection"
"Transcribe speech from audio with profanity filtering"
"Transcribe audio with phrase hints for better accuracy"

⚙️ Azure App Configuration

"List my App Configuration stores"
"Show my key-value pairs in App Config"

⚙️ Azure App Lens

"Help me diagnose issues with my app"

🕸️ Azure App Service

"List the websites in my subscription"
"Show me the websites in my 'my-resource-group' resource group"
"Get the details for website 'my-website'"
"Get the details for app service plan 'my-app-service-plan'"

📦 Azure Container Apps

"List the container apps in my subscription"
"Show me the container apps in my 'my-resource-group' resource group"

📞 Azure Communication Services

"Send an SMS message to +1234567890"
"Send SMS with delivery reporting enabled"
"Send a broadcast SMS to multiple recipients"
"Send SMS with custom tracking tag"

📦 Azure Container Registry (ACR)

"List all my Azure Container Registries"
"Show me my container registries in the 'my-resource-group' resource group"
"List all my Azure Container Registry repositories"

☸️ Azure Kubernetes Service (AKS)

"List my AKS clusters in my subscription"
"Show me all my Azure Kubernetes Service clusters"
"List the node pools for my AKS cluster"
"Get details for the node pool 'np1' of my AKS cluster 'my-aks-cluster' in the 'my-resource-group' resource group"

📊 Azure Cosmos DB

"Show me all my Cosmos DB databases"
"List containers in my Cosmos DB database"

🧮 Azure Data Explorer

"Get Azure Data Explorer databases in cluster 'mycluster'"
"Sample 10 rows from table 'StormEvents' in Azure Data Explorer database 'db1'"

📣 Azure Event Grid

"List all Event Grid topics in subscription 'my-subscription'"
"Show me the Event Grid topics in my subscription"
"List all Event Grid topics in resource group 'my-resourcegroup' in my subscription"
"List Event Grid subscriptions for topic 'my-topic' in resource group 'my-resourcegroup'"
"List Event Grid subscriptions for topic 'my-topic' in subscription 'my-subscription'"
"List Event Grid Subscriptions in subscription 'my-subscription'"
"List Event Grid subscriptions for topic 'my-topic' in location 'my-location'"
"Publish an event with data '{"name": "test"}' to topic 'my-topic' using CloudEvents schema"
"Send custom event data to Event Grid topic 'analytics-events' with EventGrid schema"

🔑 Azure Key Vault

"List all secrets in my key vault 'my-vault'"
"Create a new secret called 'apiKey' with value 'xyz' in key vault 'my-vault'"
"List all keys in key vault 'my-vault'"
"Create a new RSA key called 'encryption-key' in key vault 'my-vault'"
"List all certificates in key vault 'my-vault'"
"Import a certificate file into key vault 'my-vault' using the name 'tls-cert'"
"Get the account settings for my key vault 'my-vault'"

⚡ Azure Managed Lustre

"List the Azure Managed Lustre clusters in resource group 'my-resource-group'"
"How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?"

📊 Azure Monitor

"Query my Log Analytics workspace"

🔧 Azure Resource Management

"List my resource groups"
"List my Azure CDN endpoints"
"Help me build an Azure application using Node.js"

🗄️ Azure SQL Database

"List all SQL servers in my subscription"
"List all SQL servers in my resource group 'my-resource-group'"
"Show me details about my Azure SQL database 'mydb'"
"List all databases in my Azure SQL server 'myserver'"
"Update the performance tier of my Azure SQL database 'mydb'"
"Rename my Azure SQL database 'mydb' to 'newname'"
"List all firewall rules for my Azure SQL server 'myserver'"
"Create a firewall rule for my Azure SQL server 'myserver'"
"Delete a firewall rule from my Azure SQL server 'myserver'"
"List all elastic pools in my Azure SQL server 'myserver'"
"List Active Directory administrators for my Azure SQL server 'myserver'"
"Create a new Azure SQL server in my resource group 'my-resource-group'"
"Show me details about my Azure SQL server 'myserver'"
"Delete my Azure SQL server 'myserver'"

💾 Azure Storage

"List my Azure storage accounts"
"Get details about my storage account 'mystorageaccount'"
"Create a new storage account in East US with Data Lake support"
"Get details about my Storage container"
"Upload my file to the blob container"

Complete List of Supported Azure Services

The Azure MCP Server provides tools for interacting with 40+ Azure service areas:

🧮 Azure AI Foundry - AI model management, AI model deployment, and knowledge index management
🔎 Azure AI Search - Search engine/vector database operations
🎤 Azure AI Services Speech - Speech-to-text recognition
⚙️ Azure App Configuration - Configuration management
🕸️ Azure App Service - Web app hosting
🛡️ Azure Best Practices - Secure, production-grade guidance
📦 Azure Container Apps - Container hosting
📞 Azure Communication Services - SMS messaging and communication
📦 Azure Container Registry (ACR) - Container registry management
📊 Azure Cosmos DB - NoSQL database operations
🧮 Azure Data Explorer - Analytics queries and KQL
🐬 Azure Database for MySQL - MySQL database management
🐘 Azure Database for PostgreSQL - PostgreSQL database management
📊 Azure Event Grid - Event routing and management
⚡ Azure Functions - Function App management
🔑 Azure Key Vault - Secrets, keys, and certificates
☸️ Azure Kubernetes Service (AKS) - Container orchestration
📦 Azure Load Testing - Performance testing
🚀 Azure Managed Grafana - Monitoring dashboards
🗃️ Azure Managed Lustre - High-performance Lustre filesystem operations
🏪 Azure Marketplace - Product discovery
📈 Azure Monitor - Logging, metrics, and health monitoring
⚙️ Azure Native ISV Services - Third-party integrations
🛡️ Azure Quick Review CLI - Compliance scanning
📊 Azure Quota - Resource quota and usage management
🎭 Azure RBAC - Access control management
🔴 Azure Redis Cache - In-memory data store
🏗️ Azure Resource Groups - Resource organization
🗄️ Azure SQL Database - Relational database management
🗄️ Azure SQL Elastic Pool - Database resource sharing
🗄️ Azure SQL Server - Server administration
🚌 Azure Service Bus - Message queuing
🏥 Azure Service Health - Resource health status and availability
💾 Azure Storage - Blob storage
📋 Azure Subscription - Subscription management
🏗️ Azure Terraform Best Practices - Infrastructure as code guidance
🖥️ Azure Virtual Desktop - Virtual desktop infrastructure
📊 Azure Workbooks - Custom visualizations
🏗️ Bicep - Azure resource templates
🏗️ Cloud Architect - Guided architecture design

Support and Reference

Documentation

See our official documentation on learn.microsoft.com to learn how to use the Azure MCP Server to interact with Azure resources through natural language commands from AI agents and other types of clients.
For additional command documentation and examples, see Azure MCP Commands.

Feedback and Support

Check the Troubleshooting guide to diagnose and resolve common issues with the Azure MCP Server.
We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server.
- 👉 Open an issue in the public GitHub repository — we’d love to hear from you!

Security

Your credentials are always handled securely through the official Azure Identity SDK - we never store or manage tokens directly.

MCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Azure MCP Server, but any MCP client/agent that you choose to implement down to the model provider.

Data Collection

The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.

Telemetry Configuration

Telemetry collection is on by default.

To opt out, set the environment variable AZURE_MCP_COLLECT_TELEMETRY to false in your environment.

Contributing

We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.

Please read our Contributing Guide for guidelines on:

🛠️ Setting up your development environment
✨ Adding new commands
📝 Code style and testing requirements
🔄 Making pull requests

Code of Conduct

This project has adopted the
Microsoft Open Source Code of Conduct.
For more information, see the
Code of Conduct FAQ
or contact open@microsoft.com
with any additional questions or comments.

Azure MCP Server

Azure MCP Server

Table of Contents

Overview

Installation

IDE

VS Code (Recommended)

Visual Studio 2022

IntelliJ IDEA

Manual Setup

Option 1: Configure using .NET tool (dnx)

Option 2: Configure using Node.js (npm/npx)

Package Manager

NuGet

NPM

Docker

Create an env file with Azure credentials

Configure your MCP client to use Docker

Usage

Getting Started

What can you do with the Azure MCP Server?

🧮 Azure AI Foundry

🔎 Azure AI Search

🎤 Azure AI Services Speech

⚙️ Azure App Configuration

⚙️ Azure App Lens

🕸️ Azure App Service

📦 Azure Container Apps

📞 Azure Communication Services

📦 Azure Container Registry (ACR)

☸️ Azure Kubernetes Service (AKS)

📊 Azure Cosmos DB

🧮 Azure Data Explorer

📣 Azure Event Grid

🔑 Azure Key Vault

⚡ Azure Managed Lustre

📊 Azure Monitor

🔧 Azure Resource Management

🗄️ Azure SQL Database

💾 Azure Storage

Complete List of Supported Azure Services

Support and Reference

Documentation

Feedback and Support

Security

Data Collection

Telemetry Configuration

Contributing

Code of Conduct