Glassypic

What glassypic MCP server does

The glassypic MCP server exposes GlassyPic's image optimization workflow to MCP clients through a single tool named optimize_image. It accepts an absolute local path or a remote URL and produces an optimized asset at a selected path or directory. If no destination is supplied, the result is saved beside the source image with either an SEO-based filename or a .polished suffix.

The tool can compress an image while retaining its format and dimensions, change the output format, resize proportionally, or produce exact dimensions. When both width and height are supplied, the default behavior adds white padding; selecting crop uses a smart crop instead. AI upscaling is available at 2× or 4×. SEO generation is enabled by default and can return an alt text, keyword list, and slug-based filename.

How it works

The glassypic MCP server receives tool arguments from the connected client, sends the image through GlassyPic's server-side processing pipeline, and returns both a text summary and structured output. Results include the output path, byte size, dimensions, format, compression ratio, and any generated SEO fields. The service typically applies additional compression as part of processing; a requested maximum file size is a target rather than a guarantee.

Supported input formats include JPG, PNG, WebP, AVIF, GIF, SVG, ICO, HEIC, HEIF, TIFF, and BMP. Output formats are JPG, PNG, WebP, AVIF, GIF, SVG, and ICO. HEIC, TIFF, and BMP inputs are converted to JPG during upload because they are not available as output formats. SVG files can remain vector files or be converted to and from raster formats, while ICO processing can create a favicon set or a specified single size.

Animated GIFs require special handling. GIF output preserves animation and can use a frame limit from 1 to 100 to reduce processing cost. Converting an animated GIF to JPG, PNG, WebP, or AVIF keeps only its first frame. The client must set confirm_gif_cost to true after the animated-image cost warning before processing proceeds. Uploads are limited to 50 MB.

Setup and configuration

Install the glassypic MCP server by adding its stdio command to an MCP client configuration:

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

The package does not require signup and includes 20 free daily credits. Claude Desktop, Cursor, Windsurf, and Cline use JSON configuration files. Claude Code, Gemini CLI, and OpenAI Codex CLI also provide commands for registering the server. On Windows, clients that cannot resolve npx from PATH may need to invoke it through cmd /c; this workaround does not apply to the listed CLI registration commands.

Tools and capabilities

The optimize_image tool supports these main options:

• input: an absolute local path or remote URL.
• output_path: a file path or directory for the result.
• output_format: jpg, png, webp, avif, gif, svg, ico, or original.
• output_width_px and output_height_px: proportional or exact resizing controls.
• output_resize_behavior: pad or crop when both dimensions are provided.
• output_upscale_factor: 2× or 4× AI upscaling.
• output_seo_tag_gen: enables or disables SEO metadata generation.
• output_file_size_limit: a target maximum size in bytes.
• gif_frame_limit and confirm_gif_cost: controls for animated GIF processing.

The glassypic MCP server is a fit for preparing web images, converting asset formats, generating favicons, resizing graphics for fixed layouts, and producing SEO metadata alongside processed files.