Elysia Tools Docs
EN
Language
ZHESPTRUFRDEEN
Back to site
Browse tools

Text Processing

Filename Sanitizer

Clean and sanitize filenames by removing illegal characters for Windows, Linux, and Mac

text· Text resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL
curl -X POST 'https://api.elysiatools.com/en/api/tools/filename-sanitizer' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"Enter filename to sanitize...","replacementChar":"_","trimWhitespace":true,"trimDots":true,"maxLength":255}'

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP
POST https://api.elysiatools.com/en/api/tools/filename-sanitizer

Parameters

NameTypeRequiredDescription
filenametextYes—
replacementChartextNoCharacter to replace illegal characters with
trimWhitespacecheckboxNoRemove leading and trailing whitespace
trimDotscheckboxNoRemove leading and trailing dots (can cause issues in some systems)
maxLengthnumberNo

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json
{
  "mcpServers": {
    "elysiatools-filename-sanitizer": {
      "name": "filename-sanitizer",
      "description": "Clean and sanitize filenames by removing illegal characters for Windows, Linux, and Mac",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=filename-sanitizer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "filename-sanitizer",
    "arguments": {
  "filename": "Enter filename to sanitize...",
  "replacementChar": "_",
  "trimWhitespace": true,
  "trimDots": true,
  "maxLength": 255
}
  }
}
Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).

Questions or issues? Contact [email protected]

Browse toolsOpen tool

© 2026 Elysia Tools. Developer documentation.

Back to siteBrowse tools
Maximum filename length (0 = no limit, Windows typically limits to 255)

Response format

Text result

JSON
{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}