# Shell Command Runner

> Use this tool when you need to execute shell commands and scripts securely, enabling system automation, file manipulation, and integration with command-line tools. It solves problems requiring standardized interface and proper output handling for both standard output and error streams. The Shell Command Runner takes shell commands as input and returns the execution output, making it ideal for workflows that require command-line tool integration within a conversation interface.

Canonical page: https://skillsregistry.net/skills/shell-command-runner  
JSON: https://api.skillsregistry.net/v1/skills/shell-command-runner

## Description

MCP Server CLI enables AI assistants to execute shell commands and scripts securely through a standardized interface. Built by hdcola, it leverages the Model Context Protocol SDK to create a simple server that runs on stdio, allowing commands to be executed with proper output handling for both standard output and error streams. The implementation is written in TypeScript and packaged as an npm module that can be installed globally, making it particularly valuable for workflows requiring system automation, file manipulation, or integration with command-line tools without leaving the conversation interface.

## Trust

- **Trust score (0–1):** 0.65
- **Verification tier:** scanned
- **Last scanned:** 2026-09-02

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** file-system
- **Updated:** 2026-09-02

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/shell-command-runner)
- **Repository:** <https://github.com/hdcola/mcp-server-cli>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "shell-command-runner"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/shell-command-runner` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/shell-command-runner/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt