# io.github.pixelvault-dev/pixelvault (remote · mcp.pixelvault.dev)

Agent-first image hosting — upload images and get instant CDN URLs.

- Trust score: 59/100 (low)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

> **Recent critical change**: Authorization (2026-07-28). See the changelog below before you install this server.

## Components

- remote · `mcp.pixelvault.dev`: 59/100 (this document), [markdown](https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp.md), [page](https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp)
- remote · `mcp.pixelvault.dev`: 31/100, [markdown](https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp-oauth.md), [page](https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp-oauth)

## Channel facts

- Endpoint: `https://mcp.pixelvault.dev/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.3.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (delete_image).
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 59/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2371 tokens (~296/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http pixelvault-dev-pixelvault https://mcp.pixelvault.dev/mcp
```

### Codex

```toml
[mcp_servers.pixelvault-dev-pixelvault]
url = "https://mcp.pixelvault.dev/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pixelvault-dev-pixelvault": {
      "type": "remote",
      "url": "https://mcp.pixelvault.dev/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pixelvault-dev-pixelvault --url https://mcp.pixelvault.dev/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  pixelvault-dev-pixelvault:
    url: "https://mcp.pixelvault.dev/mcp"
```

### Other

```json
{
  "mcpServers": {
    "pixelvault-dev-pixelvault": {
      "type": "http",
      "url": "https://mcp.pixelvault.dev/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 58, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 60, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 58, +1)

- [critical regression] Authorization: unverified → fail
- [security] Tool “delete_image” is now declared destructive
- [cosmetic] Tool “upload_image” changed its title: Upload image
- [cosmetic] Tool “transform_image” changed its title: Build transform URL
- [cosmetic] Tool “delete_image” changed its title: Delete image
- [cosmetic] Tool “get_image” changed its title: Get image
- [cosmetic] Tool “list_images” changed its title: List images
- [cosmetic] Tool “rescue_imgur” changed its title: Rescue Imgur images
- [cosmetic] Tool “sign_url” changed its title: Sign private image URL
- [cosmetic] Tool “upload_batch” changed its title: Upload image batch

### 2026-07-27 (score 57, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 56)

First indexed and scored.

## MCP tools (8)

### `get_image` (~185 tokens)

Get image

Get metadata (CDN URL, size, MIME type, dimensions) for one PixelVault image by id. Maps to GET /v1/images/:id. Requires a PixelVault API key sent as a Bearer token in the Authorization header. The returned CDN URL supports on-the-fly transforms via query params — e.g. ?w=400&fit=cover (resize/crop), ?fmt=webp (format), ?segment=foreground (AI background removal → transparent PNG), effects like ?blur=30&saturation=0&rotate=90, and ?tile=<image_id.ext> (tile another of your images as a watermark). Or call the transform_image tool to build a valid transform URL for you. See https://pixelvault.dev/docs#transforms.

Input parameters:

- `id` (string, required): Image id to fetch, e.g. img_abc123

### `list_images` (~188 tokens)

List images

List images in your PixelVault project, most recent first. Maps to GET /v1/images with pagination. Requires a PixelVault API key sent as a Bearer token in the Authorization header. The returned CDN URL supports on-the-fly transforms via query params — e.g. ?w=400&fit=cover (resize/crop), ?fmt=webp (format), ?segment=foreground (AI background removal → transparent PNG), effects like ?blur=30&saturation=0&rotate=90, and ?tile=<image_id.ext> (tile another of your images as a watermark). Or call the transform_image tool to build a valid transform URL for you. See https://pixelvault.dev/docs#transforms.

Input parameters:

- `page` (integer): Page number (default 1)
- `per_page` (integer): Items per page (default 20, max 100)

### `delete_image` (~64 tokens)

Delete image

Permanently delete one PixelVault image by id. Maps to DELETE /v1/images/:id. Requires a PixelVault API key sent as a Bearer token in the Authorization header.

Input parameters:

- `id` (string, required): Image id to delete, e.g. img_abc123

### `upload_image` (~358 tokens)

Upload image

Upload an image to PixelVault and get an instant CDN URL. Maps to POST /v1/images. Provide exactly one of `source_url` (a public http(s) URL the server fetches) or `data` (base64-encoded bytes); optional `folder`, `filename`, and `expires_in` (seconds, for an auto-expiring image). Max 5 MB; JPG/PNG/GIF/WebP/AVIF/SVG. Requires a PixelVault API key sent as a Bearer token in the Authorization header. The returned CDN URL supports on-the-fly transforms via query params — e.g. ?w=400&fit=cover (resize/crop), ?fmt=webp (format), ?segment=foreground (AI background removal → transparent PNG), effects like ?blur=30&saturation=0&rotate=90, and ?tile=<image_id.ext> (tile another of your images as a watermark). Or call the transform_image tool to build a valid transform URL for you. See https://pixelvault.dev/docs#transforms.

Input parameters:

- `data` (string): Base64-encoded image bytes (data URLs accepted). Provide this OR source_url.
- `expires_in` (integer): Optional time-to-live in seconds. The image is auto-deleted after this many seconds (must be 60–2,592,000, i.e. 1 minute to 30 days). Omit for a permanent image.
- `filename` (string): Optional original filename, e.g. photo.png.
- `folder` (string): Optional folder/path prefix for the image.
- `source_url` (string): Public http(s) URL of an image to fetch and upload. Provide this OR data.

### `upload_batch` (~481 tokens)

Upload image batch

Upload many images (1–50) in one call, grouped into a collection — e.g. a CI run or a set of generated variants. Maps to POST /v1/images/batch. Each item is `data` (base64) or `source_url` (server-fetched, SSRF-guarded), with optional `filename`/`metadata`. Set `visibility: "private"` to get a signed URL per image (free plan: up to 100 private images) instead of a public CDN URL. Optional `type`/`name` (idempotent by (type, name)), `expires_in` (image TTL), `sign_expires_in` (signature lifetime), and collection `metadata`. Partial-failure tolerant: each returned item has its own `ok`. Requires a PixelVault API key sent as a Bearer token in the Authorization header. The returned CDN URL supports on-the-fly transforms via query params — e.g. ?w=400&fit=cover (resize/crop), ?fmt=webp (format), ?segment=foreground (AI background removal → transparent PNG), effects like ?blur=30&saturation=0&rotate=90, and ?tile=<image_id.ext> (tile another of your images as a watermark). Or call the transform_image tool to build a valid transform URL for you. See https://pixelvault.dev/docs#transforms.

Input parameters:

- `expires_in` (integer): Image deletion TTL in seconds (60–2,592,000). Omit for permanent.
- `images` (array, required): 1–50 images to upload into the collection.
- `metadata` (object): Freeform collection metadata, e.g. { commit, pr_number, branch }.
- `name` (string): Idempotency key — re-running with the same (type, name) upserts the same collection.
- `sign_expires_in` (integer): Signature lifetime for private URLs in seconds (60–2,592,000, default 7 days).
- `type` (string): Collection type/discriminator (e.g. ci_build, generation). Default 'batch'.
- `visibility` (string): 'private' returns a signed URL per image (free plan: up to 100 private images); 'public' returns a plain CDN URL. Default 'public'.

### `sign_url` (~153 tokens)

Sign private image URL

Mint a time-limited signed URL for a private image. Maps to POST /v1/images/:id/sign-url. Provide `id` and optional `expires_in` (seconds, default 3600). The signature binds the image, so the URL can't be replayed against another image; strip it and the CDN returns 403. Deleting the image revokes its URLs. Requires a PixelVault API key sent as a Bearer token in the Authorization header.

Input parameters:

- `expires_in` (integer): Signature lifetime in seconds (60–2,592,000). Default 3600 (1 hour).
- `id` (string, required): Image id to mint a signed URL for, e.g. img_abc123.

### `transform_image` (~791 tokens)

Build transform URL

Build an on-the-fly transform URL for a PixelVault image (resize, crop, format/quality, AI background removal, blur/sharpen/rotate/flip, brightness/contrast/saturation, and same-project watermark tiling). Provide exactly one of `url` (a PixelVault CDN URL) or `id` (an image id, resolved via the API — requires an API key), plus one or more transform params. Returns the ready-to-use CDN URL; the transform is produced and cached on first request. See https://pixelvault.dev/docs#transforms.

Input parameters:

- `background` (string): Fill color behind a removed (segment) or padded (fit=pad) background: hex (#ffaa00), rgb()/rgba(), or a common CSS color name. No effect otherwise.
- `blur` (number): Gaussian blur (0-250); snapped to the nearest of 10/30/60/120. <=0 is ignored.
- `brightness` (number): Brightness multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2.
- `contrast` (number): Contrast multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2.
- `fit` (string): Resize mode. scale-down (default) never enlarges; contain/cover/crop/pad resize to the exact box and may upscale. Only meaningful alongside width/height.
- `flip` (string): Mirror horizontally (h), vertically (v), or both (hv).
- `format` (string): Output format. auto negotiates WebP/AVIF from the client's Accept header.
- `gravity` (string): Crop anchor, only with fit=cover|crop: face, left, right, top, bottom, auto, or 'XxY' coords 0.0-1.0. face enables zoom.
- `height` (integer): Target height in px (1..4000). Snapped UP to the nearest allowed step.
- `id` (string): PixelVault image id (e.g. img_abc123); its CDN URL is resolved via the API. Provide this OR url. Requires an API key when used.
- `quality` (string): Output quality. auto lets Cloudflare choose.
- `rotate` (number): Rotate clockwise; rounded to the nearest right angle (90/180/270).
- `saturation` (number): Saturation multiplier 0-2 (1=no change, 0=grayscale); snapped to 0/0.5/1.5/2.
- `segment` (string): AI background removal (BiRefNet): foreground keeps the subject and makes the background transparent. Output is forced to PNG unless an opaque background is set. Not available on anonymous/playground…
- `sharpen` (number): Sharpen strength (0-10); snapped to the nearest of 1/3/5.
- `size` (string): Named size preset: s=256px, m=640px, l=1280px, social=1200x630 OG card. Wins over width/height.
- `tile` (string): Filename (optionally folder-prefixed, with extension) of another image in the SAME project to tile edge-to-edge as a watermark, e.g. watermark.png.
- `url` (string): Absolute CDN URL of a PixelVault image, as returned by upload_image / get_image / list_images. Provide this OR id.
- `width` (integer): Target width in px (1..4000). Snapped UP to the nearest allowed step. scale-down never upscales.
- `zoom` (number): Face-crop tightness 0.0-1.0, only with gravity=face.

### `rescue_imgur` (~151 tokens)

Rescue Imgur images

Scan a web page for hotlinked Imgur images and return a PixelVault rescue URL for each — a proxy that lazily rehosts the image on first request, keeping it working through the UK Imgur block. The anonymous rescue tier is a durable ~30-day edge cache (see `cache_ttl_days` in the result), not permanent storage. Maps to POST /v1/imgur-scan (server-side page fetch; no API key required). Provide `page_url` (a public https:// page). Drop each returned rescue_url into your HTML to rehost on first request.

Input parameters:

- `page_url` (string, required): Public https:// URL of a page to scan for hotlinked Imgur images.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp#diagnostics

## Score history

- 2026-08-03: 59
- 2026-08-02: 59
- 2026-08-01: 58
- 2026-07-31: 60
- 2026-07-30: 59
- 2026-07-29: 58
- 2026-07-28: 58
- 2026-07-27: 57
- 2026-07-26: 56

## Links

- Remote endpoint: https://mcp.pixelvault.dev/mcp
- Authorisation metadata: https://mcp.pixelvault.dev/.well-known/oauth-protected-resource/mcp
- Website: https://pixelvault.dev/
- Changelog RSS feed: https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/pixelvault-dev-pixelvault/mcp