# MiCompress

> MiCompress is a freemium MCP server for design and media. Compress images, PDFs, video, audio and archives from your AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.99 a month
- **Platforms:** CLI, API, Web
- **Website:** https://micompress.com
- **Repository:** https://github.com/micompress/micompress-mcp
- **MCP Registry name:** com.micompress/mcp
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

Files stay out of the model's context: when the assistant compresses something, only a before-and-after size summary comes back, so a large video or PDF can't flood the conversation. The local server reads a path on disk and writes the smaller copy next to it with a -min suffix, or over the original if you pass the same path.

Compression uses the same engine as the micompress.com website, which the README names as mozjpeg, pngquant, gifski, Ghostscript and ffmpeg. Files are uploaded over HTTPS to micompress.com, so the README advises pointing it only at files you are comfortable sending to a third-party service.

There are two ways to connect. The local server runs through npx and needs Node.js 18 or later. A hosted remote server at micompress.com/mcp takes a file URL instead of a path and returns a download link, which suits clients that cannot run local commands. Anonymous use works within per-type size limits; a free personal API key raises the limit to 100 MB.

## Features

- **Local file compression:** Takes a file path, compresses it and writes the result to disk with a -min suffix or in place.
- **Three presets:** Choose lossless, recommended (the default) or extreme depending on how much quality you can trade.
- **Image resizing:** An optional max_width setting shrinks images down to a given pixel width while compressing.
- **Hosted URL mode:** A remote server at micompress.com/mcp compresses files by URL and returns a download link.
- **Summary-only results:** Only sizes and the output path return to the model, never the file bytes.
- **Wide format coverage:** Handles common image, document, video, audio and archive formats such as png, pdf, mp4, mp3 and zip.

## Good for

- Shrink a folder of screenshots before committing them to a repository
- Reduce a large PDF so it fits an email attachment limit
- Re-encode a video or audio file to a smaller size from a chat prompt
- Resize and compress product photos to a maximum width

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://micompress.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://micompress.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://micompress.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://micompress.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://micompress.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://micompress.com/mcp"
    }
  }
}
```

## Tools

- `compress_file`: Compresses a file and writes the smaller version to disk, returning the size before and after.
- `list_supported_formats`: Lists every accepted file extension, grouped by category.

## FAQ

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

Run claude mcp add micompress -- npx -y micompress-mcp for the local server, or claude mcp add --transport http micompress https://micompress.com/mcp for the hosted one.

### Do I need an API key?

No. It works anonymously within per-type size limits such as 20 MB for images and 50 MB for video. A free personal key set as MICOMPRESS_API_KEY allows files up to 100 MB.

### Do my files leave my machine?

Yes. The local server uploads the file to micompress.com over HTTPS to compress it, so use it only with files you are comfortable sending to a third party.

### What are the API allowances?

A free account includes 50 compressions a month through the API. Plus is listed at $9.99 a month for 1,000 and Pro at $19.99 a month for 5,000, shared with website usage.

### Is MiCompress free?

MiCompress has a free plan, with paid plans for more usage or features. Paid plans start at $9.99 a month.

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

Run this command in your terminal: claude mcp add --transport http mcp https://micompress.com/mcp

### What are the best alternatives to MiCompress?

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

## 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.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [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.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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