filewash
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
filewash — privacy-first file tools for AI agents
The file-processing layer for agents and apps that can't send files to a third party. Compress, convert, resize, merge/split PDFs, strip metadata, and remove backgrounds — exposed as an MCP server, a metered REST API, and an npm SDK. Zero-retention by default: files are processed in memory and never stored or logged.
Built from filewash.app's client-side WASM tools. Same logic, now callable by your agents.
Why this exists
Every other file-tools API and MCP server is a wrapper around an upload-to-server service. That's a non-starter for legal, healthcare, finance, and any GDPR-bound workflow — and it's a liability when you're piping documents into an LLM. filewash is the one built around not keeping your files, with two tools nobody else ships as an MCP: background removal and metadata scrubbing.
Related MCP server: pdf-agent-toolkit-mcp
MCP server (Claude Desktop, Cursor, Claude Code)
// claude_desktop_config.json → mcpServers
{
"filewash": { "command": "node", "args": ["/path/to/filewash-api/src/mcp/server.js"] }
}Your agent now has 11 tools. Ask it: "strip the location metadata from these photos before I upload them" or "merge these contracts and rotate the scanned pages."
REST API
# discover
curl https://api.filewash.app/v1/tools
# strip EXIF/GPS from a photo (returns the cleaned image)
curl -X POST https://api.filewash.app/v1/tools/image_strip_metadata \
-H "Authorization: Bearer $FILEWASH_KEY" \
-F 'files=@photo.jpg' -o clean.jpg
# merge PDFs
curl -X POST https://api.filewash.app/v1/tools/pdf_merge \
-H "Authorization: Bearer $FILEWASH_KEY" \
-F 'files=@a.pdf' -F 'files=@b.pdf' -o merged.pdfEvery response carries X-Filewash-Meta (operation result) and X-Filewash-Quota-Remaining.
Tools
Tool | Category | What it does |
| Merge PDFs into one | |
| Extract specific pages | |
| Rotate pages by 90° | |
| privacy | Remove author/title/producer/dates |
| image | Lossy re-encode at a target quality |
| image | jpeg ↔ png ↔ webp ↔ avif |
| image | Resize (never upscales) |
| privacy | Strip EXIF/GPS/ICC/XMP |
| image | Remove background → transparent PNG (local AI model, no upload) |
| image | Tile a text watermark |
| generate | QR code PNG from text/URL |
Pricing (planned)
Plan | Price | Quota | Retention |
Free | $0 | 100 ops/mo | in-memory |
Pro | ~$19/mo | 10,000 ops/mo | in-memory |
Business | ~$99/mo | unlimited | zero-retention guarantee + audit log + BAA |
Run locally
npm install
npm run test:engine # 10 tools, end-to-end, no browser
npm run mcp # stdio MCP server
npm run rest # REST API on :8787 (try key "demo")Privacy
No file is written to disk by the REST API; the MCP server writes output only to the path you pass. No file contents are logged. The Business tier adds a contractual zero-retention guarantee and audit logging.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
PDF and image tools for AI agents: compress, merge, split, OCR, sign. Runs locally, never uploads.
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
Free PDF tools for AI agents: merge, split, rotate, watermark, page numbers, metadata, flatten.
PDF tools for AI agents: validate, extract, merge, split, compress, OCR, sign and redact.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI agents with local file-processing capabilities for token counting, RAG chunking, CSV/JSON conversion, QR generation, and more, while keeping documents private on the user's machine.71MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to perform comprehensive PDF operations locally, including compression, text extraction, PII redaction, page organization, splitting, merging, watermarking, creation, and form filling, all without cloud uploads.21 npm-
- AlicenseBqualityBmaintenanceEnables AI agents to perform local-first PDF processing entirely on-device, including OCR write-back to make scans searchable, unlocking and re-encrypting PDFs, splitting/merging/rotating pages, and compressing files, with no cloud calls or file uploads.251MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and run over 500 tools for PDF, text, data, crypto, network, and conversion tasks, with file processing done locally or at the edge so inputs are not uploaded.MIT