Skip to content
MCP server

MiCompress

Compress images, PDFs, video, audio and archives from your AI assistant

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://micompress.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://micompress.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media