Image Tools

Working

co.byondr/image-toolsv0.1.0 Domain verified

Resize, compress, convert, crop, rotate and watermark images, one at a time or in a zip.

Design & Creative

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://byondr.co/image-tools/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

create_upload

Get a one-hour signed upload URL for an image or a zip that is too large to send inline (over 3 MB; up to 100 MB here) or that already sits on disk. PUT the raw bytes to upload_url with a Content-Length header, then pass file_id to process_images. Free.

bytesinteger, required

Exact size of the file you will upload, in bytes (at most 100 MB)

filenamestring

Original file name, used to name the output

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (2)

create_upload

Argument	Type	Description
bytes*	integer	Exact size of the file you will upload, in bytes (at most 100 MB)
filename	string	Original file name, used to name the output

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "bytes"
  ],
  "properties": {
    "bytes": {
      "type": "integer",
      "maximum": 104857600,
      "minimum": 1,
      "description": "Exact size of the file you will upload, in bytes (at most 100 MB)"
    },
    "filename": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Original file name, used to name the output"
    }
  }
}

process_images

Resize, crop, rotate, flip, compress (to a file size with target_bytes), convert (jpeg, png, webp, avif), strip EXIF and GPS metadata from, and watermark (text, logo or both) one image or a zip of up to 50 images (up to 500 files per zip; files that are not supported images are skipped and listed). Crops are in pixels by default; for a zip of different sizes use crop_unit "percent" or crop_aspect, which are worked out per image. Give exactly one source: file_id (from create_upload), url (public https) or data_base64 (up to 3 MB inline; use create_upload, up to 100 MB, or url above that). One image in returns one image; a zip returns a zip. AVIF output is scaled down to fit 1,200 px on the longest side and WebP output to 36 megapixels. Returns a 24-hour download_url with the size and format of every output, and for each output the kinds of metadata found in the input and left in the output (location, date, camera, serial number, ...) and whether the colour profile was kept; kinds only, never the values. keep_date and keep_copyright write back the EXIF date taken and copyright after stripping. Large zips can take up to a minute; use a client timeout of at least 120 s. Free. Daily quotas are counted per caller in output megapixels; see start.md.

