Watermark & Resize Studio MCP Server 🖼️⚡
An ultra-fast, local-first Model Context Protocol (MCP) server providing AI assistants (Claude Desktop, Cursor, Antigravity, Cline) with native capabilities to resize, watermark, and sanitize images for e-commerce, social media, and privacy compliance.
Official open-source MCP server powered by Watermark & Resize Studio.
🌟 Key Features
- ⚡ 100% Local Processing: All operations run locally via
sharp(libvips C++ engine). Zero cloud uploads, zero external API latency, zero bandwidth costs. - 🛍️ E-Commerce & Platform Presets: Instant batch-ready resizing for Shopify (2048x2048), Etsy (2000x2000), Instagram Square/Story/Portrait, YouTube Thumbnails, Facebook, and Pinterest.
- 🛡️ Copyright & Watermark Protection: Dynamic text and logo compositing with SVG drop shadows, 6-point positioning, opacity control, and repeating tiled patterns for asset protection.
- 🖼️ 1200x630 OpenGraph Social Cards: Generate viral Twitter/LinkedIn/OG preview cards with modern gradient themes (
dark-violet,ocean-blue,sunset,cyber-emerald), auto text-wrapping, brand pills, and background photo/logo overlays. - 🎯 Favicon & PWA Icon Pack: Generate multi-resolution
favicon.ico(16x16, 32x32, 48x48), Apple Touch icon (180x180), Android Chrome icons (192x192, 512x512),site.webmanifest, and copy-paste HTML tags from a single logo. - 🔒 Privacy EXIF / GPS Stripper: Completely removes GPS geolocation coordinates, camera serial numbers, and creator metadata before public publishing.
- 🚀 WebP & MozJPEG Compression: Reduces file sizes by 85–95% while maintaining crisp visual fidelity.
🚀 Quick Setup (Claude Desktop & Cursor)
Because watermark-studio-mcp is published on the official npm registry, setup takes 10 seconds with zero build steps.
1. Claude Desktop
Add to your Claude configuration file:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"watermark-studio": {
"command": "npx",
"args": ["-y", "watermark-studio-mcp"]
}
}
}
2. Cursor AI
Add to .cursor/mcp.json in your workspace:
{
"mcpServers": {
"watermark-studio": {
"command": "npx",
"args": ["-y", "watermark-studio-mcp"]
}
}
}
3. Verified on Glama
Explore schemas, interactive docs, and test calls on Glama.ai Directory (A-Grade Verified).
🛠️ Included Tools
1. resize_for_platform
Resize, convert format (WebP, MozJPEG, PNG), and optimize images with standard platform presets or custom dimensions.
| Parameter | Type | Required | Description |
|---|---|---|---|
image_path | string | Yes | Absolute or relative path to the image file. |
platform | string | No | Preset: shopify, etsy, instagram_square, instagram_portrait, instagram_story, youtube_thumb, facebook_post, pinterest_pin, custom (Default: shopify). |
width | number | No | Custom width in pixels (overrides preset). |
height | number | No | Custom height in pixels (overrides preset). |
fit | string | No | cover, contain, fill, inside, outside (Default: inside for e-commerce, cover for social). |
format | string | No | webp, jpeg, png, original (Default: webp). |
quality | number | No | Quality level from 1 to 100 (Default: 85). |
output_path | string | No | Custom destination path (Defaults to [name]-[platform].[format]). |
2. apply_watermark
Apply copyright text or brand logo watermarks to an image to prevent unauthorized reuse or web scraping.
| Parameter | Type | Required | Description |
|---|---|---|---|
image_path | string | Yes | Path to the source image file. |
text | string | No* | Text watermark (e.g., "© 2026 MyStore.com"). |
logo_path | string | No* | Path to logo PNG/SVG to overlay. |
position | string | No | bottom-right (default), bottom-left, top-right, top-left, center, tile. |
opacity | number | No | Watermark opacity between 0.05 and 1.0 (Default: 0.6). |
font_size | number | No | Text font size in pixels (auto-scales if omitted). |
color | string | No | Hex color code (Default: #ffffff). |
margin | number | No | Border margin in pixels (Default: 35). |
output_path | string | No | Custom destination path. |
*At least one of text or logo_path must be provided.
3. strip_photo_metadata
Sanitize photos by wiping EXIF tags, GPS geo-coordinates, camera serials, and XMP edit history.
| Parameter | Type | Required | Description |
|---|---|---|---|
image_path | string | Yes | Path to the image file to sanitize. |
output_path | string | No | Custom destination path (Defaults to [name]-clean.[ext]). |
format | string | No | same, webp, jpeg, png (Default: same). |
4. batch_process_folder
Bulk process an entire directory of photos in parallel: resize with platform presets (Shopify, Etsy, Instagram), convert formats, apply watermarks, and strip metadata in a single automated command.
| Parameter | Type | Required | Description |
|---|---|---|---|
folder_path | string | Yes | Path to folder containing image files to process. |
output_folder | string | No | Target folder (Defaults to [folder_path]/optimized_[platform]). |
platform | string | No | Preset: shopify, etsy, instagram_square, youtube_thumb, etc. (Default: shopify). |
format | string | No | webp, jpeg, png, original (Default: webp). |
quality | number | No | Quality level from 1 to 100 (Default: 85). |
watermark_text | string | No | Optional brand text to watermark onto every photo. |
watermark_position | string | No | bottom-right, bottom-left, top-right, center (Default: bottom-right). |
max_concurrency | number | No | Parallel worker concurrency (Default: 4). |
5. generate_social_card
Generate professional 1200x630 OpenGraph and Twitter preview cards with modern gradients, bold typography, brand pill badges, and optional background photo or logo overlays.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Headline text for the social card (e.g., blog post title or product update). |
subtitle | string | No | Supporting subheader or descriptive tagline. |
brand_name | string | No | Brand/category text for top pill badge (Default: Watermark & Resize Studio). |
theme | string | No | Gradient scheme: dark-violet, ocean-blue, sunset, cyber-emerald (Default: dark-violet). |
logo_path | string | No | Path to brand logo PNG/SVG to overlay in top-right. |
background_image_path | string | No | Path to background photo (automatically blurred with dark contrast mask). |
format | string | No | png, webp, jpeg (Default: png). |
quality | number | No | Compression quality from 1 to 100 (Default: 90). |
output_path | string | No | Custom destination path (Defaults to social-card-[slug].[format]). |
6. generate_favicon_ico_pack
Generate a complete production-grade favicon and web application icon suite from a single master logo image, including multi-resolution favicon.ico, Apple Touch icons, Android PWA Chrome icons, site.webmanifest, and copy-paste <head> HTML tags.
| Parameter | Type | Required | Description |
|---|---|---|---|
image_path | string | Yes | Path to the master logo/icon image (PNG, SVG, JPG, WebP). |
output_dir | string | No | Destination directory for favicon files (Defaults to ./favicons). |
app_name | string | No | App name for site.webmanifest (Default: My Web App). |
app_short_name | string | No | Short name for mobile app icon (Defaults to app_name). |
theme_color | string | No | Theme color hex code for browser chrome (Default: #ffffff). |
background_color | string | No | Background color hex code for splash screen (Default: #ffffff). |
padding_percent | number | No | Padding percent (0-30) inside frame to prevent edge clipping (Default: 0). |
💻 Running from Local Source (Development)
To run directly from a local clone of this repository instead of npm:
{
"mcpServers": {
"watermark-studio": {
"command": "node",
"args": [
"C:/path/to/watermark-studio-mcp/src/index.js"
]
}
}
}
🧪 Testing
Run the included automated verification test suite:
npm test
This verifies:
- Preset image resizing (Shopify, Instagram, YouTube HD) with WebP compression.
- Text, logo, and tiled watermark compositing with SVG drop shadows.
- EXIF, GPS, and IPTC privacy sanitization.
- Parallel multi-core batch processing of entire image folders.
- 1200x630 OpenGraph social card generation with gradient themes and brand badges.
- Multi-resolution
favicon.ico, Apple Touch, Android PWA icon pack, andsite.webmanifestgeneration. - Live JSON-RPC protocol compliance over
stdio.
🌐 Ecosystem & Web Studio
Looking for a visual web app with real-time live preview canvas, batch drag-and-drop, and zero-server client-side processing?
Visit Watermark & Resize Studio.
- Trust Center: watermarkresizestudio.com/trust/
- Privacy Architecture: watermarkresizestudio.com/privacy/
- Image Optimization Guides: watermarkresizestudio.com/guides/
- E-Commerce Use Cases: watermarkresizestudio.com/use-cases/shopify.html
💼 Commercial Licensing & Pro Web Studio
While watermark-studio-mcp is 100% free and open-source under the MIT license for personal and developer workflows, businesses and content teams looking for visual batch processing can unlock the full Web Studio Pro Lifetime License:
- Unlimited Batch Processing: No 3-image batch limit.
- Logo & Transparent Watermarking: Overlay PNG brand logos and angled copyright patterns.
- EXIF & Privacy Sanitization: Strip GPS coordinates and camera metadata before publishing.
- 4K Ultra-Res Output: Export up to 4K resolution with sequential file renaming.
- Zero Recurring Fees: One-time payment of $28.99 with lifetime updates.
👉 Get Pro Lifetime License ($28.99) (Secured by Lemon Squeezy, Merchant of Record)
Agentic Commerce: Automated AI shopping agents can inspect our machine-readable catalog at /.well-known/ucp.json.