Azure MCP Server .NET Tool

• Install the Azure MCP Server .NET tool from NuGet to add Model Context Protocol (MCP) capabilities to your Azure projects and enable integration with VS Code.

Table of Contents

• Overview
• Getting Started
• What can you do with the Azure MCP Server?
• Complete List of Supported Azure Services
• Documentation
• Feedback & Support
• Contributing
• License

Overview

Azure MCP Server adds smart, context-aware AI tools right inside VS Code to help you work more efficiently with Azure resources. The Azure MCP Server supercharges your agents with Azure context across 30+ different Azure services.

Getting Started

Requirements

To run the Azure MCP server, 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

Configuration

To configure the MCP server for use with VS Code, use the following snippet and include it in your mcp.json

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

If you'd like to use a specific version of the Azure MCP server, you can specify it with the --version argument, like so:

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

When configured this way, you will need to update the version as new release become available.

What can you do with the Azure MCP Server?

Here are some cool prompts you can try across our supported Azure services:

🧮 Azure AI Foundry

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

🔎 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 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 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-resource-group' in my subscription"

⚡ 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

• "Show me details about my Azure SQL database 'mydb'"
• "List all databases in my Azure SQL server 'myserver'"
• "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"
• "Show me the tables in my Storage account"
• "Get details about my Storage container"
• "Upload my file to the blob container"
• "List paths in my Data Lake file system"
• "List files and directories in my File Share"
• "Send a message to my storage queue"

🛠️ Currently Supported Tools

Complete List of Supported Azure Services

The Azure MCP Server provides tools for interacting with 30+ 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 App Configuration - Configuration management
• 🛡️ Azure Best Practices - Secure, production-grade guidance
• 📦 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

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 our GitHub repository section on Azure MCP Commands.

Feedback & 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!

Contributing

Want to contribute? Check out our contribution guide to get started.

License

This project is licensed under the MIT License.