{"id":3378,"date":"2025-04-17T12:59:42","date_gmt":"2025-04-17T19:59:42","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/azure-sdk\/?p=3378"},"modified":"2025-09-09T10:42:49","modified_gmt":"2025-09-09T17:42:49","slug":"introducing-the-azure-mcp-server","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/azure-sdk\/introducing-the-azure-mcp-server\/","title":{"rendered":"Introducing the Azure MCP Server"},"content":{"rendered":"<p>We&#8217;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.<\/p>\n<p>In this post, we&#8217;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 <a href=\"https:\/\/aka.ms\/azmcp\">GitHub<\/a>.<\/p>\n<h2>What is MCP, and why an Azure MCP Server?<\/h2>\n<p>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 &#8220;write once&#8221; approach. For more information on MCP, visit the protocol&#8217;s <a href=\"https:\/\/modelcontextprotocol.io\/introduction\">website<\/a> and <a href=\"https:\/\/modelcontextprotocol.io\/introduction\">GitHub organization<\/a>.<\/p>\n<p>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.<\/p>\n<h2>Public Preview release highlights<\/h2>\n<p>As a part of our Public Preview release, the Azure MCP Server supports the following services and tools:<\/p>\n<h3>Azure services<\/h3>\n<h4>Azure Cosmos DB (NoSQL databases)<\/h4>\n<ul>\n<li>List Cosmos DB accounts<\/li>\n<li>List and query databases<\/li>\n<li>Manage containers and items<\/li>\n<li>Execute SQL queries against containers<\/li>\n<\/ul>\n<h4>Azure Storage<\/h4>\n<ul>\n<li>List Storage accounts<\/li>\n<li>Manage blob containers and blobs<\/li>\n<li>List and query Storage tables<\/li>\n<li>Get container properties and metadata<\/li>\n<\/ul>\n<h4>Azure Monitor (Log Analytics)<\/h4>\n<ul>\n<li>List Log Analytics workspaces<\/li>\n<li>Query logs using Kusto Query Language (KQL)<\/li>\n<li>List available tables<\/li>\n<li>Configure monitoring options<\/li>\n<\/ul>\n<h4>Azure App Configuration<\/h4>\n<ul>\n<li>List App Configuration stores<\/li>\n<li>Manage key-value pairs<\/li>\n<li>Handle labeled configurations<\/li>\n<li>Lock\/unlock configuration settings<\/li>\n<\/ul>\n<h4>Azure Resource Groups<\/h4>\n<ul>\n<li>List resource groups<\/li>\n<li>Resource group management operations<\/li>\n<\/ul>\n<h3>Azure tools<\/h3>\n<h4>Azure CLI<\/h4>\n<ul>\n<li>Execute Azure CLI commands directly<\/li>\n<li>Support for all Azure CLI functionality<\/li>\n<li>JSON output formatting<\/li>\n<\/ul>\n<h4>Azure Developer CLI (azd)<\/h4>\n<ul>\n<li>Execute azd commands directly<\/li>\n<li>Support for template discovery, template initialization, provisioning, and deployment<\/li>\n<\/ul>\n<p>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!<\/p>\n<h2>Use the Azure MCP Server<\/h2>\n<p>The Azure MCP Server can be used by any agent that supports MCP. This includes GitHub Copilot Agent Mode and custom MCP clients.<\/p>\n<h3>GitHub Copilot Agent Mode<\/h3>\n<p>GitHub Copilot recently announced the <a href=\"https:\/\/github.blog\/news-insights\/product-news\/github-copilot-agent-mode-activated\/\">public release of Agent Mode with MCP support<\/a> in VS Code. The <a href=\"https:\/\/aka.ms\/azmcp\">Azure MCP Server Repository on GitHub<\/a> has a button that installs the Azure MCP Server on your machine automatically.<\/p>\n<p>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 <a href=\"https:\/\/code.visualstudio.com\/docs\/copilot\/chat\/chat-agent-mode\">official documentation<\/a>.<\/p>\n<p>For a more streamlined Azure development experience, we recommend combining the data plane support of the Azure MCP Server with the <a href=\"https:\/\/marketplace.visualstudio.com\/items?itemName=ms-azuretools.vscode-azure-github-copilot\">GitHub Copilot for Azure extension<\/a> 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.<\/p>\n<h3>Custom MCP clients\/Agents<\/h3>\n<p>In order for an agent to take advantage of the Azure MCP Server, the agent must adopt the <a href=\"https:\/\/modelcontextprotocol.io\/specification\/latest\">MCP client pattern<\/a>. Besides the MCP SDKs, there are opinionated agent frameworks such as <a href=\"https:\/\/devblogs.microsoft.com\/semantic-kernel\/building-a-model-context-protocol-server-with-semantic-kernel\/\">Semantic Kernel<\/a> that provide some higher-level abstractions that conform to the MCP client pattern.<\/p>\n<p>To connect your MCP client to the Azure MCP Server, configure it to run the following command to install and execute the server.<\/p>\n<pre><code class=\"language-bash\">npx -y @azure\/mcp@latest server start<\/code><\/pre>\n<p>Here&#8217;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 <code>commands<\/code> and <code>arguments<\/code> 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.<\/p>\n<ul>\n<li><a href=\"https:\/\/modelcontextprotocol.io\/quickstart\/client#python\">MCP SDK in Python<\/a><\/li>\n<li><a href=\"https:\/\/modelcontextprotocol.io\/quickstart\/client#c\">MCP SDK in .NET<\/a><\/li>\n<li><a href=\"https:\/\/devblogs.microsoft.com\/semantic-kernel\/integrating-model-context-protocol-tools-with-semantic-kernel-a-step-by-step-guide\/\">Semantic Kernel .NET SDK<\/a><\/li>\n<li><a href=\"https:\/\/openai.github.io\/openai-agents-python\/mcp\/\">OpenAI Agents SDK for Python<\/a><\/li>\n<\/ul>\n<h2>What&#8217;s next?<\/h2>\n<p>The team is hard at work to improve the Azure MCP Server. In the future, you can expect:<\/p>\n<ol>\n<li>More in-depth agent samples using the Azure MCP Server<\/li>\n<li>More documentation<\/li>\n<li>More Microsoft product integrations<\/li>\n<li>More Azure service integrations<\/li>\n<\/ol>\n<p>We&#8217;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 <a href=\"https:\/\/github.com\/Microsoft\/mcp\/issues\">GitHub Repository<\/a>.<\/p>\n<h2>Summary<\/h2>\n<p>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.<\/p>\n<p>Because the Azure MCP Server is in Public Preview, any feedback is appreciated. More samples, guidance, integrations, and features are on the way.<\/p>\n<p>For more information, see <a href=\"https:\/\/aka.ms\/azmcp\">Azure MCP Server on GitHub<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This post introduces the Azure MCP Server, bringing the power of the cloud to your AI agents.<\/p>\n","protected":false},"author":98329,"featured_media":3379,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[941,786,940],"class_list":["post-3378","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure-sdk","tag-agents","tag-ai","tag-mcp"],"acf":[],"blog_post_summary":"<p>This post introduces the Azure MCP Server, bringing the power of the cloud to your AI agents.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/3378","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/users\/98329"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/comments?post=3378"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/3378\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media\/3379"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media?parent=3378"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/categories?post=3378"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/tags?post=3378"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}