Argument	Type	Description
fit	string	How to fit into width x height: scale-down never enlarges; cover fills and crops; pad adds borders
url	string	Or a public https URL of an image or zip
flip	string	Flip: h = horizontal, v = vertical, hv = both
width	integer	Width in pixels
format	string	Output format (keep turns HEIC into JPEG and GIF into PNG)
height	integer	Height in pixels
rotate	number	Rotate clockwise (degrees)
file_id	string	Image or zip file (up to 25 MB on this page)
quality	integer	Quality 1-100 for JPEG, WebP and AVIF; lower is smaller. Ignored with target_bytes
crop_top	number	Crop: top edge (px, or % of the height with crop_unit percent)
filename	string	Name for the output when the source has none
max_side	integer	Instead of width and height: the longest side in pixels, per image, so portrait and landscape images both get it on their long edge. Never enlarges unless fit is contain

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "fit": { "enum": [ "scale-down", "contain", "cover", "pad" ], "type": "string", "default": "scale-down", "description": "How to fit into width x height: scale-down never enlarges; cover fills and crops; pad adds borders" }, "url": { "type": "string", "format": "uri", "description": "Or a public https URL of an image or zip" }, "flip": { "enum": [ "none", "h", "v", "hv" ], "type": "string", "default": "none", "description": "Flip: h = horizontal, v = vertical, hv = both" }, "width": { "type": "integer", "maximum": 12000, "minimum": 1, "description": "Width in pixels" }, "format": { "enum": [ "keep", "jpeg", "png", "webp", "avif" ], "type": "string", "default": "keep", "description": "Output format (keep turns HEIC into JPEG and GIF into PNG)" }, "height": { "type": "integer", "maximum": 12000, "minimum": 1, "description": "Height in pixels" }, "rotate": { "enum": [ 0, 90, 180, 270 ], "type": "number", "default": 0, "description": "Rotate clockwise (degrees)" }, "file_id": { "type": "string", "description": "Image or zip file (up to 25 MB on this page)" }, "quality": { "type": "integer", "default": 82, "maximum": 100, "minimum": 1, "description": "Quality 1-100 for JPEG, WebP and AVIF; lower is smaller. Ignored with target_bytes" }, "crop_top": { "type": "number", "maximum": 12000, "minimum": 0, "description": "Crop: top edge (px, or % of the height with crop_unit percent)" }, "filename": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Name for the output when the source has none" }, "max_side": { "type": "integer", "maximum": 12000, "minimum": 1, "description": "Instead of width and height: the longest side in pixels, per image, so portrait and landscape images both get it on their long edge. Never enlarges unless fit is contain" }, "crop_left": { "type": "number", "maximum": 12000, "minimum": 0, "description": "Crop: left edge (px, or % of the width with crop_unit percent)" }, "crop_unit": { "enum": [ "px", "percent" ], "type": "string", "default": "px", "description": "Unit of the four crop fields: px (whole pixels) or percent (0-100 of each image, so a zip of different sizes gets the same part of every image)" }, "keep_date": { "type": "boolean", "default": false, "description": "With strip_metadata: keep the EXIF date taken (DateTimeOriginal and DateTimeDigitized, with their time zone and fraction of a second) so photos still sort by date. A date and time taken found only in XMP or PNG text is written as the EXIF DateTimeOriginal; IPTC dates are not kept" }, "background": { "type": "string", "default": "#ffffff", "pattern": "^#[0-9a-fA-F]{6}$", "description": "JPEG only: colour under transparent areas, #rrggbb" }, "crop_width": { "type": "number", "maximum": 12000, "description": "Crop: width (px, or % of the width with crop_unit percent)", "exclusiveMinimum": 0 }, "crop_aspect": { "enum": [ "1:1", "4:5", "5:4", "4:3", "3:4", "3:2", "2:3", "16:9", "9:16" ], "type": "string", "description": "Instead of the four crop fields: the largest centered crop of this width:height ratio, per image" }, "crop_height": { "type": "number", "maximum": 12000, "description": "Crop: height (px, or % of the height with crop_unit percent)", "exclusiveMinimum": 0 }, "data_base64": { "type": "string", "description": "Base64 bytes of an image or zip, up to 3 MB decoded; use create_upload (up to 100 MB) or url above that" }, "resize_unit": { "enum": [ "px", "percent" ], "type": "string", "default": "px", "description": "Unit of width and height: px, or percent (1-1000) of each image's own size, so a zip of different sizes is scaled alike. Over 100 enlarges only with fit contain" }, "watermark_x": { "type": "number", "maximum": 100, "minimum": 0, "description": "With watermark_position custom: the centre of the text, % of each image's width from the left (0-100)" }, "watermark_y": { "type": "number", "maximum": 100, "minimum": 0, "description": "With watermark_position custom: the centre of the text, % of each image's height from the top (0-100)" }, "target_bytes": { "type": "integer", "maximum": 50000000, "minimum": 10000, "description": "Instead of quality: the most bytes each output may have (10,000-50,000,000; 1 MB = 1,000,000), for upload forms with a size limit. Uses the highest quality from 45 to 92 that fits; if even 45 is too big, the image is scaled down too. Each item then reports the quality used, and over_target when it could not get under" }, "keep_copyright": { "type": "boolean", "default": false, "description": "With strip_metadata: keep the EXIF Copyright tag. XMP and IPTC rights are not kept" }, "strip_metadata": { "type": "boolean", "default": true, "description": "Remove EXIF, GPS location and camera data" }, "watermark_size": { "type": "number", "maximum": 400, "description": "Watermark font size: px (8-400, whole numbers) or, with watermark_size_unit percent, % of each image's width (0.5-20, giving 12-1000 px). Default 4% of the width", "exclusiveMinimum": 0 }, "watermark_text": { "type": "string", "maxLength": 100, "minLength": 1, "description": "Watermark text" }, "watermark_color": { "type": "string", "default": "#ffffff", "pattern": "^#[0-9a-fA-F]{6}$", "description": "Watermark color, #rrggbb" }, "watermark_image": { "type": "string", "minLength": 1, "description": "Logo for the watermark, with or instead of watermark_text: a file_id from create_upload, a public https url, or data:image/png;base64,... (up to 1 MB inline; an inline image and logo share the 3 MB inline limit). PNG with transparency is best; WebP and JPEG work. Up to 2 MB and 2048 px on the longest side; rasterise SVG to PNG first. With text, the logo sits left of the text and both are placed as one" }, "watermark_opacity": { "type": "number", "default": 0.6, "maximum": 1, "minimum": 0.05, "description": "Watermark opacity, 0.05 to 1" }, "watermark_position": { "enum": [ "bottom-right", "bottom-left", "top-right", "top-left", "center", "tile", "custom" ], "type": "string", "default": "bottom-right", "description": "Watermark position; custom places the centre of the text at watermark_x, watermark_y" }, "watermark_size_unit": { "enum": [ "px", "percent" ], "type": "string", "default": "px", "description": "Unit of watermark_size: px, or percent of each image's width (so a zip of different sizes gets the same relative size)" }, "watermark_image_size": { "type": "number", "maximum": 50, "minimum": 2, "description": "Logo width, % of each image's width (2-50). Default 15" } } }