io.github.pixelvault-dev/pixelvault

Official8 toolsLive

by pixelvault-dev

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

MCP Server: io.github.pixelvault-dev/pixelvault

Agent-first image hosting server that supports uploading images and returning instant CDN URLs. It is identified by the slug io-github-pixelvault-dev-pixelvault and described as io.github.pixelvault-dev/pixelvault. The server provides 8 tools for interacting with image hosting workflows.

🛠️ Key Features

Upload images
Return instant CDN URLs
Agent-first image hosting focus

🚀 Use Cases

Provide images to agents via hosted endpoints
Obtain CDN URLs immediately after uploads

⚡ Developer Benefits

Streamlined flow: upload → CDN URL response
Tool-based integration with 8 available tools

⚠️ Limitations

Available details specify upload and CDN URL retrieval only; no other capabilities are described

Captured live from the server via tools/list.

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.

Parameters1

string

required

Image id to fetch, e.g. img_abc123

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Image id to fetch, e.g. img_abc123"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

page	integer	optional	Page number (default 1)
per_page	integer	optional	Items per page (default 20, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (default 1)"
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Items per page (default 20, max 100)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

string

required

Image id to delete, e.g. img_abc123

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Image id to delete, e.g. img_abc123"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

source_url	string	optional	Public http(s) URL of an image to fetch and upload. Provide this OR data.
data	string	optional	Base64-encoded image bytes (data URLs accepted). Provide this OR source_url.
folder	string	optional	Optional folder/path prefix for the image.
filename	string	optional	Optional original filename, e.g. photo.png.
expires_in	integer	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "source_url": {
      "type": "string",
      "description": "Public http(s) URL of an image to fetch and upload. Provide this OR data."
    },
    "data": {
      "type": "string",
      "description": "Base64-encoded image bytes (data URLs accepted). Provide this OR source_url."
    },
    "folder": {
      "type": "string",
      "description": "Optional folder/path prefix for the image."
    },
    "filename": {
      "type": "string",
      "description": "Optional original filename, e.g. photo.png."
    },
    "expires_in": {
      "type": "integer",
      "minimum": 60,
      "maximum": 2592000,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

upload_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.

Parameters7

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

Raw schema

{
  "type": "object",
  "properties": {
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "data": {
            "type": "string",
            "description": "Base64-encoded image bytes. Provide this OR source_url."
          },
          "source_url": {
            "type": "string",
            "description": "Public http(s) URL the server fetches (SSRF-guarded). Provide this OR data."
          },
          "filename": {
            "type": "string",
            "description": "Original filename, e.g. diff.png."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {},
            "description": "Freeform per-image metadata, e.g. { testName, viewport }."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 50,
      "description": "1–50 images to upload into the collection."
    },
    "type": {
      "type": "string",
      "maxLength": 32,
      "description": "Collection type/discriminator (e.g. ci_build, generation). Default 'batch'."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "description": "Idempotency key — re-running with the same (type, name) upserts the same collection."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "'private' returns a signed URL per image (free plan: up to 100 private images); 'public' returns a plain CDN URL. Default 'public'."
    },
    "expires_in": {
      "type": "integer",
      "minimum": 60,
      "maximum": 2592000,
      "description": "Image deletion TTL in seconds (60–2,592,000). Omit for permanent."
    },
    "sign_expires_in": {
      "type": "integer",
      "minimum": 60,
      "maximum": 2592000,
      "description": "Signature lifetime for private URLs in seconds (60–2,592,000, default 7 days)."
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {},
      "description": "Freeform collection metadata, e.g. { commit, pr_number, branch }."
    }
  },
  "required": [
    "images"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sign_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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Image id to mint a signed URL for, e.g. img_abc123."
    },
    "expires_in": {
      "type": "integer",
      "minimum": 60,
      "maximum": 2592000,
      "description": "Signature lifetime in seconds (60–2,592,000). Default 3600 (1 hour)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

transform_image

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.

Parameters20

url	string	optional	Absolute CDN URL of a PixelVault image, as returned by upload_image / get_image / list_images. Provide this OR id.
id	string	optional	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.
size	string	optional	Named size preset: s=256px, m=640px, l=1280px, social=1200x630 OG card. Wins over width/height.
width	integer	optional	Target width in px (1..4000). Snapped UP to the nearest allowed step. scale-down never upscales.
height	integer	optional	Target height in px (1..4000). Snapped UP to the nearest allowed step.
fit	string	optional	Resize mode. scale-down (default) never enlarges; contain/cover/crop/pad resize to the exact box and may upscale. Only meaningful alongside width/height.
format	string	optional	Output format. auto negotiates WebP/AVIF from the client's Accept header.
quality	string	optional	Output quality. auto lets Cloudflare choose.
segment	string	optional	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 images.
background	string	optional	Fill color behind a removed (segment) or padded (fit=pad) background: hex (#ffaa00), rgb()/rgba(), or a common CSS color name. No effect otherwise.
gravity	string	optional	Crop anchor, only with fit=cover\|crop: face, left, right, top, bottom, auto, or 'XxY' coords 0.0-1.0. face enables zoom.
zoom	number	optional	Face-crop tightness 0.0-1.0, only with gravity=face.
blur	number	optional	Gaussian blur (0-250); snapped to the nearest of 10/30/60/120. <=0 is ignored.
sharpen	number	optional	Sharpen strength (0-10); snapped to the nearest of 1/3/5.
rotate	number	optional	Rotate clockwise; rounded to the nearest right angle (90/180/270).
flip	string	optional	Mirror horizontally (h), vertically (v), or both (hv).
brightness	number	optional	Brightness multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2.
contrast	number	optional	Contrast multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2.
saturation	number	optional	Saturation multiplier 0-2 (1=no change, 0=grayscale); snapped to 0/0.5/1.5/2.
tile	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Absolute CDN URL of a PixelVault image, as returned by upload_image / get_image / list_images. Provide this OR id."
    },
    "id": {
      "type": "string",
      "description": "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."
    },
    "size": {
      "type": "string",
      "enum": [
        "s",
        "m",
        "l",
        "social"
      ],
      "description": "Named size preset: s=256px, m=640px, l=1280px, social=1200x630 OG card. Wins over width/height."
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 4000,
      "description": "Target width in px (1..4000). Snapped UP to the nearest allowed step. scale-down never upscales."
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 4000,
      "description": "Target height in px (1..4000). Snapped UP to the nearest allowed step."
    },
    "fit": {
      "type": "string",
      "enum": [
        "scale-down",
        "contain",
        "cover",
        "crop",
        "pad"
      ],
      "description": "Resize mode. scale-down (default) never enlarges; contain/cover/crop/pad resize to the exact box and may upscale. Only meaningful alongside width/height."
    },
    "format": {
      "type": "string",
      "enum": [
        "auto",
        "webp",
        "avif",
        "jpg",
        "png"
      ],
      "description": "Output format. auto negotiates WebP/AVIF from the client's Accept header."
    },
    "quality": {
      "type": "string",
      "enum": [
        "auto",
        "60",
        "75",
        "85"
      ],
      "description": "Output quality. auto lets Cloudflare choose."
    },
    "segment": {
      "type": "string",
      "enum": [
        "foreground"
      ],
      "description": "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 images."
    },
    "background": {
      "type": "string",
      "description": "Fill color behind a removed (segment) or padded (fit=pad) background: hex (#ffaa00), rgb()/rgba(), or a common CSS color name. No effect otherwise."
    },
    "gravity": {
      "type": "string",
      "description": "Crop anchor, only with fit=cover|crop: face, left, right, top, bottom, auto, or 'XxY' coords 0.0-1.0. face enables zoom."
    },
    "zoom": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Face-crop tightness 0.0-1.0, only with gravity=face."
    },
    "blur": {
      "type": "number",
      "minimum": 0,
      "maximum": 250,
      "description": "Gaussian blur (0-250); snapped to the nearest of 10/30/60/120. <=0 is ignored."
    },
    "sharpen": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "description": "Sharpen strength (0-10); snapped to the nearest of 1/3/5."
    },
    "rotate": {
      "type": "number",
      "description": "Rotate clockwise; rounded to the nearest right angle (90/180/270)."
    },
    "flip": {
      "type": "string",
      "enum": [
        "h",
        "v",
        "hv"
      ],
      "description": "Mirror horizontally (h), vertically (v), or both (hv)."
    },
    "brightness": {
      "type": "number",
      "minimum": 0,
      "maximum": 2,
      "description": "Brightness multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2."
    },
    "contrast": {
      "type": "number",
      "minimum": 0,
      "maximum": 2,
      "description": "Contrast multiplier 0-2 (1=no change); snapped to 0.5/0.75/1.25/1.5/2."
    },
    "saturation": {
      "type": "number",
      "minimum": 0,
      "maximum": 2,
      "description": "Saturation multiplier 0-2 (1=no change, 0=grayscale); snapped to 0/0.5/1.5/2."
    },
    "tile": {
      "type": "string",
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rescue_imgur

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.

Parameters1

page_url

string

required

Public https:// URL of a page to scan for hotlinked Imgur images.

Raw schema

{
  "type": "object",
  "properties": {
    "page_url": {
      "type": "string",
      "minLength": 1,
      "description": "Public https:// URL of a page to scan for hotlinked Imgur images."
    }
  },
  "required": [
    "page_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (8)

get_imagelist_imagesdelete_imageupload_imageupload_batchsign_urltransform_imagerescue_imgur

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.pixelvault.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pixelvault": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pixelvault.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.pixelvault-dev/pixelvault

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_image

list_images

delete_image

upload_image

upload_batch

sign_url

transform_image

rescue_imgur

Install

Remote endpoint

Related servers