azure

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:

  {
      "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

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.
2. Click refresh on the tools list
   • You should see the Azure MCP Server in the list of tools
3. 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
4. Check out the documentation and review the troubleshooting guide for commonly asked questions
5. 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.

*The aliases are case insensitive.

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

# Command line
azmcp server start --cloud AzureChinaCloud

# Environment variable (PowerShell)
$env:AZURE_CLOUD = "AzureUSGovernment"
azmcp server start

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

# Azure CLI
az cloud set --name AzureChinaCloud
az login

# Azure PowerShell
Connect-AzAccount -Environment AzureChinaCloud

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

Recommendation list and summary use subscriptions, recommendation-type-ids, and resource-types arrays, including one-element arrays for single selections. Prevalidation also uses subscriptions but retains one required recommendation-type-id. Single-target get operations and recommendation-update inputs are unchanged.

• "List my Advisor recommendations"
• "Show the next page of my Advisor recommendations using the returned continuation token"
• "List Advisor recommendations for service group 'my-service-group'"
• "Show the prioritized Advisor recommendations for service group 'my-service-group'"
• "What should I fix first? Show my top 10 Advisor recommendations"
• "Summarize the key themes from my Advisor recommendations"
• "Summarize the key themes from Advisor recommendations in service group 'my-service-group'"
• "Show the top 10 most common Advisor recommendation types"
• "Prevalidate the selected idle resources for locks, dependencies, and recent activity without deleting or changing anything"
• "Break down Advisor recommendations in service group 'my-service-group' by impact"
• "Break down my Advisor recommendations by lifecycle status"
• "Summarize active service-retirement recommendations by retirement date"
• "Mark an Advisor recommendation as completed"
• "Mark an Advisor recommendation as completed in service group 'my-service-group'"
• "Dismiss an Advisor recommendation because the risk is acceptable"
• "Postpone an Advisor recommendation in service group 'my-service-group' until <future-date-time-with-offset>"
• "Postpone an Advisor recommendation until December 31, 2026"
• "Postpone these selected Advisor recommendation IDs together in my service group until <future-date-time-with-offset>, with one batch approval"
• "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"
• "Show Advisor insights for service group 'my-service-group'"
• "Show Advisor insights for my subscription"
• "Give me Advisor insights across all my service groups and subscriptions"
• "How much retirement exposure has my subscription reduced or increased since its Day 1 count?"
• "What is the status of service group 'my-service-group'?"
• "Which mission-critical service groups need attention?"
• "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

• "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"
• "Convert text to speech and save to output.wav"
• "Synthesize speech from 'Hello, welcome to Azure' with Spanish voice"
• "Generate MP3 audio from text with high quality format"

⚙️ 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

• "Add a database connection for an App Service web app"
• "List the web apps in my subscription"
• "Show me the web apps in my 'my-resource-group' resource group"
• "Get the details for web app 'my-webapp' in 'my-resource-group'"
• "Get the application settings for my web app 'my-webapp' in 'my-resource-group'"
• "Add application setting 'LogLevel' with value 'INFO' to my 'my-webapp' in 'my-resource-group'"
• "Set application setting 'LogLevel' to 'WARNING' to my 'my-webapp' in 'my-resource-group'"
• "Delete application setting 'LogLevel' from my 'my-webapp' in 'my-resource-group'"
• "List the deployments for web app 'my-webapp' in 'my-resource-group'"
• "Get the deployment 'deployment-id' for web app 'my-webapp' in 'my-resource-group'"
• "List the diagnostic detectors for web app 'my-webapp' in 'my-resource-group'"