mcpbeat Sign in

Ag Bash MCP Server

local only

Ag Bash runs on your own machine — the client starts it, so there is no endpoint to ping. 64 installs a week from npm. Last commit 17 Sep 2026.

Sandboxed AI-native bash with 70 agentic tools: run_bash, code edit/diff, WASM Python/JS.

Installs per day peak 17 · avg 8 · +81% w/w
a month agotoday
64
Installs / week
npm · @ag-bash/mcp-server
0
Stars
3 open issues
17 Sep 2026
Last commit
0 releases in 90 days
Apache-2.0
License
TypeScript

What the code does

We read the source, 18 h ago · rules 3dff92dd89df

Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

Reaches cloud metadata service packages/bash/src/network/allow-list.ts:148
  "169.254.169.254", // AWS / GCP / Azure / OpenStack IMDS
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

  exec(commandLine: string, options?: ExecOptions): Promise<BashExecResult>;
    const fullPath = path.join(testDir, filePath);
    system(cmd);

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

We found things in this code

Code changes quietly between releases, and nobody reads the diff of a dependency. We do, on every release — watch Ag Bash and you get told the day something new turns up.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add ag-bash -- npx -y @ag-bash/mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ag-bash": {
      "args": [
        "-y",
        "@ag-bash/mcp-server"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.ag-bash]
command = "npx"
args = ["-y", "@ag-bash/mcp-server"]
.cursor/mcp.json
{
  "mcpServers": {
    "ag-bash": {
      "args": [
        "-y",
        "@ag-bash/mcp-server"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "ag-bash": {
      "args": [
        "-y",
        "@ag-bash/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Alternatives to Ag Bash

same job, measured the same way
Cinch
by yusufkadry

Run AI-generated code safely. gVisor-isolated Python/JS sandboxes for any MCP client. Pay per run.

27 installs/wk local only
SandboxAPI
by michielderuiter

Execute code in 8 languages (Python, JS, TS, Go, Java, C++, C, Bash) in gVisor sandboxes.

answering
Telleroutlook
by telleroutlook

WasmAgent MCP server — WASM-sandboxed code execution with capability manifests and Tasks API.

765 installs/wk local only
Cdbx
by cdbx

Build Apps and run code in 30 languages — sandboxed, with persistent sessions for agent loops.

answering
Codelens MCP
by segentic-lab

Deterministic code maps for AI agents: 7 tree-sitter tools for TS/JS/Py — map, find, function_body

local only
Weavatrix
by weavatrix

Native Weavatrix MCP: 64 read-only tools for code, n8n, Dify, agents, Mermaid, and Web3.

local only
STUzhy Py Execute MCP
by smithery

Run Python code in a secure sandbox without local setup. Declare inline dependencies and execute s…

answering
Grok Build
by nuruvala

Run the Grok Build CLI as MCP tools: agent runs with live progress, code review, web research.

126 installs/wk local only

Ag Bash — questions

Answers built from our own checks of this server.

Why is there no uptime for Ag Bash?
Ag Bash runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @ag-bash/mcp-server was installed 64 times last week.
How do I connect Ag Bash?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @ag-bash/mcp-server straight from npm; nothing to host, nothing to sign up for.
How many people use Ag Bash?
The npm package @ag-bash/mcp-server was installed 64 times in the last week. Week over week that is +81%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Ag Bash open source?
Yes — it is published under the Apache-2.0 licence, written in TypeScript, 0 stars on GitHub and 3 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.