@azure/mcp weekly downloads statistics

Azure MCP Server NPM Package

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.

Table of Contents

• Overview • Local Setup • Remote Setup • Usage • Getting Started • Sovereign Cloud Support • What can you do with the Azure MCP Server? • Complete List of Supported Azure Services • Support and Reference • Documentation • Feedback and Support • Security • Permissions and Risk • Data Collection • Compliance Responsibility • Third Party Components • Export Control • No Warranty / Limitation of Liability • Contributing • Code of Conduct

Overview

Azure MCP Server supercharges your agents with Azure context across numerous Azure services.

Local Setup

• To use Azure MCP server from node one must have Node.js (LTS) installed and available on your system PATH — this provides both npm and npx. We recommend the latest Node.js LTS version. To verify your installation run: node --version, npm --version, and npx --version. • Configure the mcp.json file with the following:

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 |

| VS Code | .vscode/mcp.json (workspace) settings.json (user) | VS Code MCP Documentation | | Visual Studio | .mcp.json (solution/workspace) | Visual Studio MCP Setup | | GitHub Copilot CLI | ~/.copilot/mcp-config.json | Copilot CLI MCP Configuration | | Claude Code | ~/.claude.json or .mcp.json (project) | Claude Code MCP Configuration | | Eclipse IDE | GitHub Copilot Chat -> Configure Tools -> MCP Servers | Eclipse MCP Documentation | | IntelliJ IDEA | Built-in MCP server (2025.2+) Settings > Tools > MCP Server | IntelliJ MCP Documentation | | Google Antigravity | ~/.gemini/config/mcp_config.json (global) .agents/mcp_config.json (workspace) | Google Antigravity MCP Documentation | | Cursor | ~/.cursor/mcp.json or .cursor/mcp.json | Cursor MCP Documentation | | Windsurf | ~/.codeium/windsurf/mcp_config.json | Windsurf Cascade MCP Integration | | Amazon Q Developer | ~/.aws/amazonq/mcp.json (global) .amazonq/mcp.json (workspace) | AWS Q Developer MCP Guide | | Claude Desktop | ~/.claude/claude_desktop_config.json (macOS) %APPDATA%\Claude\claude_desktop_config.json (Windows) | Claude Desktop MCP Setup |

Remote Setup

Host the Azure MCP Server as a remote endpoint when your client requires HTTP-based MCP servers (for example, Microsoft Foundry and Microsoft Copilot Studio) or when you want to share a single deployment across users and environments. The server can be self-hosted on Azure Container Apps.

See the remote hosting azd templates for deployment options.

Usage

Getting Started

1. Open GitHub Copilot in VS Code or IntelliJ and switch to Agent mode. 1. Click refresh on the tools list • You should see the Azure MCP Server in the list of tools 1. 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 1. Check out the documentation and review the troubleshooting guide for commonly asked questions 1. 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

Sovereign Cloud Support

Azure MCP Server supports connecting to Azure sovereign clouds. By default, it authenticates against the Azure Public Cloud.

| Cloud | Aliases |

| Azure Public Cloud | AzureCloud, AzurePublicCloud, Public, AzurePublic | | Azure China Cloud | AzureChinaCloud, China, AzureChina | | Azure US Government | AzureUSGovernment, USGov, AzureUSGovernmentCloud, USGovernment |

*_The aliases are case insensitive._

Use the --cloud option when starting the server, or set the AZURE_CLOUD environment variable:

Before connecting, authenticate your local tools against the target cloud:

For full configuration options, see the Sovereign Clouds documentation.

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:

🧮 Microsoft Foundry

• List Microsoft Foundry models • Deploy Microsoft Foundry models • List Microsoft Foundry model deployments • List knowledge indexes • Get knowledge index schema configuration • Create Microsoft Foundry agents • List Microsoft Foundry agents • Connect and query Microsoft Foundry agents • Evaluate Microsoft Foundry agents

📊 Azure Advisor

• "List my Advisor recommendations" • "Summarize the key themes from my Advisor recommendations" • "Show the top 10 most common Advisor recommendation types" • "Break down my Advisor recommendations by lifecycle status" • "Summarize active service-retirement recommendations by retirement date" • "Mark an Advisor recommendation as completed" • "Dismiss an Advisor recommendation because the risk is acceptable" • "Postpone an Advisor recommendation until December 31, 2026" • "Before I deploy virtual machines, list the Advisor recommendation metadata that could apply to them" • "Show Advisor service retirements on or after March 31, 2026" • "Get Advisor metadata for a recommendation type id" • "How do I fix an Advisor recommendation type id? Get the ARM, Bicep, CLI, PowerShell and terraform artifacts to remediate it"

🔎 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…

Description from the npm listing.