Skip to content
MCP-Bridge
Developer ToolsAuto-generatedScore: 28

RunCommandsClient MCP Server

The RunCommandsClient is a sophisticated management API provided by Microsoft Azure as part of its Compute resource provider, specifically engineered to enable remote command execution on Azure virtual machines.

Quick Start Summary

The RunCommandsClient MCP server is a Model Context Protocol bridge that connects AI assistants — including Claude Desktop, Cursor, Windsurf, and VS Code Copilot — to the RunCommandsClient API through natural language. It exposes 3 API endpoints as callable tools, such as VirtualMachineRunCommands_List, VirtualMachineRunCommands_Get, VirtualMachines_RunCommand. No authentication is required — setup takes approximately 30 seconds. The server uses STDIO transport and can be installed by running npx -y @mcp/azure-com-compute-runcommands. This integration is sourced from the auto RunCommandsClient OpenAPI specification (v2017-03-30) and has a quality score of 28/99 (fair documentation coverage).

3Endpointstools mapped
NoneAuthopen access
28/99Qualityfair
~30 secSetupno auth
View Hosted Config URLClaude Desktop Setup Guide

Server Details

Category
Developer Tools
Authentication
None
Endpoints
3 operations
Transport
STDIO
Spec Version
v2017-03-30
Install Command
npx -y @mcp/azure-com-compute-runcommands

Environment Variables

RUNCOMMANDSCLIENT_API_KEY

Example: your_runcommandsclient_api_key

Top Endpoints

GET
/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/runCommands

VirtualMachineRunCommands_List

GET
/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/runCommands/{commandId}

VirtualMachineRunCommands_Get

POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommand

VirtualMachines_RunCommand

Own this API?

Verify ownership of this listing to control the description, configuration details, and documentation links. Choose between free manual verification or instant premium placement.

Option 1: Free Verification

Slow manual review. Requires creating a GitHub issue with verified documentation or domain verification.

  • • Verified badge on page
  • • Standard search sorting
  • • 2-3 business days review
Start Free Claim →
Instant & Boosted

Option 2: Featured Upgrade($9/mo)

Instant verification plus premium styling, featured badges, and directory placement boost.

  • • ★ Featured star & amber highlight border
  • • Top of directory search placement
  • • Instant activation via claim token

📖 Detailed MCP Integration Guide

A technical breakdown of capabilities, agent workflows, and security/configuration best practices.

⚡Capabilities & Use Cases
The RunCommandsClient is a sophisticated management API provided by Microsoft Azure as part of its Compute resource provider, specifically engineered to enable remote command execution on Azure virtual machines. This service transcends basic remote access by offering a structured, auditable, and programmable interface for performing administrative, diagnostic, and configuration tasks without requiring direct SSH or RDP connectivity. Core capabilities include the ability to discover available built-in run commands across various Azure regions, retrieve detailed information about specific commands and their parameters, and critically, to execute these commands against target virtual machines within a defined scope. Typical enterprise use cases are extensive, ranging from automated patching and software deployment across a fleet of VMs to performing intricate diagnostic data collection for troubleshooting, executing configuration management scripts in a just-in-time manner, and implementing infrastructure-as-code patterns where post-provisioning state adjustments are required. For enterprise DevOps teams, this API becomes a cornerstone for maintaining consistency and control in large-scale environments, while for developers, it offers a powerful tool for debugging and managing resources programmatically.
🤖AI Agent Value
When exposed as tools through a Model Context Protocol (MCP) server, the RunCommandsClient provides immense contextual power to AI coding assistants like Claude Desktop or Cursor. The value lies in transforming abstract infrastructure tasks into concrete, actionable API calls that the AI can understand and invoke. Instead of generating generic shell scripts, an AI agent can directly interface with the Azure API layer, leveraging exact command IDs, validating parameter schemas, and understanding regional command availability. This allows the AI to act as a context-aware operations partner, capable of not just writing code, but executing valid management actions within the user's cloud environment. It bridges the gap between intent and implementation, enabling the AI to provide precise, platform-native solutions that account for Azure-specific APIs, error codes, and resource hierarchies, thereby significantly increasing the accuracy and utility of generated automation workflows.
💬Example Workflows
In practical workflow scenarios, a developer can instruct the AI agent to perform dynamic, context-rich tasks that directly impact their infrastructure. For example, a user could ask, "List all available run commands in East US for my Windows VMs and find the one to check disk usage, then execute it on VM 'web-server-prod-01'." The AI agent would first use the GET /locations/{location}/runCommands endpoint to inventory available commands, parse the results to identify the appropriate RunPowerShellScript or RunShellScript command, and then invoke the POST /virtualMachines/{vmName}/runCommand endpoint with the correctly structured script payload. Another scenario could be, "Query the detailed parameters for the 'EnableNvidiaGpuDriver' command in West Europe and create a script that applies it to all GPU-enabled VMs in resource group 'ML-Models'," demonstrating the AI's ability to retrieve metadata, synthesize new logic, and orchestrate a scaled operation. These examples highlight how the AI becomes a dynamic orchestrator, performing research, validation, and execution in a seamless loop based on natural language instructions.
🛡️Security & Auth
Crucially, while the endpoint descriptions may not list an authentication method, deploying and using this API in any production or development environment absolutely requires robust authentication and authorization. The RunCommandsClient is protected by Azure Active Directory (now Microsoft Entra ID) and requires an OAuth 2.0 access token with appropriate permissions. Security best practices must be rigorously followed: tokens should be scoped to the minimal set of resources and actions necessary, adhering to the principle of least privilege. A service principal or managed identity used by the MCP server should be granted the Microsoft.Compute/virtualMachines/runCommand/action permission only on the specific resource groups or subscriptions it manages, rather than broad Contributor roles. Developers must ensure that the MCP server configuration secures these credentials, never exposing tokens in logs or client-side code, and should leverage Azure RBAC roles like the built-in "Virtual Machine Contributor" or create custom roles with granular permissions. Network security controls, such as restricting API access via Azure Private Link or virtual network service endpoints, should also be considered to ensure that command execution traffic remains within trusted network boundaries.

