Categories

← View All Tools

Image Cropper

Crop images to specific dimensions or aspect ratios with custom positioning

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: image/jpeg, image/png, image/webp, image/gif, image/bmp, image/tiff

Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for cropping

Choose how to crop your image: square, aspect ratio, exact dimensions, or custom positioning

Select a predefined aspect ratio for cropping. The image will be cropped to match this ratio

Set the exact width for cropped area. Will be limited to image width if larger

Set the exact height for cropped area. Will be limited to image height if larger

Choose where to position the crop area. Works with all crop modes

Set the horizontal position for crop area (0 = left edge). Will be adjusted if outside image bounds

Set the vertical position for crop area (0 = top edge). Will be adjusted if outside image bounds

Choose output format or keep original. Converting to JPEG may reduce quality for transparency

Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

API Documentation

Request Endpoint

POST /en/api/tools/image-cropper

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for cropping
cropMode select Yes Choose how to crop your image: square, aspect ratio, exact dimensions, or custom positioning
aspectRatio select No Select a predefined aspect ratio for cropping. The image will be cropped to match this ratio
width number No Set the exact width for cropped area. Will be limited to image width if larger
height number No Set the exact height for cropped area. Will be limited to image height if larger
gravity select No Choose where to position the crop area. Works with all crop modes
x number No Set the horizontal position for crop area (0 = left edge). Will be adjusted if outside image bounds
y number No Set the vertical position for crop area (0 = top edge). Will be adjusted if outside image bounds
format select No Choose output format or keep original. Converting to JPEG may reduce quality for transparency
quality number No Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

File type parameters need to be uploaded first via POST /upload/image-cropper to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-image-cropper": {
      "name": "image-cropper",
      "description": "Crop images to specific dimensions or aspect ratios with custom positioning",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-cropper",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]