How do I install Roundcut?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Roundcut need an API key?

No required environment variable is listed on this record.

What transport does Roundcut use?

Roundcut runs locally over stdio.

When was Roundcut last checked?

Last checked 2026-11-08. Local image tools: circle crop, crop, resize, compress, convert JPG/PNG/WebP/AVIF. By RoundCut.

Roundcut MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.araluma-roundcut-mcp -- npx -y roundcut-mcp@0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.araluma-roundcut-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.2
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

roundcut-mcp

Local image tools for AI agents, as an MCP server. Circle crop, crop, resize, compress and convert JPG, PNG, WebP and AVIF on your own machine with sharp. No network calls, no accounts, no upload: the files never leave the disk.

Made by RoundCut, the free image tools site (29 languages).

Install

Node 20 or newer.

npx roundcut-mcp

Claude Desktop / Claude Code

{
  "mcpServers": {
    "roundcut": { "command": "npx", "args": ["-y", "roundcut-mcp"] }
  }
}

Claude Code: claude mcp add roundcut -- npx -y roundcut-mcp

Cursor, Windsurf, VS Code

Same shape: a stdio server, command npx, args -y roundcut-mcp.

Smithery

smithery.ai/servers/araluma/roundcut-mcp installs a self-contained bundle for macOS (Apple Silicon) and Windows (x64). On Linux or an Intel Mac, use npx above.

Tools

Tool	What it does	An agent calls it when
`image_info`	Format, dimensions, alpha, EXIF orientation.	the user asks what an image is, or before picking crop/resize numbers
`circle_crop`	Round profile picture: centered square plus a circular transparent mask. `size`, `format` (png default), `background` for jpeg.	the user wants a round avatar for Discord, Slack, LinkedIn, WhatsApp or GitHub
`crop_image`	Pixel box (`left`, `top`, `width`, `height`) or a centered `aspect` such as `1:1`, `4:5`, `16:9`.	the user wants part of an image or a fixed ratio (square post, 4:5 portrait, 16:9 banner)
`resize_image`	By `width`, `height` or `percent`. Keeps the aspect ratio, never enlarges unless `enlarge: true`. Lanczos3.	the user gives target pixel dimensions
`compress_image`	Smaller file, same format. `quality` for jpg/webp/avif (mozjpeg for jpg), lossless recompression for png.	the file must be lighter (upload limit, faster page) at the same size and format
`convert_image`	To `jpeg`, `png`, `webp` or `avif`. Input may also be GIF, TIFF or HEIC. Transparency kept, or flattened onto `background` for jpeg.	the user needs another file type, e.g. iPhone HEIC to JPG, PNG to WebP
`roundcut_web_tools`	Links to the browser tools this server does not run locally: background remover, AI upscaler, batch convert, JPG to PDF.	the user asks for one of those, instead of declining

Every tool takes an input path and writes next to it by default (photo.jpg becomes photo-circle.png, photo-resized.jpg, photo.webp), or to output. Results carry a text summary, a resource_link to the file, structured JSON (output, format, width, height, bytes, inputBytes) and a small JPEG preview (preview: false to skip it).

Example, from a chat client with the server attached:

Make ~/Pictures/me.jpg a 512 px round avatar as WebP.

calls circle_crop with { "input": "~/Pictures/me.jpg", "size": 512, "format": "webp" } and answers with the file path, the dimensions and the byte count.

Limits

Inputs above 80 megapixels are refused, so a stray call cannot allocate gigabytes.
EXIF orientation is applied on read; the output is upright and carries no EXIF.
jpeg has no alpha: transparent areas are flattened onto background (white by default).

Develop

npm install
npm test        # builds, then node --test

src/engine.ts is the pure image layer (tested directly). src/index.ts adapts it to MCP tools.

Smithery release: scripts/build-mcpb.sh builds build/roundcut-mcp-<version>.mcpb from mcpb/manifest.json (25 MB cap, so only the macOS arm64 and Windows x64 sharp binaries go in), then scripts/publish-smithery.sh uploads it with the tool schemas read from the built server.

Roundcut

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Roundcut?

Does Roundcut need an API key?

What transport does Roundcut use?

When was Roundcut last checked?

Documentation

roundcut-mcp

Install

Claude Desktop / Claude Code

Cursor, Windsurf, VS Code

Smithery

Tools

Limits

Develop

License