Fast, privacy-first image compression and conversion API
mochify-cli
A command-line tool and MCP server for mochify.xyz — a fast, privacy-first image compression and conversion API powered by a native C++ engine.
Compress and convert images to modern formats (AVIF, JXL, WebP, Jpegli) from your terminal, or give AI assistants like Claude direct access to image processing via the Model Context Protocol.
Installation
macOS (Homebrew):
brew tap getmochify/mochify
brew install mochify
Linux / WSL:
# x86_64
curl -L https://github.com/getmochify/mochify-cli/releases/latest/download/mochify-linux-x86_64 -o mochify
chmod +x mochify
sudo mv mochify /usr/local/bin/
# arm64
curl -L https://github.com/getmochify/mochify-cli/releases/latest/download/mochify-linux-arm64 -o mochify
chmod +x mochify
sudo mv mochify /usr/local/bin/
Manual: All binaries at Releases.
From source:
cargo install --path .
CLI Usage
mochify [OPTIONS] <FILES>...
Options
| Flag | Description |
|---|---|
-t, --type <FORMAT> |
Output format: jpg, png, webp, avif, jxl |
-w, --width <N> |
Target width in pixels |
-H, --height <N> |
Target height in pixels |
--crop |
Crop to exact dimensions |
-r, --rotation <DEG> |
Rotation: 0, 90, 180, 270 |
-o, --output <DIR> |
Output directory (default: same as input) |
-p, --prompt <TEXT> |
Natural-language prompt — resolves params automatically |
-k, --api-key <KEY> |
API key (or set MOCHIFY_API_KEY env var) |
Examples
# Convert a JPEG to AVIF
mochify photo.jpg -t avif
# Resize and convert to WebP
mochify photo.jpg -t webp -w 800
# Batch convert a folder to AVIF at 1200px wide
mochify ./images/*.jpg -t avif -w 1200 -o ./compressed
# With an API key
MOCHIFY_API_KEY=your-key mochify photo.jpg -t jxl
# Use a natural-language prompt instead of explicit flags
mochify photo.jpg -p "convert to avif and resize to 1200px wide"
# Prompt works with multiple files too
mochify ./images/*.jpg -p "compress for web, keep under 1000px wide" -o ./out
Free usage is 25 images per day without an API key. Visit mochify.xyz for more.
MCP Server (Claude Desktop)
mochify can run as an MCP server, letting Claude process images on your behalf directly from conversation.
Setup
Add the following to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mochify": {
"command": "mochify",
"args": ["serve"]
}
}
}
With an API key (for higher limits):
{
"mcpServers": {
"mochify": {
"command": "mochify",
"args": ["serve"],
"env": {
"MOCHIFY_API_KEY": "your-key-here"
}
}
}
}
Restart Claude Desktop. The mochify server will appear in your connections.
Usage
Just describe what you want in natural language, with the full path to your image:
"Convert
/Users/me/Desktop/photo.jpgto AVIF at 1000px wide"
"Compress all the JPEGs in
/Users/me/projects/blog/images/to WebP and save them to/Users/me/projects/blog/compressed/"
Claude will call the squish tool automatically.
API
Powered by the mochify.xyz API at https://api.mochify.xyz/v1/squish.
- Images are processed in-memory and never stored on disk
- Supports JPEG (Jpegli), AVIF, JXL, WebP, and PNG output
- Up to 25MB per image
Visit mochify.xyz for the web interface.
Tools (1)
squishProcesses images in-memory to convert, compress, or resize them based on natural language instructions.Environment Variables
MOCHIFY_API_KEYAPI key for higher usage limitsConfiguration
{"mcpServers": {"mochify": {"command": "mochify", "args": ["serve"]}}}