# ShortPixel Image Optimizer MCP server

> Compress, resize and convert public image URLs to WebP or AVIF through the ShortPixel SPIO API.

- Listing: https://mcp.tc/i/shortpixel-image-optimizer
- Connect: use the server's own URL `https://mcp.shortpixel.com/mcp` (with your API key); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: API key
- Category: [Design, Websites & CMS](https://mcp.tc/c/design)
- Vendor: ShortPixel
- Homepage: <https://shortpixel.com>
- Docs: <https://github.com/short-pixel-optimizer/com.shortpixel.mcp/blob/main/README.md#authentication>
- Repository: <https://github.com/short-pixel-optimizer/com.shortpixel.mcp>

## About

Connects an AI assistant to the ShortPixel SPIO image optimization API. Its documented tool, optimize\_image\_urls, takes up to 100 public image URLs and compresses them. It supports lossless, lossy and glossy levels, resizing, upscaling, format conversion (WebP, AVIF, JPG, PNG, GIF), CMYK to RGB conversion, EXIF handling and background removal.

Runs as a hosted Streamable HTTP endpoint at https://mcp.shortpixel.com/mcp. Each request uses the user's own ShortPixel API key, sent as a Bearer token in the Authorization header. The server forwards the key to the ShortPixel API and does not store it. A key can be obtained at shortpixel.com.

## What it can do

- Optimize up to 100 public image URLs per call
- Choose lossless, lossy or glossy compression
- Convert images to WebP, AVIF, JPG, PNG or GIF
- Resize images with outer, inner or smart crop modes
- Upscale images by 2x, 3x or 4x
- Keep or strip EXIF metadata
- Remove image backgrounds

## Example prompts

- "Compress these image URLs with lossy compression and convert them to WebP."
- "Optimize https://example.com/photo.jpg and keep the EXIF data."
- "Resize these product images to 800 pixels wide using smart crop."
- "Remove the background from this image URL and return the optimized file."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http shortpixel-image-optimizer https://mcp.shortpixel.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
```

2. Replace the placeholder with your key before you run it, then check it with `/mcp` inside Claude Code.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Use the `mcp-remote` bridge, which keeps the key on this computer (a connector added on claude.ai with the key under **Request headers** also shows up here). Open **Settings → Developer → Edit Config** and add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "shortpixel-image-optimizer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.shortpixel.com/mcp",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}
```

2. Replace the placeholder with your key and restart Claude Desktop.

The bridge needs Node.js on your computer.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=ShortPixel%20Image%20Optimizer&connectorUrl=https%3A%2F%2Fmcp.shortpixel.com%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp.shortpixel.com/mcp`. Under **Request headers**, add `Authorization: Bearer <YOUR_API_KEY>` with your key from ShortPixel, then click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=shortpixel-image-optimizer&config=eyJ1cmwiOiJodHRwczovL21jcC5zaG9ydHBpeGVsLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgPFlPVVJfQVBJX0tFWT4ifX0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "shortpixel-image-optimizer": {
      "url": "https://mcp.shortpixel.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

### VS Code

Add it to `.vscode/mcp.json`. VS Code asks for the key the first time and stores it securely:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "shortpixel-image-optimizer": {
      "type": "http",
      "url": "https://mcp.shortpixel.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "api-key",
      "description": "API key",
      "password": true
    }
  ]
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "shortpixel-image-optimizer": {
      "serverUrl": "https://mcp.shortpixel.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add shortpixel-image-optimizer --url https://mcp.shortpixel.com/mcp --bearer-token-env-var SHORTPIXEL_IMAGE_OPTIMIZER_API_KEY
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.shortpixel-image-optimizer]
url = "https://mcp.shortpixel.com/mcp"
bearer_token_env_var = "SHORTPIXEL_IMAGE_OPTIMIZER_API_KEY"
```

Set `SHORTPIXEL_IMAGE_OPTIMIZER_API_KEY` to your key in the shell that runs Codex.

### Gemini CLI

```bash
gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" shortpixel-image-optimizer https://mcp.shortpixel.com/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "shortpixel-image-optimizer": {
      "type": "http",
      "url": "https://mcp.shortpixel.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.shortpixel.com/mcp`.

## Details

- Server version: 0.3.0
- Last checked: 2026-10-07 (reachable, asks for credentials)
- Listed: 2026-10-06
- Updated: 2026-10-07

---
Source: https://mcp.tc/i/shortpixel-image-optimizer (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
