Glassypic

@glassypic/mcp-server

MCP server for GlassyPic. One tool that turns raw images into production-ready assets: upscaling, resizing and cropping, compression, file format conversion, and SEO filename and alt text generation. Describe the outcome you want in natural language.

Quick Start

Add to your MCP client config:

{

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

No signup required. Works out of the box with 20 free daily credits.

Windows users: If the server doesn't appear after editing a JSON config, your client likely can't resolve npx from PATH (a common, silent failure). Wrap the command with cmd /c:

`json

{

"mcpServers": {

"glassypic": {

"command": "cmd",

"args": ["/c", "npx", "-y", "@glassypic/mcp-server@latest"]

}

}

}

`

This applies to the hand-edited JSON configs below (Claude Desktop, Cursor, Windsurf, Cline). The CLI commands (Claude Code, Gemini CLI, Codex CLI) are unaffected.

Client-Specific Setup

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

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

</details>

Claude Code

claude mcp add glassypic -- npx -y @glassypic/mcp-server@latest

Cursor

Add to .cursor/mcp.json in your project root:

{

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

</details>

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{

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

</details>

Smithery Install via Smithery:

Cline

Open Cline settings → MCP Servers → Add, then paste:

{

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

</details>

Gemini CLI

gemini mcp add --transport stdio glassypic npx -y @glassypic/mcp-server@latest

Or edit ~/.gemini/settings.json (global) or .gemini/settings.json in your project root:

{

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

Verify it's running inside Gemini CLI with /mcp list.

OpenAI Codex CLI

codex mcp add glassypic -- npx -y @glassypic/mcp-server@latest

Or edit ~/.codex/config.toml manually:

[mcp_servers.glassypic]

command = "npx" args = ["-y", "@glassypic/mcp-server@latest"]

</details>

Tool: optimize_image

One tool that turns a supplied image into a production-ready asset through a fixed server-side pipeline (typically 60-80% size reduction), with optional resize, upscale, format conversion, and SEO metadata generation. Inputs include JPEG, PNG, WebP, AVIF, GIF, SVG, ICO, HEIC, TIFF, and BMP. Outputs are JPEG, PNG, WebP, AVIF, GIF, SVG, and ICO. Accepts absolute local file paths or remote URLs.

Parameters

Resize Behavior

Examples

Basic compression — just compress, keep format and dimensions:

{ "input": "/Users/me/photos/hero.png" }

Convert to WebP:

{ "input": "/Users/me/hero.png", "output_format": "webp" }

Resize proportionally — set one dimension, the other scales:

{ "input": "/Users/me/hero.png", "output_width_px": 1200 }

Exact dimensions with padding — white bars fill the gap:

{ "input": "/Users/me/hero.png", "output_width_px": 1080, "output_height_px": 1080 }

Exact dimensions with smart crop:

{ "input": "/Users/me/hero.png", "output_width_px": 1080, "output_height_px": 1080, "output_resize_behavior": "crop" }

AI upscale 4x:

{ "input": "/Users/me/icon.png", "output_upscale_factor": 4 }

From URL, save to directory:

{ "input": "https://example.com/photo.jpg", "output_path": "/Users/me/assets/" }

Skip SEO to save 1 credit:

{ "input": "/Users/me/hero.png", "output_seo_tag_gen": false }

Output

Returns a text summary and structured metadata:

Optimized: /Users/me/photos/modern-office-workspace.webp

Size: 142.3 KB Compression: 73% Format: webp Dimensions: 1920x1080 Alt text: Modern office workspace with laptop and coffee cup on wooden desk

Structured output fields:

{

"output_path": "/Users/me/photos/modern-office-workspace.webp", "output_size_bytes": 145715, "output_width_px": 1920, "output_height_px": 1080, "output_format": "webp", "compression_ratio": 0.27, "seo_alt_text": "Modern office workspace with laptop and coffee cup on wooden desk", "seo_keywords": ["office", "workspace", "laptop", "desk", "modern"], "seo_filename": "modern-office-workspace" }

Supported Formats

GlassyPic supports high-quality conversion between any input and output format combination. Converting an animated GIF to a non-GIF format (JPG, PNG, WebP, AVIF) preserves only the first frame. Converting an animated GIF to a GIF format supports upscaling/resizing while preserving the animation and quality. You may also reduce animated GIF file size by decreasing the number of output frames.

Max upload file size: 50 MB.

SVG & ICO Examples

# Optimize an SVG file (keeps as vector)

Optimize logo.svg and keep it as SVG

Convert SVG to raster

Convert icon.svg to a 512x512 PNG

Trace raster to vector SVG

Convert my logo.png to a vector SVG

Generate favicon set from any image

Convert logo.png to an ICO favicon

Generate single-size ICO

Convert logo.png to a 32x32 ICO

Extract largest icon from ICO

Convert favicon.ico to PNG

How It Works

Local file or URL

→ Upload to GlassyPic API → Optional AI upscale (explicit, or automatic when a resize target exceeds the source by more than 1.2×) → Optional resize → Compression → Optional SEO metadata → Download optimized file → Save with the SEO filename slug, or a .polished suffix when SEO is off or returns no slug

All processing happens server-side via the GlassyPic API. The MCP server is a thin client that orchestrates the pipeline.

Credits

Guests can use the tool with no signup. Logging in links your GlassyPic account and shares its credits with the web app. Allowances differ by plan and change over time: run the status tool for your live balance, or see glassypic.com/pricing for plans. A default run (compress + SEO tags) costs 4 credits per image.

Session data is stored locally at ~/.glassypic/session.json and persists across invocations.

Automatic upscaling

When a resize target exceeds the source image by more than 1.2×, GlassyPic automatically runs an AI upscale before resizing, so enlargements ship sharp instead of blurred. This happens without output_upscale_factor being set and adds 2 credits.

A resize-only call therefore costs the same as a full pipeline when the source is smaller than the target:

Animated GIFs are billed per frame — see the confirm_gif_cost parameter.

Account & Credits

Log in to unlock more credits and share them across the web app and MCP server:

Use the login tool to sign in.

Use the status tool to check your current credits. Use the upgrade tool to open the pricing page. Use the logout tool to sign out.

login

Opens a browser window to complete login (Google, Facebook, or email/magic link). After approval, your account is linked and credits are shared with the web app.

Login complete: user@example.com (Pro tier, 3,150 of 3,300 credits remaining)

status

Check your current account status and credits before batch processing:

Logged in as user@example.com (Pro tier)

Credits: 3,150 of 3,300 remaining Resets: 03/01/2026, 12:00 AM PST

logout

Revokes the session and reverts to guest mode.

upgrade

Opens glassypic.com/pricing in your browser.

Tips for AI Agents

Paste this into your CLAUDE.md or system prompt to help agents use the tool effectively:

## GlassyPic MCP

Tools: optimize_image, login, logout, status, upgrade

• Use status to check credits before batch processing
• Credits: 3 to compress (always), +1 if width/height is set, +2 to upscale, +1 for SEO tags (default). A full pipeli