# ebman

> ebman is an open-source MCP server for cloud and infrastructure. Give a coding agent read access to your AWS Elastic Beanstalk fleet, with gated writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://www.poly.io/products/ebman/
- **Repository:** https://github.com/tombaldwin/ebman
- **MCP Registry name:** io.github.tombaldwin/ebman
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

This server is the MCP mode of ebman, an open-source terminal UI for Elastic Beanstalk modelled on k9s. Running `ebman mcp serve` hands an agent the same fleet view the keyboard user has: which environments are red, what has drifted from a baseline, config settings and per-environment cost, instead of shelling out to `aws elasticbeanstalk` and parsing JSON.

Reads are on by default. Passing `--allow-writes` enables two-phase writes: the tool returns a plan, a person reviews it, and only a confirm dispatches the change. Those writes sit behind the same pins, read-only switch and cross-process incident freeze the terminal UI honours. Actions are recorded in an audit log under `~/.cache/ebman`.

It uses the standard AWS credential chain (`AWS_PROFILE`, `AWS_REGION`, instance roles) and can query several regions and AssumeRole accounts in parallel. A `--demo` flag runs against a synthetic fleet with no AWS calls. Install with Homebrew or `cargo install ebman`; builds are for macOS (Apple Silicon and Intel) and Linux x86_64. Support plans from GBP 1,500 a year are offered.

## Features

- **Fleet read tools:** Agents read environments, lint results, drift, config and cost.
- **Two-phase writes:** With --allow-writes, a tool returns a plan and only a human confirm applies it.
- **Incident freeze:** Deploys can be frozen fleet-wide during an incident.
- **Audit log:** Each action and outcome is written to a local log.
- **Multi-account queries:** Reads run across regions and AssumeRole accounts in parallel.
- **Demo mode:** Try it on a synthetic fleet without calling AWS.

## Good for

- Ask an agent which Elastic Beanstalk environments are unhealthy and why
- Compare config drift between staging and production
- Review per-environment cost across a fleet
- Plan and confirm a rollback to the last known-good version
- Run read-only fleet checks in CI via the headless interface

## Install

### Claude Code (Terminal)

```sh
claude mcp add ebman -- npx -y ebman
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ebman": {
      "command": "npx",
      "args": [
        "-y",
        "ebman"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ebman": {
      "command": "npx",
      "args": [
        "-y",
        "ebman"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ebman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ebman"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ebman": {
      "command": "npx",
      "args": [
        "-y",
        "ebman"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ebman": {
      "command": "npx",
      "args": [
        "-y",
        "ebman"
      ]
    }
  }
}
```

## FAQ

### Does it change anything by default?

No. Reads are default; writes need --allow-writes and a human confirm of each plan.

### What licence is it?

The site states open source under MIT or Apache-2.0.

### How does it authenticate to AWS?

Through the standard AWS credential chain, using AWS_PROFILE and AWS_REGION if set.

### How is it installed?

With Homebrew (`brew install tombaldwin/tap/ebman`) or `cargo install ebman`.

### Does it help set up my MCP client?

Yes, `ebman mcp setup` prints the exact registration for your client.

### Is ebman free?

Yes. ebman is open source, so you can use and self-host it for free.

### How do I add ebman to Claude Code?

Run this command in your terminal: claude mcp add ebman -- npx -y ebman

### What are the best alternatives to ebman?

The closest alternatives to ebman 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/ebman
