Image Normalise

Normalise image histogram to enhance contrast by stretching the intensity range (British spelling)

Image File *

Click to upload file or drag and drop file here

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

Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) to enhance contrast through histogram normalisation

Auto Contrast

Automatically enhance contrast using 1% and 99% percentiles (recommended for most images)

Lower Percentile

0.1 1 10

Percentage of darkest pixels to ignore (0.1% - 10%). Lower values preserve more shadow detail

Upper Percentile

90 99 99.9

Percentage of brightest pixels to ignore (90% - 99.9%). Higher values preserve more highlight detail

Output Format

Choose output format or keep original. PNG recommended for maximum quality

Quality (1-100)

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

API Documentation

Request Endpoint

POST /en/api/tools/image-normalise

Request Parameters

Parameter Name	Type	Required	Description
imageFile	file (Upload required)	Yes	Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) to enhance contrast through histogram normalisation
autoContrast	checkbox	No	Automatically enhance contrast using 1% and 99% percentiles (recommended for most images)
lowerPercentile	range	No	Percentage of darkest pixels to ignore (0.1% - 10%). Lower values preserve more shadow detail
upperPercentile	range	No	Percentage of brightest pixels to ignore (90% - 99.9%). Higher values preserve more highlight detail
format	select	No	Choose output format or keep original. PNG recommended for maximum quality
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-normalise 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-normalise": {
      "name": "image-normalise",
      "description": "Normalise image histogram to enhance contrast by stretching the intensity range (British spelling)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-normalise",
      "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]