# Ironclaw

> Ironclaw is an open-source MCP server for security. Run untrusted agent shell commands in a gVisor sandbox from any MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Linux
- **Website:** https://ironclaw.sh
- **Repository:** https://github.com/ironsecco/ironclaw
- **MCP Registry name:** io.github.IronSecCo/ironclaw
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

The MCP package is a thin client in an OCI image with no host privileges. It exposes a sandbox_exec tool and hands every run to an IronClaw control-plane you operate, which owns the hardened gVisor launch. If the control-plane URL is unset the tool fails closed, and the control-plane's bearer token is also required.

IronClaw itself targets self-hosted autonomous agents that you do not have to trust. According to its README, each sandbox runs with no network, reaches the model only through a host proxy, and cannot change its own configuration. A bundled demo script lets a jailbroken agent try to phone home, read the host filesystem and reach the Docker socket, and prints what was denied. A separate scan action grades a container's isolation from 0 to 100 in CI.

The README warns it is alpha software: flags, on-disk formats and interfaces can change without migration, and not every feature is tested end to end. Docker must be running for the demo.

## Features

- **Sandboxed command execution:** Runs shell commands from an agent inside a gVisor container.
- **Fail-closed backend:** The tool refuses to run when no control-plane is configured.
- **Thin client image:** Holds no host privilege and delegates launches to the control-plane.
- **Containment demo:** A one-command script shows a jailbroken agent being denied.
- **Isolation scoring:** A scan action grades container isolation from 0 to 100 in pull requests.

## Good for

- Let a coding agent run unreviewed shell commands safely
- Test how an agent behaves when jailbroken
- Gate merges on a sandbox isolation score
- Self-host agents without giving them host access

## Install

### Claude Code (Terminal)

```sh
claude mcp add ironclaw --env IRONCLAW_CONTROLPLANE_URL='<IRONCLAW_CONTROLPLANE_URL>' --env IRONCLAW_API_TOKEN='<IRONCLAW_API_TOKEN>' -- docker run -i --rm -e IRONCLAW_CONTROLPLANE_URL -e IRONCLAW_API_TOKEN ghcr.io/ironsecco/ironclaw-mcp:v0.1.569
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ironclaw": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IRONCLAW_CONTROLPLANE_URL",
        "-e",
        "IRONCLAW_API_TOKEN",
        "ghcr.io/ironsecco/ironclaw-mcp:v0.1.569"
      ],
      "env": {
        "IRONCLAW_CONTROLPLANE_URL": "<IRONCLAW_CONTROLPLANE_URL>",
        "IRONCLAW_API_TOKEN": "<IRONCLAW_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ironclaw": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IRONCLAW_CONTROLPLANE_URL",
        "-e",
        "IRONCLAW_API_TOKEN",
        "ghcr.io/ironsecco/ironclaw-mcp:v0.1.569"
      ],
      "env": {
        "IRONCLAW_CONTROLPLANE_URL": "<IRONCLAW_CONTROLPLANE_URL>",
        "IRONCLAW_API_TOKEN": "<IRONCLAW_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ironclaw": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IRONCLAW_CONTROLPLANE_URL",
        "-e",
        "IRONCLAW_API_TOKEN",
        "ghcr.io/ironsecco/ironclaw-mcp:v0.1.569"
      ],
      "env": {
        "IRONCLAW_CONTROLPLANE_URL": "<IRONCLAW_CONTROLPLANE_URL>",
        "IRONCLAW_API_TOKEN": "<IRONCLAW_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ironclaw": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IRONCLAW_CONTROLPLANE_URL",
        "-e",
        "IRONCLAW_API_TOKEN",
        "ghcr.io/ironsecco/ironclaw-mcp:v0.1.569"
      ],
      "env": {
        "IRONCLAW_CONTROLPLANE_URL": "<IRONCLAW_CONTROLPLANE_URL>",
        "IRONCLAW_API_TOKEN": "<IRONCLAW_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ironclaw": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IRONCLAW_CONTROLPLANE_URL",
        "-e",
        "IRONCLAW_API_TOKEN",
        "ghcr.io/ironsecco/ironclaw-mcp:v0.1.569"
      ],
      "env": {
        "IRONCLAW_CONTROLPLANE_URL": "<IRONCLAW_CONTROLPLANE_URL>",
        "IRONCLAW_API_TOKEN": "<IRONCLAW_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `sandbox_exec`: Runs a command in a sandbox through the IronClaw control-plane.

## FAQ

### What does it need to run?

A running IronClaw control-plane URL and its bearer token.

### What happens without a control-plane?

The tool fails closed.

### Is it production ready?

The README calls it alpha software and warns that interfaces can change.

### How is it distributed?

As an OCI image from ghcr.io, run over stdio.

### Is Ironclaw free?

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

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

Run this command in your terminal: claude mcp add ironclaw --env IRONCLAW_CONTROLPLANE_URL='<IRONCLAW_CONTROLPLANE_URL>' --env IRONCLAW_API_TOKEN='<IRONCLAW_API_TOKEN>' -- docker run -i --rm -e IRONCLAW_CONTROLPLANE_URL -e IRONCLAW_API_TOKEN ghcr.io/ironsecco/ironclaw-mcp:v0.1.569

### What are the best alternatives to Ironclaw?

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