cleanor-app/cleanor-mcp

**A hosted, zero-auth MCP server with 22 tools: optimize and convert images, generate QR codes, and run the deterministic dev utilities LLMs get wrong.**
No API key. No signup. No OAuth. Point any Model Context Protocol client at one URL and 22 tools appear, all read-only and safe to hand to an autonomous agent.
| | |
|---|---|
| **Streamable HTTP endpoint** | https://mcp.cleanor.app/mcp |
| **npm package (stdio)** | @cleanor/mcp |
| **Official MCP Registry** | app.cleanor/cleanor |
| **Homepage** | cleanor.app/mcp |
| **Auth** | none |
| **Tools** | 22 |
| **Version** | 0.6.0 |
Install
Pick your client. Every option below points at the same hosted server, so there is nothing to build, install or key.
Claude Code
Then run claude mcp list to confirm it connected. Full walkthrough: docs/add-an-mcp-server-to-claude-code.md.
Cursor
Add to .cursor/mcp.json (per project) or ~/.cursor/mcp.json (global):
VS Code
Run code --add-mcp '{"name":"cleanor","type":"http","url":"https://mcp.cleanor.app/mcp"}', or add the server to .vscode/mcp.json in the workspace:
Claude Desktop
Open Settings, then Connectors, then "Add custom connector", and paste the endpoint:
Or run the server locally over stdio from claude_desktop_config.json:
The npm build is the same tool registry compiled for Node. It uses sharp (an optional dependency) for local image encoding; the other 21 tools need nothing.
Raw Streamable HTTP
The endpoint speaks the MCP Streamable HTTP transport, so you can drive it with curl or any HTTP client:
There is also a plain REST surface for non-MCP callers: GET /v1/capabilities (feature detection, machine-readable tool list) and POST /v1/optimize (one image in, optimized bytes out).
Tools
22 tools, every one of them carrying an input **and** an output schema, so a client gets typed structuredContent back and not just a wall of text.
Image
| Tool | What it does | Key params |
|---|---|---|
| optimize_image | Fetches an image from a public URL and re-encodes it smaller. Returns the optimized image plus before and after byte counts. Input capped at 25 MB. | image_url (required), format (webp \| avif \| jpeg, default webp), width (16 to 4096 px, optional), quality (1 to 100, default 80) |
| placeholder_image | Dependency-free SVG placeholder at any size, with a label and custom colors. | width (default 600), height (default 400), bg, color, text |
| qr_code | Encodes text or a URL as a crisp SVG QR code you can paste anywhere. | text (required, up to 2000 chars), ecc (L \| M \| Q \| H, default M), size (64 to 1024, default 320) |
Cited data (Cleanor Labs research)
| Tool | What it does | Key params |
|---|---|---|
| storage_capacity | How many photos or minutes of video actually fit in a storage tier, corrected for real OS and filesystem overhead. Returns a per-format breakdown. | storage_gb (required, 1 to 4096), content (photos \| video, default photos) |
| image_format_savings | How much smaller WebP, AVIF or JPEG XL are than JPEG at matched perceptual quality, from a controlled benchmark on the 24-image Kodak suite. Also reports the HEIC conversion tax. | format (webp \| avif \| jxl, default avif), quality (web = SSIM 0.95, high = SSIM 0.98, default web) |
Dev utilities
The operations an LLM is unreliable at: hashing, counting, radix math, timezones. Pure compute, no network, no state.
| Tool | What it does | Key params |
|---|---|---|
| hash | SHA-1/256/384/512 hex digest of text. MD5 is deliberately not offered. | input (required), algorithm (default sha-256) |
| hmac | Keyed HMAC signature, hex or Base64. For signing and verifying webhooks. | message (required), secret (required), algorithm (default sha-256), encoding (hex \| base64) |
| uuid | UUID v4 (random) or v7 (time-sortable, the better database key). | version (v4 \| v7, default v4), count (1 to 100) |