# agend-sh

> agend-sh is an MCP server for cloud and infrastructure. Persistent Linux environments for AI agents, with interactive terminals and HTTPS previews. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $39 a month
- **Platforms:** Linux, CLI, API
- **Website:** https://agend.sh
- **Repository:** https://github.com/agend-sh/cli
- **MCP Registry name:** io.github.agend-sh/agend-sh
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-16

## About

agend gives an agent its own isolated Linux machine to drive over MCP. The headline feature is input readiness: when a program in the terminal stops and waits for typing, such as an installer prompt, a Python REPL or a database session, the tool response says so, and the agent can answer in the same session. Sessions and files persist between tool calls, and an agent can start services and open a browser preview URL, or you can mirror its terminal with agend watch.

Each environment runs in a Firecracker microVM with its own guest kernel. Idle environments sleep, after 30 minutes on Developer and 2 hours on Pro, and external connections may need to reconnect after waking. The site is clear that task success still needs its own verification, and that if an API or plain script already does the job, you should keep using it.

You bring your own agent and model; agend charges for compute and storage. A 7-day trial needs no card, paid plans start at $39 per month, and it requires an account and environment quota. The CLI installs by script or Homebrew and can configure Claude Code, Codex, Cursor and Gemini.

## Features

- **Input-readiness signals:** Responses report when a terminal program is waiting for input.
- **Persistent sessions:** REPL and database state survives between tool calls.
- **Firecracker isolation:** Each environment is a microVM with its own kernel.
- **Interactive tools:** Send keystrokes and read output through shell_exec and shell_send_raw.
- **Preview URLs:** Expose services over HTTPS and watch the terminal live.
- **Client setup:** The CLI configures several MCP clients automatically.

## Good for

- Let an agent answer an installer's interactive prompts
- Keep a Python variable alive across tool calls
- Run a CLI test suite that needs repeated navigation
- Preview a web app an agent is building

## Install

### Claude Code (Terminal)

```sh
claude mcp add agend-sh --env AGEND_API_TOKEN='<AGEND_API_TOKEN>' -- docker run -i --rm -e AGEND_API_TOKEN ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agend-sh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AGEND_API_TOKEN",
        "ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f"
      ],
      "env": {
        "AGEND_API_TOKEN": "<AGEND_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agend-sh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AGEND_API_TOKEN",
        "ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f"
      ],
      "env": {
        "AGEND_API_TOKEN": "<AGEND_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agend-sh": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AGEND_API_TOKEN",
        "ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f"
      ],
      "env": {
        "AGEND_API_TOKEN": "<AGEND_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agend-sh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AGEND_API_TOKEN",
        "ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f"
      ],
      "env": {
        "AGEND_API_TOKEN": "<AGEND_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agend-sh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AGEND_API_TOKEN",
        "ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f"
      ],
      "env": {
        "AGEND_API_TOKEN": "<AGEND_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_environments`: List your agend environments
- `shell_exec`: Run a command, optionally interactive
- `shell_send_raw`: Send raw input to an interactive session

## FAQ

### Is there a trial?

Yes, 7 days with one small environment and no credit card.

### What do plans cost?

Plans start at $39 per month; they charge for compute and storage, not AI usage.

### Does it include a model?

No. You bring your own agent and model access.

### What isolates the environments?

Each runs in a Firecracker microVM with its own guest kernel.

### Is agend-sh free?

agend-sh is a paid product with a free trial. Paid plans start at $39 a month.

### How do I add agend-sh to Claude Code?

Run this command in your terminal: claude mcp add agend-sh --env AGEND_API_TOKEN='<AGEND_API_TOKEN>' -- docker run -i --rm -e AGEND_API_TOKEN ghcr.io/agend-sh/agend-mcp@sha256:4462e2571be0e69003e1be93255e04523342e1e5aa17482ec3d63bd7506bb82f

### What are the best alternatives to agend-sh?

The closest alternatives to agend-sh are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agend-sh
