micompress-mcp
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
micompress-mcp
An MCP server that lets AI agents compress images, PDFs, video, audio, documents & archives. Powered by micompress.com.
Ask your assistant "compress the screenshots in ./assets" and it will — no manual upload, no separate tool. Works with any Model Context Protocol client: Claude Desktop, Claude Code, Cursor, and others.
Hosted server (no install)
MiCompress also runs as a remote MCP server at https://micompress.com/mcp
(Streamable HTTP, no sign-in). It compresses files by URL and returns a download
link, so it suits Claude.ai, ChatGPT and other clients that cannot run local
commands. Docs: micompress.com/mcp-server.
claude mcp add --transport http micompress https://micompress.com/mcpFor files on your own disk, use the local server below.
Related MCP server: claw-tsaver
Setup (local server)
Claude Code
claude mcp add micompress -- npx -y micompress-mcpClaude Desktop / Cursor
Add to your MCP config (claude_desktop_config.json on Desktop):
{
"mcpServers": {
"micompress": {
"command": "npx",
"args": ["-y", "micompress-mcp"]
}
}
}API key (optional)
Without a key the server works anonymously, within per-type size limits. For bigger
files, sign in (free) at https://micompress.com/account, copy your personal key
(mc_…) and pass it as the MICOMPRESS_API_KEY environment variable. The key stays in
the server's environment — it is never sent to the model.
claude mcp add micompress -e MICOMPRESS_API_KEY=mc_yourkey -- npx -y micompress-mcp{
"mcpServers": {
"micompress": {
"command": "npx",
"args": ["-y", "micompress-mcp"],
"env": { "MICOMPRESS_API_KEY": "mc_yourkey" }
}
}
}With a key, files up to 100 MB are accepted. A free account includes 50
compressions/month through the API; Plus ($9.99/mo) includes 1,000/month and Pro
($19.99/mo) 5,000/month, shared with website usage. When the allowance runs out the tool
returns API_QUOTA_REACHED (free) or USAGE_LIMIT_REACHED (paid) — see
https://micompress.com/plans.
Tools
compress_file
Compresses a file and writes the smaller version to disk.
Input | Description |
| File to compress |
| Where to write it. Defaults to the input path with a |
|
|
| Images only — resize down to this width in pixels |
Returns the size before and after, plus the output path. The file bytes are never returned to the model — only the summary, so a large file can't flood the context window.
list_supported_formats
Lists every accepted extension, grouped by category.
Supported formats
Category | Formats |
Image | jpg, png, webp, gif, bmp, tiff, avif, svg, heic, psd, dng, raw, cr2, arw, nef |
PDF / Docs | pdf, docx, xlsx, pptx, doc, ppt, xls, epub, odt, ods, html, csv, txt, rtf |
Video | mp4, mov, avi, mkv, webm, m4v, wmv, flv |
Audio | mp3, wav, flac, ogg, m4a, aac, opus |
Archive | zip, 7z, tar, gz |
Full list: https://micompress.com/all-tools
How it works
Files are uploaded over HTTPS to micompress.com and compressed
with the same engine the website uses (mozjpeg, pngquant, gifski, Ghostscript, ffmpeg, …),
then written back to disk. Anonymous use works within per-type size limits
(images 20MB, video 50MB, …); set MICOMPRESS_API_KEY for files up to 100MB.
Point it at files you're comfortable sending to a third-party service. The agent passes a path; the file's contents leave your machine.
Requirements
Node.js >= 18
License
MIT © MiCompress
Prefer a UI, or need bigger files? Use micompress.com.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for Wan AI video generation
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for image and video processing that allows AI assistants to resize, convert, compress, and analyze media files locally without API keys. It supports a wide range of formats and provides tools for tasks such as metadata removal, frame extraction, and video conversion.13124 PyPI5MIT
- AlicenseAqualityDmaintenanceAn MCP server that helps AI agents reduce token usage by compressing, summarizing, and managing conversation/context data more efficiently.11MIT
- AlicenseNot gradedqualityCmaintenanceCompression AI - MCP server providing AI-powered tools and automation by MEOK AI Labs2 npm39 PyPIMIT
- AlicenseAqualityDmaintenanceLocal MCP server that compresses images and videos, extracts video frames, and prepares media for AI vision agents by returning file paths instead of inline base64.61MIT