PDF Tools
Remove visual noise from scanned PDF pages — salt-and-pepper speckle, random grain, and faint background haze — using real image-processing algorithms. Text pages are preserved as searchable vector content.
Call this tool from your code in three languages.
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/pdf-denoise' \
-F 'file=@/path/to/sourceFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/en/api/tools/pdf-denoise' \
-F 'sourceFile=/public/samples/pdf/sample-multipage.pdf' \
-F 'mode=auto' \
-F 'strength=2' \
-F 'rasterizeText=false' \
-F 'pageRange='Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/pdf-denoise| Name | Type | Required | Description |
|---|---|---|---|
| sourceFile | fileupload required | Yes | — |
| mode | select | Yes | Auto: balanced median + despeckle (preserves tone). Median: best for salt-and-pepper/impulse noise. Binarize: Otsu threshold turns faint backgrounds white and text solid black. |
| strength | number | No | Number of 3x3 median filter passes (1–3). Higher = stronger noise removal but more softening. Ignored in Binarize mode. |
| rasterizeText | select | No | By default text pages are preserved as searchable vector content (not denoised). Enable this only for OCR'd scans whose underlying image is noisy, accepting loss of text selectability. |
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-pdf-denoise": {
"name": "pdf-denoise",
"description": "Remove visual noise from scanned PDF pages — salt-and-pepper speckle, random grain, and faint background haze — using real image-processing algorithms. Text pages are preserved as searchable vector content.",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=pdf-denoise",
"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": "pdf-denoise",
"arguments": {
"sourceFile": "/public/samples/pdf/sample-multipage.pdf",
"mode": "auto",
"strength": 2,
"rasterizeText": "false",
"pageRange": ""
}
}
}| pageRange | text | No | Specify pages to denoise (e.g., 1-3,5,7-9). Leave blank to process all pages. |
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)"
}Questions or issues? Contact [email protected]