How do I install mcp-azure?

mcp-azure is a local plugin. Install it using npm package: @dockndevai/mcp-azure and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is mcp-azure safe to use?

mcp-azure scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 3 high or critical findings to review. It's listed, but review the security report on this page before installing.

What AI apps work with mcp-azure?

mcp-azure uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

mcp-azure MCP Server

by dockndevai

Cloud & DevOpsModerate5.2LocalNew

Free

Azure Resource Manager inventory & ops for AI agents — governed.

About

MCP server for Azure (Resource Manager). Inventory subscriptions, resource groups, and resources; tag resources; control VM power; and manage lifecycle — with a governance layer: read-only / read-write / admin access modes, subscription and resource-group allowlists, protected resource groups, a location allowlist for new groups, delete gating, and typed high-impact confirmation. Entra ID service principal; secrets never reach the model; JSON audit logging.

Security Report

5.2

Moderate5.2Moderate Risk

mcp-azure is a well-designed Azure Resource Manager MCP server with strong governance controls and security architecture. Authentication uses OAuth2 client credentials (industry standard), and the server implements comprehensive capability gating, subscription/resource-group allowlists, location allowlists, protected resource groups, deletion confirmation, dry-run modes, and audit logging. Code quality is solid with proper error handling and input validation via Zod. Minor findings around token expiry edge cases and broad error messages do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mcp-azure": {
      "args": [
        "-y",
        "@dockndevai/mcp-azure"
      ],
      "command": "npx"
    }
  }
}

Getting Started

Once installed, try these example prompts and explore these capabilities:

1"List all resource groups and their regions"
2"Show every resource in the rg-web group"
3"Tag the app-plan resource with env=prod and owner=team-a"
4Tool: control_vm — start/stop a VM (requires read-write mode)

Documentation

View on GitHub

From the project's GitHub README.

A Model Context Protocol server for Azure (via the Azure Resource Manager API — the programmatic layer behind the Azure Portal). It lets an MCP-capable client (Claude Desktop, Claude Code, Cursor, Codex, …) inventory and operate Azure resources — with a governance layer that keeps an AI agent inside safe boundaries.

What this offers

Inventory — list subscriptions, locations, resource groups, and resources; get any resource by ARM id.
Operations — create resource groups (in approved regions), merge tags onto any resource, and control VM power state (start / stop / restart / deallocate).
Lifecycle — delete resource groups and individual resources, guarded.
Governance built in — access modes, subscription/resource-group allowlists, protected resource groups, a location allowlist for new groups, delete gating, typed confirmation for high-impact deletes, dry-run, and JSON audit logging.

Governance & security model

Concern	Flag	Default	Effect
What can the server do?	`AZURE_MODE`	`read-only`	`read-only` → inventory; `read-write` → create RG, tag, VM power; `admin` → deletes. Tools above the mode are never registered.
Which subscriptions?	`AZURE_SUBSCRIPTION_ALLOWLIST`	(all)	Operations on other subscriptions are refused.
Which resource groups?	`AZURE_RESOURCE_GROUP_ALLOWLIST`	(all)	Operations outside the list are refused.
Read-only-forever groups	`AZURE_PROTECTED_RESOURCE_GROUPS`	(none)	Readable, never mutable.
Approved regions	`AZURE_LOCATION_ALLOWLIST`	(any)	New resource groups may only be created here.
Can it delete?	`AZURE_ALLOW_DELETE`	`false`	Deletes need this and admin mode.
Typed confirmation	`AZURE_REQUIRE_CONFIRMATION`	`true`	Deletes require `confirm` to equal the target name — not just a boolean.
Preview	`AZURE_DRY_RUN`	`false`	Write/admin tools validate + log intent, then return.
Audit trail	`AZURE_AUDIT_LOG`	`true`	JSON line to stderr per guarded operation.

Tools

Read (read-only+): list_subscriptions, list_locations, list_resource_groups, list_resources, get_resource

Write (read-write+): create_resource_group, tag_resource, control_vm

Admin (admin): delete_resource_group, delete_resource (both need AZURE_ALLOW_DELETE + typed confirm)

Quickstart — add to your agent

Published on npm as @dockndevai/mcp-azure. Runs via npx with an Entra ID service principal. See docs/CLIENTS.md for every client and .env.example for all variables.

Claude Code

claude mcp add azure -e AZURE_TENANT_ID="…" -e AZURE_CLIENT_ID="…" -e AZURE_CLIENT_SECRET="…" -e AZURE_SUBSCRIPTION_ID="…" -e AZURE_MODE="read-only" -- npx -y @dockndevai/mcp-azure

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure"],
      "env": {
        "AZURE_TENANT_ID": "…",
        "AZURE_CLIENT_ID": "…",
        "AZURE_CLIENT_SECRET": "…",
        "AZURE_SUBSCRIPTION_ID": "…",
        "AZURE_MODE": "read-only"
      }
    }
  }
}

Example prompts

"List all resource groups in my subscription and which region each is in"
"Show every resource in the rg-web group"
"Tag the app-plan resource with env=prod and owner=team-a" (needs read-write)
"Stop the build-agent VM in rg-ci" (needs read-write)

Run from source (development)

npm install
npm run build
node dist/index.js   # with the environment variables set

Develop

npm run dev
npm test          # governance policy: modes, scoping, location allowlist, delete + confirmation
npm run typecheck

Publishing

Ships a server.json for the official MCP registry and an mcpName for npm ownership validation. See PUBLISHING.md.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Cloud & DevOps MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

Google Workspace MCP

Free

by Taylorwilsdon · Productivity

Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI

mcp-azure MCP Server

About

Security Report

Findings (7)Action required

Permissions Required

How to Install

Getting Started

Documentation

What this offers

Governance & security model

Tools

Quickstart — add to your agent

Example prompts

Run from source (development)

Develop

Publishing

License

Reviews

No reviews yet

More Cloud & DevOps MCP Servers

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent

Google Workspace MCP