Similar APIs

Other APIs in the Developer Tools category.

GitHub API

Access GitHub repositories, issues, pull requests, and more. Integrate GitHub workflows directly into your AI agent.

OAuth2

GitLab API

Manage repositories, CI/CD pipelines, and merge requests through your AI agent.

OAuth2

Box Platform API

The Box Platform API, provided by Box (box.com), is a robust and comprehensive RESTful service that enables deep integration with the Box cloud content management ecosystem. It serves as the programmatic backbone for enterprises and developers seeking to build custom applications and workflows that interact with content stored securely in Box. Its core capabilities extend far beyond basic file operations, encompassing a full spectrum of content lifecycle management. Developers can programmatically create, upload, download, search, and manage files and folders, but the API's true power lies in its enterprise-grade features. These include advanced collaboration management through invitations and permissions, granular user and group administration within an enterprise directory, and sophisticated security and compliance controls. Specific endpoint groups for managing collaboration whitelists and exempt targets allow for precise governance over external sharing policies, ensuring that content is only shared with approved domains. Furthermore, the API facilitates complex legal and compliance use cases, such as placing items on legal hold or applying retention policies, making it an indispensable tool for regulated industries and large organizations.

Asana

This API serves as the programmatic backbone for the Asana work management platform, provided by Asana, Inc. It enables developers to interact programmatically with one of the world's leading enterprise collaboration and productivity suites. The core capabilities of this interface center around the CRUD (Create, Read, Update, Delete) operations for fundamental Asana objects. Specifically, the provided endpoints grant control over project attachments—allowing for the uploading, retrieval, and management of files associated with tasks and projects—and custom fields, which are pivotal for creating structured, data-rich workflows. These custom fields allow organizations to define unique data types (like dropdown menus, text fields, or dates) to standardize information capture across projects, moving beyond basic task lists to true operational tracking. Typical use cases span from enterprise project management offices (PMOs) needing to programmatically generate status reports and audit attachments, to development teams automating the creation of bug-tracking projects with predefined custom fields for severity and status, to operational leaders building dashboards that aggregate and analyze custom field data for resource allocation insights.

Related MCP Server Integrations

GitHub API MCP Setup

Access GitHub repositories, issues, pull requests, and more. Integrate GitHub workflows directly into your AI agent.

Developer ToolsConfigure →

GitLab API MCP Setup

Manage repositories, CI/CD pipelines, and merge requests through your AI agent.

Developer ToolsConfigure →

Box Platform API MCP Setup

The Box Platform API, provided by Box (box.com), is a robust and comprehensive RESTful service that enables deep integration with the Box cloud content management ecosystem. It serves as the programmatic backbone for enterprises and developers seeking to build custom applications and workflows that interact with content stored securely in Box. Its core capabilities extend far beyond basic file operations, encompassing a full spectrum of content lifecycle management. Developers can programmatically create, upload, download, search, and manage files and folders, but the API's true power lies in its enterprise-grade features. These include advanced collaboration management through invitations and permissions, granular user and group administration within an enterprise directory, and sophisticated security and compliance controls. Specific endpoint groups for managing collaboration whitelists and exempt targets allow for precise governance over external sharing policies, ensuring that content is only shared with approved domains. Furthermore, the API facilitates complex legal and compliance use cases, such as placing items on legal hold or applying retention policies, making it an indispensable tool for regulated industries and large organizations.

Developer ToolsConfigure →

Asana MCP Setup

This API serves as the programmatic backbone for the Asana work management platform, provided by Asana, Inc. It enables developers to interact programmatically with one of the world's leading enterprise collaboration and productivity suites. The core capabilities of this interface center around the CRUD (Create, Read, Update, Delete) operations for fundamental Asana objects. Specifically, the provided endpoints grant control over project attachments—allowing for the uploading, retrieval, and management of files associated with tasks and projects—and custom fields, which are pivotal for creating structured, data-rich workflows. These custom fields allow organizations to define unique data types (like dropdown menus, text fields, or dates) to standardize information capture across projects, moving beyond basic task lists to true operational tracking. Typical use cases span from enterprise project management offices (PMOs) needing to programmatically generate status reports and audit attachments, to development teams automating the creation of bug-tracking projects with predefined custom fields for severity and status, to operational leaders building dashboards that aggregate and analyze custom field data for resource allocation insights.

Developer ToolsConfigure →

clickup20 MCP Setup

The clickup20 Polls API is a lightweight, focused web service designed to facilitate the creation and management of simple polling mechanisms. Provided by ClickUp, a platform known for its project management and productivity tools, this API serves as a specialized component for gathering quick, quantitative feedback. Its core capabilities are straightforward: it allows consumers to programmatically retrieve a list of existing poll questions and to submit new poll questions for consideration. Typical use cases span both enterprise and consumer domains. In an enterprise setting, a development team might integrate this API to run quick polls during sprint retrospectives, gauge internal sentiment on a new tool, or gather binary feedback on proposed technical designs within a project management workflow. For consumer applications, it could power simple feedback widgets within a mobile app or website, enabling users to vote on feature priorities or content topics. The API’s simplicity, requiring no authentication, makes it highly accessible for rapid prototyping and integration into internal tools where complex credential management is unnecessary.

Developer ToolsConfigure →