1.2.0npm · shell-exec-mcp · current release
Observed 2026-08-17T18:19:45.737Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.
{
"tools": {
"listChanged": true
}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
executeRun a command in bash.
Returns stdout, stderr, and exit code. Default timeout is 5 seconds.
For long-running commands, set 'background: true' to run in background and get a job ID. Then use get_status to check on it.
Tips:
- Use background mode for commands that take more than a few seconds
- For file searches, use 'find' or 'grep'
- For file operations, use 'mv', 'rm', 'mkdir -p', 'stat' etc.Input schema{
"type": "object",
"properties": {
"command": {
"type": "string",
"description": "The bash command to run"
},
"timeout_ms": {
"type": "number",
"description": "Timeout in milliseconds (default: 5000)"
},
"background": {
"type": "boolean",
"description": "Run in background and return job ID"
}
},
"required": [
"command"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
get_job_statusCheck status of a background job.
Returns stdout/stderr collected so far, exit code (null if still running), and whether the job is still running.
Completed jobs are cleaned up after their status is read.Input schema{
"type": "object",
"properties": {
"jobId": {
"type": "string",
"description": "The job ID returned from execute with background: true"
}
},
"required": [
"jobId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |