Azure MCP UI

Interactive Azure dashboard + MCP server. One command, full visibility into your Azure environment.

Quick Start

az login
gh auth login
npx azure-mcp-ui

Open http://localhost:3001 — that's it. You get a full interactive dashboard with sidebar navigation covering resources, costs, networking, security, deployments, monitoring, and more.

Use with AI Assistants (MCP)

Azure MCP UI also works as an MCP server, giving your AI assistant 45 tools to explore your Azure environment. Add it to your client of choice:

Claude Code (CLI)

claude mcp add azure-mcp-ui -- npx -y azure-mcp-ui --stdio

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "azure-mcp-ui": {
      "command": "npx",
      "args": ["-y", "azure-mcp-ui", "--stdio"]
    }
  }
}

VS Code (Copilot)

Add to .vscode/settings.json or user settings:

{
  "mcp": {
    "servers": {
      "azure-mcp-ui": {
        "command": "npx",
        "args": ["-y", "azure-mcp-ui", "--stdio"]
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "azure-mcp-ui": {
      "command": "npx",
      "args": ["-y", "azure-mcp-ui", "--stdio"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "azure-mcp-ui": {
      "command": "npx",
      "args": ["-y", "azure-mcp-ui", "--stdio"]
    }
  }
}

Prerequisites

• Node.js 22+
• Azure CLI — install, then run az login
• GitHub CLI — install, then run gh auth login
• An Azure subscription

How Auth Works

The server never stores credentials. It delegates to CLIs you already have:

• Azure — shells out to az account get-access-token for short-lived ARM API tokens
• GitHub — shells out to gh auth token and proxies GitHub API requests server-side (the browser never sees the raw token)

No OAuth apps, no client secrets, no .env files.

What You Can Do

Get oriented:

• "List my Azure subscriptions"
• "Open the Azure dashboard"
• "Show resource groups in my subscription"

Find resources:

• "Search for resources named 'prod'"
• "Show me all VMs in resource group 'my-rg'"
• "What AKS clusters do I have?"

Understand costs:

• "Show this month's costs by service"
• "Daily costs for the past week grouped by resource group"
• "Compare costs between my dev and prod resource groups"

Security & compliance:

• "Who has Owner access to my subscription?"
• "Run a Well-Architected review"
• "Show policy compliance for my subscription"
• "List Key Vaults and check for expiring secrets"

Debug & deploy:

• "Show recent deployments in 'my-rg' — any failures?"
• "Preview what this ARM template would change"
• "Show the activity log for the past 24 hours"
• "Generate Bicep for a 3-tier web app"

Monitor:

• "Are there any active alerts?"
• "Show CPU metrics for my VM"
• "Any Azure service health issues right now?"

All 45 Tools

Overview & Navigation

| Tool | Description | |------|-------------| | list_subscriptions | List all subscriptions you have access to | | list_resource_groups | List resource groups in a subscription | | search_resources | Search resources by name or type via Resource Graph | | get_resource_detail | Get detailed properties of any resource | | open_dashboard | Fullscreen interactive dashboard with sidebar navigation | | explore_services | Browse the Azure service catalog by category | | compare_services | Side-by-side feature comparison of Azure services | | search_documentation | Search Azure docs, Learn modules, and tutorials |

Cost Management

| Tool | Description | |------|-------------| | query_costs | Flexible cost queries — group by service, resource group, region, etc. | | list_vm_skus | VM sizes with specs and pricing for capacity planning |

Compute

| Tool | Description | |------|-------------| | get_vm_overview | VM fleet overview — power state, sizes, OS, provisioning status | | get_aks_clusters | AKS clusters with node pools, K8s version, network config | | get_aks_workloads | Pods, deployments, and services running in an AKS cluster | | list_functions | Function Apps with triggers, schedules, and runtime info | | list_logic_apps | Logic App workflows with run history and success rates | | get_app_service_overview | App Services grouped by plan with SKU and runtime | | list_container_apps | Container Apps with revisions, scaling, and traffic split |

Data & Storage

| Tool | Description | |------|-------------| | get_sql_databases | SQL servers and databases with SKU, status, and pool membership | | list_storage_accounts | Storage accounts with security posture and container inventory | | list_data_explorer_clusters | Data Explorer (Kusto) clusters and databases | | query_log_analytics | Run KQL queries against Log Analytics workspaces |

Networking

| Tool | Description | |------|-------------| | list_network_topology | VNets, subnets, NSGs, and public IPs — full network topology | | get_nsg_rules | NSG rules with allow/deny visualization sorted by priority |

Security & Identity

| Tool | Description | |------|-------------| | list_role_assignments | RBAC role assignments — who has what access where | | list_entra_identities | Entra ID users, app registrations, and service principals | | list_key_vaults | Key Vaults with secrets, keys, and certificates inventory | | get_alerts_summary | Active Azure Monitor alerts by severity and state | | get_resource_locks | Management locks (CanNotDelete, ReadOnly) across scopes |

DevOps & Deployment

| Tool | Description | |------|-------------| | list_deployments | Deployment history with status timeline | | get_deployment_operations | Step-by-step deployment operations for debugging failures | | preview_deployment | What-If preview — see what a deployment would change | | get_pipeline_runs | CI/CD pipeline runs from GitHub Actions or Azure DevOps | | list_template_specs | Organization template specs — pre-approved ARM templates | | generate_bicep | Generate Bicep templates from natural language | | generate_terraform | Generate Terraform HCL from natural language |

Governance & Compliance

| Tool | Description | |------|-------------| | get_advisor_recommendations | Advisor recommendations across all 5 pillars | | list_policy_compliance | Policy compliance summary with non-compliant policy details | | get_well_architected_review | Well-Architected Framework assessment across 5 pillars | | get_diagnostics | Diagnostic settings — where logs and metrics are routed | | list_activity_log | Audit log — who did what, when, and whether it succeeded |

AI Services

| Tool | Description | |------|-------------| | list_azure_ai_services | Cognitive Services / OpenAI accounts and model deployments |

Monitoring

| Tool | Description | |------|-------------| | get_metrics | Azure Monitor metrics time-series for any resource | | get_service_health | Service health incidents, maintenance, and advisories |

Architecture

| Tool | Description | |------|-------------| | visualize_architecture | Interactive topology diagram of resources in a resource group | | list_container_registries | Container Registries with SKU, policies, and config |

Development

git clone https://github.com/azure-core/mcp-ui.git azure-mcp-ui
cd azure-mcp-ui
pnpm install
pnpm build          # Build views + server
pnpm test           # Run all tests
pnpm dev            # Watch mode — rebuilds on changes

License

MIT