PoshMcp

Transform PowerShell into AI-consumable tools with zero code changes.

PoshMcp is a Model Context Protocol (MCP) server that dynamically exposes PowerShell scripts, cmdlets, and modules as secure, discoverable tools for AI agents and automation platforms. Built for PowerShell experts who want to extend their automation capabilities to AI-powered workflows.

What is PoshMcp?

PoshMcp bridges the gap between traditional PowerShell automation and modern AI interfaces. It provides:

• Automatic Tool Discovery: PowerShell commands become AI tools without manual registration
• Persistent State: Variables, functions, and modules persist across command executions
• Flexible Deployment: Run as stdio server (for MCP clients) or HTTP server (for web integration)
• Enterprise Ready: Built on .NET 10 with OpenTelemetry, health checks, and Azure Managed Identity support

Perfect for: DevOps engineers, system administrators, and PowerShell toolmakers who want to democratize access to their automation scripts.

Full documentation at https://usepowershell.github.io/PoshMcp/

Quick Example

Expose a PowerShell command to an AI agent:

# Your PowerShell command - no changes needed
Get-Service -Name "wuauserv"

PoshMcp automatically:

1. Discovers Get-Service and its parameters
2. Generates JSON schema for AI consumption
3. Exposes it as an MCP tool named Get-Service
4. Handles parameter validation and execution
5. Returns structured results to the AI agent

Result: AI agents can now check Windows service status using natural language.

Key Features

For PowerShell Experts

• Zero Boilerplate: Existing scripts work without modification
• State Preservation: Variables and custom functions persist between calls
• Pattern-Based Filtering: Include/exclude commands via configuration
• Rich Metadata: Automatic extraction from Get-Help and Get-Command (description precedence)
• MCP Resources: Expose files and live system state as readable resources
• MCP Prompts: Define reusable prompt templates with dynamic arguments

For Operations Teams

• Multi-User Isolation: Separate PowerShell runspaces in web mode
• Health Monitoring: /health and /health/ready endpoints for Kubernetes
• Correlation IDs: Request tracing across distributed systems
• OpenTelemetry: Built-in metrics and observability
• Contextual Data: Share runbooks, policies, and live system state with AI agents

For Developers

• Dual Transport: stdio (MCP clients) or HTTP (web integration)
• Dynamic Assembly Generation: Efficient caching of command metadata
• Thread-Safe Execution: Async/await throughout with proper synchronization
• VS Code Integration: Debug configurations and tasks included
• MCP Protocol Support: Resources, Prompts, Tools, and Sampling protocols

Getting Started

Prerequisites

• .NET 10.0 Runtime
• PowerShell 7.x (included via Microsoft.PowerShell.SDK)

Installation

# Install the CLI tool
dotnet tool install -g poshmcp

# Create a default config in the current directory
poshmcp create-config

# Run stdio server (for MCP clients)
poshmcp serve --transport stdio

# Run HTTP server (for web integration)
poshmcp serve --transport http --port 8080

Preview builds: To install the latest preview from GitHub Packages, see Installing Preview Builds in the Getting Started guide.

From source:

git clone https://github.com/microsoft/poshmcp.git
cd poshmcp

# Build the project
dotnet build

# Run stdio server (for MCP clients)
dotnet run --project PoshMcp.Server -- serve --transport stdio

# Run HTTP server (for web integration)
dotnet run --project PoshMcp.Server -- serve --tr

... [View full README on GitHub](https://github.com/usepowershell/PoshMcp#readme)