# Scumble

> Scumble is an open-source MCP server for design and media. AI inpainting editor with layers that agents can drive through 119 MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux
- **Repository:** https://github.com/denrakeiw/scumble
- **MCP Registry name:** io.github.DenRakEiw/scumble
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Scumble is a desktop image editor where each AI edit comes back as its own layer, colour-matched to the surrounding picture. You select an area or draw boxes on an empty canvas and describe each one, and the result can be masked, blended, filtered and exported like any layer. Boxes can mark something new, kept, moved or removed, a reference picture or text, and reference layers are named in prompts as `@img1`, `@img2`.

The MCP server exposes the editor's commands to Claude Desktop, Claude Code or any client, 119 tools according to the README, so an agent works in the same window with the same undo. Rendering runs on your own ComfyUI, on Comfy Cloud, or directly through API keys for providers such as Black Forest Labs, OpenAI, Google, fal.ai and Replicate. Keys go in the system credential store.

It exports PSD with layers and masks and OpenRaster, handles documents of 15,000 by 10,000 pixels with a Rust tile engine, and has 46 film-look filters. It is free, GPL-3.0, on Windows today with early Linux builds, macOS not started, and the author says it is young and to keep backups.

## Features

- **Edits as layers:** Every AI result is a separate, maskable, blendable layer.
- **Box-based prompts:** Describe where new, kept, moved or text elements go.
- **Flexible rendering:** Your ComfyUI, Comfy Cloud or provider API keys.
- **Agent control:** 119 MCP tools to open, select, generate, match and export.
- **Layered export:** PSD and OpenRaster with layers and masks.
- **Large documents:** Tile engine keeps 15,000 by 10,000 pixel files workable.

## Good for

- Have an agent inpaint and remove an object in a photo
- Generate a new scene from described boxes
- Export an edited image as a layered PSD
- Run edits on a local ComfyUI instead of a paid API

## Install

### Claude Code (Terminal)

```sh
claude mcp add scumble -- npx -y https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "scumble": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scumble": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "scumble": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scumble": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scumble": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Yes. It is free software under GPL-3.0 and needs no account of its own; you pay model providers directly.

### Which platforms?

Windows today, Linux builds from CI that the author has not run yet, macOS not started.

### Do I need ComfyUI?

No. An API key alone is enough.

### How do agents connect?

Use Help, Copy MCP registration, or install the `.mcpb` file in Claude Desktop.

### Is Scumble free?

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

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

Run this command in your terminal: claude mcp add scumble -- npx -y https://github.com/DenRakEiw/scumble/releases/download/v0.1.56/scumble-0.1.56.mcpb

### What are the best alternatives to Scumble?

The closest alternatives to Scumble are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/scumble
