April 17th, 2025

Introducing the Azure MCP Server

Rohit Ganguly
Product Manager II

We’re thrilled to announce the Public Preview of the Azure MCP Server, bringing the power of Azure to your AI agents. The Azure MCP Server allows AI agents to take advantage of Azure resources for key workflows such as file storage, database and logs querying, and CLI commands.

In this post, we’ll dive deeper into the details of our Public Preview release, go over starter scenarios with the Azure MCP Server, and share our future plans. The Azure MCP Server is open-source on GitHub.

What is MCP, and why an Azure MCP Server?

MCP (Model Context Protocol) is an open protocol between agents and external resources, defined as MCP clients and servers, respectively. The advent of MCP allows for seamless integration between AI systems and data sources, tools, and more with a “write once” approach. For more information on MCP, visit the protocol’s website and GitHub organization.

Azure offers many cloud services that allow developers to build robust applications. The Azure MCP Server exposes these powerful services for agentic usage, allowing for AI systems to perform operations that are context-aware of your Azure resources. For example, a developer building an agent that uses the Azure MCP Server can enable the agent to query Azure Cosmos DB based on natural language instructions, read files from Azure Storage, or dig through logs in an Azure Log Analytics workspace.

Public Preview release highlights

As a part of our Public Preview release, the Azure MCP Server supports the following services and tools:

Azure services

Azure Cosmos DB (NoSQL databases)

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

Azure Storage

  • List Storage accounts
  • Manage blob containers and blobs
  • List and query Storage tables
  • Get container properties and metadata

Azure Monitor (Log Analytics)

  • List Log Analytics workspaces
  • Query logs using Kusto Query Language (KQL)
  • List available tables
  • Configure monitoring options

Azure App Configuration

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

Azure Resource Groups

  • List resource groups
  • Resource group management operations

Azure tools

Azure CLI

  • Execute Azure CLI commands directly
  • Support for all Azure CLI functionality
  • JSON output formatting

Azure Developer CLI (azd)

  • Execute azd commands directly
  • Support for template discovery, template initialization, provisioning, and deployment

This set of functionality allows agents to perform operations on Azure services, manage cloud resources, deploy applications with azd, and so much more. The team is hard at work on more functionality that is coming soon!

Use the Azure MCP Server

The Azure MCP Server can be used by any agent that supports MCP. This includes GitHub Copilot Agent Mode and custom MCP clients.

GitHub Copilot Agent Mode

GitHub Copilot recently announced the public release of Agent Mode with MCP support in VS Code. The Azure MCP Server Repository on GitHub has a button that installs the Azure MCP Server on your machine automatically.

Once the Azure MCP Server is installed, try asking GitHub Copilot (in Agent Mode) to list your Cosmos DB or Storage Accounts! To learn more about Agent mode and how to toggle it, visit the official documentation.

For a more streamlined Azure development experience, we recommend combining the data plane support of the Azure MCP Server with the GitHub Copilot for Azure extension in VS Code. This extension provides GitHub Copilot the ability to look up documentation on Microsoft Learn, query Azure Resource Graph, apply development best practices, and more. Together in VS Code, they deliver a powerful, AI-assisted Azure development workflow that lets you stay in the flow in your development environment.

Custom MCP clients/Agents

In order for an agent to take advantage of the Azure MCP Server, the agent must adopt the MCP client pattern. Besides the MCP SDKs, there are opinionated agent frameworks such as Semantic Kernel that provide some higher-level abstractions that conform to the MCP client pattern.

To connect your MCP client to the Azure MCP Server, configure it to run the following command to install and execute the server.

npx -y @azure/mcp@latest server start

Here’s a list of some MCP client tutorials that you can adapt to use the Azure MCP Server. Each of them has a specific section where you can add commands and arguments to ensure the MCP client runs the install and execute command for the Azure MCP Server correctly. Because of the universal nature of the MCP specification, the Azure MCP Server should work with any MCP client, not just the options listed.

What’s next?

The team is hard at work to improve the Azure MCP Server. In the future, you can expect:

  1. More in-depth agent samples using the Azure MCP Server
  2. More documentation
  3. More Microsoft product integrations
  4. More Azure service integrations

We’re excited to see what kind of agents you build with Azure. If you have any feedback, bugs, feature requests, or questions, open an issue in the GitHub Repository.

Summary

The Azure MCP Server enables agents to take advantage of the capabilities of powerful Azure services. Thanks to the MCP specification, the Azure MCP Server is usable by any agent that also follows MCP. These agents include GitHub Copilot Agent Mode, custom agents built with the MCP SDKs, or opinionated agentic frameworks like Semantic Kernel. The source code is open-source on GitHub with more samples and guidance coming soon.

Because the Azure MCP Server is in Public Preview, any feedback is appreciated. More samples, guidance, integrations, and features are on the way.

For more information, see Azure MCP Server on GitHub.

Category
Azure SDK

Author

Rohit Ganguly
Product Manager II

Hi, I'm Rohit! I'm a PM working on Azure Developer Experiences here at Microsoft.

4 comments

  • Dmitry Kirushev

    Are there any plans to extend this excellent feature to the Hybrid Exchange deployment?

  • John Steskal

    Are there any plans to allow this to run on-prem, and on Windows Server?

    • Rohit GangulyMicrosoft employee Author

      Hi John! Sorry for the delayed response.

      We’re currently focused on local MCP scenarios but are actively looking for remote hosting support in 1-2 months.

  • Kevin Weir · Edited

    It seems premature Microsoft got rid of Cortana as leveraging voice technology to interact with these agents seems like a natural fit.

    I could see a day where an MCP server runs on each desktop and the entire Windows OS is instrumented to work with a local language model, MCP server and agents and voice and command line prompts.