Edit images from your AI assistant
Connect Mochify once and your assistant can compress, convert, crop, hide, erase and recolor the images you give it, and work on your PDFs, by asking in plain English. You describe the result. Where a box is needed, the assistant looks at the picture and chooses it. Mochify does the pixel work and hands back the file.
Works with Claude Desktop, Cursor and any client that supports MCP. Free account: 25 images a month. Images are processed in memory at api.mochify.app and wiped as soon as the job finishes; the model that picks a box never sends Mochify a description of what is in it.
Two ways to connect
Hosted: nothing to install
In Claude Desktop, go to Settings, then Connectors, add https://mcp.mochify.app and sign in when the browser window opens. Cursor and other clients that support remote MCP connectors follow the same shape. From then on the assistant has five Mochify tools: squish for images, create_upload for a photo attached to the chat, pdf and pdf_create for documents, and check_usage for your allowance.
Results come back as a download link on files.mochify.app that works for about five minutes. The assistant receives the link, never the image.
Local: one binary, your disk
brew tap getmochify/mochify
brew install mochify
mochify auth loginThen three lines in your client's MCP config:
{
"mochify": {
"command": "mochify",
"args": ["serve"]
}
}The same binary is the Mochify command-line tool. As a local server it returns file paths, so results are written to your disk and no image bytes enter the chat. Linux binaries and cargo install are on GitHub. Either way the pixels are processed at api.mochify.app, not on your machine; the local server has no pickup store, which is the difference.
How a box works
Four of the sections below need a box: crop to a region, hide an area, erase an object, recolor an object. Your assistant looks at the image and chooses the box; Mochify receives four numbers, fractions of the upright picture from the top-left corner, never pixels and never a description of what the box contains. The assistant that can see the picture does the understanding. Mochify does the editing.
Compress and convert
"Convert hero.jpg to AVIF at 1200 pixels wide."
Every plan, including Free.
The squish tool takes an image by URL, by file path on the local server, or from a one-time upload link when the photo is attached to the chat. Out comes JPG (encoded with jpegli), WebP, AVIF, JPEG XL or PNG, resized if you asked, with the metadata stripped or kept as you ask. HEIC and HEIF from a phone or camera go in like any other format.
Crop and region
"Crop this to a square around the product." or "Crop to the mug on the right."
Every plan, including Free.
Two kinds of crop. A smart crop finds the subject itself and keeps it in frame at the size you asked for; it works best when the subject is obvious. A region crop is one your assistant chooses by looking at the image: it picks the rectangle, Mochify cuts it. A box that runs past the edge is trimmed to the picture.
Hide faces and areas
"Hide every face and the number plate, then give me a WebP."
Every plan, including Free.
Faces are found by Mochify's own detector on Mochify's servers; no third-party service sees the image. It is best-effort: it can miss small faces in a group and strong side profiles, so the assistant tells you how many faces it hid, and you check that against the people in the picture and ask for a box over anyone it missed. Other areas, a plate, an address label, a screen, are boxes the assistant chooses. Up to 64 areas in one call.
Hidden areas are filled solid black by default. You can ask for a blur instead, but blur is a cosmetic look: blurred text and faces can sometimes be partly recovered, so use the solid fill for anything that must stay secret. Redaction runs before any crop, so a crop can never uncover a hidden area, and a redacted image always has its metadata removed and any HDR gain map dropped, because an EXIF thumbnail or a gain map could still hold the original.
Erase an object
"Remove the bin on the left and fill in the background."
Paid plans, including the Day Pass.
Erase paints a boxed object out and fills the space with plausible background. Your assistant draws the box around the whole object with a margin, shadow included; Mochify finds the object's outline inside the box and repaints only the outline plus a margin, so as little of the scene as possible is invented. Up to eight objects in one call. It is best on small distractions against texture or a plain background: a bin, a cable, a stray passer-by. Large removals come out softer, because the model paints at a fixed 512 by 512.
Erase invents pixels. It is for tidying your own photos, and never a way to hide anything sensitive; for that, ask it to hide the area instead (see Hide faces and areas). An erased image always has its metadata removed and any HDR gain map dropped.
Recolor an object
"Make the jacket navy blue and keep the shading."
Paid plans, including the Day Pass.
Recolor changes the color of a boxed object and keeps its shading: every fold, highlight and texture stays where it was, and only the hue moves to the color you named. Your assistant boxes the exact part to recolor, the jacket rather than the whole person, and Mochify finds the outline inside the box so the object changes and the rectangle does not. Nothing is generated. A box with no clear object in it is skipped and reported, never painted as a block. Up to eight objects in one call. A recolored image always has its metadata removed and any HDR gain map dropped.
PDFs
"Compress this PDF so it will go by email." or "Split this into one PDF per page." or "Make a PDF from these three photos."
Building a PDF from images works on every plan, including Free: up to 3 images per PDF on Free, 20 on paid plans. Compressing, extracting the images, rasterizing pages and splitting need a paid plan or the Day Pass.
Compression recompresses the images inside the PDF and leaves text, fonts and vectors untouched, so the document stays searchable and is never larger than it was. Each PDF you compress counts as one image against your monthly allowance, however many images are inside it. Seller, Pro and the Day Pass handle PDFs of up to 10 pages; Growth goes further. A PDF over your plan's limit is refused, not returned half done.
Check your usage
"How many images do I have left this month?"
Every plan, including Free.
The check_usage tool returns what remains of your allowance for the current period, counted across every surface you use Mochify on: the web app, the assistant, the command line and the API share one monthly allowance. Each file you get back counts as one image.
How your images are handled
Images travel over HTTPS to api.mochify.app, are processed in memory and are wiped as soon as the job finishes. Nothing is written to disk, nothing containing your image is logged, and nothing is used to train AI. That holds for face detection, erase and recolor too: the models run on Mochify's own servers, with no third-party service in the loop. It is not local processing, on either server, and we would rather tell you exactly which one it is.
Two things the hosted server adds, and the local one does not. The finished file is held for about five minutes on files.mochify.app so that your download link works, then evicted whether or not it was fetched; only the link enters the chat. And when a photo is attached to the chat, the assistant cannot send its bytes, so it asks Mochify for a one-time upload link and either uploads the photo itself or hands you the link to drop it on. That original is kept in private storage, never publicly served, and deleted the moment processing starts, or after 15 minutes if it never does. The local server uses neither: the result is written straight to your disk. The full account is on our architecture page.
Plans
- Free account: 25 images a month, every tool except erase, recolor and the PDF-in operations
- Seller, Pro and Growth: the plan's monthly allowance, every tool, PDFs to 10 pages (Growth goes further)
- Day Pass: 100 uploads in 24 hours for $2, every tool, PDFs to 10 pages
- Each file you get back counts as one image, and each PDF you compress counts as one
Monthly plans and limits are on the pricing page.
Guides
- How the Mochify MCP Server Works: Hosted vs Local - the two surfaces, worked examples and what each costs in tokens.
- How to Use Mochify via MCP - the step-by-step setup in each client.
- How to Blur Faces or a License Plate in a Photo (Ask Your AI Assistant) - redaction on two real photos, including what the detector missed.
- Image Compression Inside Claude Code: The Mochify CLI + MCP Guide - the local binary in a coding session.
- Working with PDFs in AI Agent Workflows - extract, split and convert pages from an assistant.
- Why We Relaxed Our Zero-Retention Policy for MCP - the five-minute pickup store, and why it exists.