Design
Apply bilateral filter for edge-preserving smoothing that reduces noise while maintaining image details
Call this tool from your code in three languages.
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-bilateral-filter' \
-H 'Content-Type: application/json' \
-d '{"filename":"imageFile.ext","contentType":"application/octet-stream","size":12345}'
# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
--data-binary @/path/to/file.ext
# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/en/api/tools/image-bilateral-filter' \
-F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
-F 'spatialSigma=3' \
-F 'rangeSigma=30' \
-F 'kernelSize=5' \
-F 'iterations=1' \
-F 'preserveDetails=true' \
-F 'channels=all' \
-F 'format=original' \
-F 'quality=95'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/image-bilateral-filter| Name | Type | Required | Description |
|---|---|---|---|
| imageFile | fileupload required | Yes | Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) to apply edge-preserving bilateral filtering |
| spatialSigma | range | No | Controls spatial smoothing. Higher values smooth larger areas |
| rangeSigma | range | No | Controls edge preservation. Higher values preserve fewer edges |
| kernelSize | range | No | Size of the bilateral filter kernel (must be odd). Larger kernels consider more neighbors |
| iterations | number | No | Number of bilateral filter passes. More iterations = stronger smoothing |
| preserveDetails | checkbox | No | Maintain fine details and textures while smoothing |
| channels | select | No | Choose which color channels to process |
| 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 result
{
"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)"
}Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-image-bilateral-filter": {
"name": "image-bilateral-filter",
"description": "Apply bilateral filter for edge-preserving smoothing that reduces noise while maintaining image details",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-bilateral-filter",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "image-bilateral-filter",
"arguments": {
"imageFile": "https://example.com/file.ext",
"spatialSigma": 3,
"rangeSigma": 30,
"kernelSize": 5,
"iterations": 1,
"preserveDetails": true,
"channels": "all",
"format": "original",
"quality": 95
}
}
}Questions or issues? Contact [email protected]