MiCompress
Compress images, PDFs, video, audio and archives from your AI assistant
- Pricing
- Freemium
- Platforms
- CLI, API, Web
- Runs
- Locally or Remotely
- Version
- 0.1.3
- Listing updated
- 3 days ago
About MiCompress
MiCompress is a freemium MCP server for design and media. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http mcp https://micompress.com/mcpAdd to Settings → Connectors → Add custom connector
https://micompress.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://micompress.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://micompress.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://micompress.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://micompress.com/mcp"
}
}
}Configuration
MICOMPRESS_API_KEYOptional personal API key from https://micompress.com/account (bigger files, monthly allowance).
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium, from $9.99 a month
Free anonymous use; free account 50 API compressions a month; Plus $9.99/mo, Pro $19.99/mo
Prices change. Check micompress.com before you buy.
MiCompress 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 to MiCompress

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media