{
 "name": "image-optimizer",
 "title": "ImageOptimizer",
 "version": "1.3.0",
 "transport": "streamable-http",
 "stateless": true,
 "protocol_versions": [
  "2025-11-25",
  "2025-06-18",
  "2025-03-26",
  "2024-11-05",
  "2024-10-07"
 ],
 "endpoint": "https://d33mzu51alopvl.cloudfront.net/mcp",
 "description": "Turn a logo or photo into the lightest faithful web asset: traced SVG for flat art, AVIF + WebP (with responsive srcset) for photos, favicon sets, and the <img>/<picture> markup that keeps Lighthouse image audits green.",
 "auth": {
  "keyless": [
   "image_audit",
   "image_analyze",
   "image_vectorize",
   "image_optimize",
   "image_favicons",
   "image_brand_kit",
   "image_api_info"
  ],
  "keyed": [],
  "header": "Authorization: Bearer <API key>",
  "metered_with_key": [
   "image_vectorize",
   "image_optimize",
   "image_favicons"
  ],
  "how": "Every tool works without a key on the shared public quota (30 tool calls per IP per 5 minutes). An account's API key (io_…, created at https://d33mzu51alopvl.cloudfront.net/account/) sent as \"Authorization: Bearer <API key>\" moves image_vectorize, image_optimize, image_favicons onto that plan's monthly operations instead; an invalid or exhausted key answers a tool result with isError:true and a hint, never an HTTP 401."
 },
 "tools": [
  {
   "name": "image_audit",
   "title": "Audit a page's images",
   "description": "Start here when given a web page. Fetches the public page, finds the images it serves (<img>, <picture> sources, og:image; up to 20) and reports per image: format, dimensions, bytes, markup hygiene (width/height, lazy vs priority, srcset, legacy format, flat art served as raster), transfer time on Lighthouse's Slow 4G profile, share of the 2.5 s good-LCP budget, and a labelled estimate of what it would become. Then convert the ones that matter with image_optimize {image:{url}} for real numbers. One request, typically under a second for a page with 20 images (≤ 3 s on slow hosts), nothing stored. Free, keyless."
  },
  {
   "name": "image_analyze",
   "title": "Analyse an image",
   "description": "Cheap first look at one image: dimensions, colour statistics, whether the image is flat art (vector candidate) or photographic, and the preset the optimizer would use. No encoding. For a whole page, use image_audit. Free, keyless."
  },
  {
   "name": "image_vectorize",
   "title": "Trace to SVG",
   "description": "Trace a raster (logo, icon, flat art) to an optimised SVG with VTracer + SVGO. Returns the SVG as a resource blob plus bytes, Brotli size, PSNR/SSIM fidelity and the regional-detail check. Photos trace badly — use image_optimize to let the rule decide. Keyless on the shared per-IP quota; with an account's API key as Authorization: Bearer it counts one operation on that plan."
  },
  {
   "name": "image_optimize",
   "title": "Optimise for the web",
   "description": "The whole decision: analyse, trace when the image is flat art, encode AVIF + WebP (+ fallback, and responsive widths on request), keep the lightest faithful result, and return the exact <img>/<picture> markup (width, height, srcset, fetchpriority) plus load-time estimates on Lighthouse's Slow 4G profile. Files come back as resource blobs when return_base64 is true. Keyless on the shared per-IP quota; with an account's API key as Authorization: Bearer it counts one operation on that plan."
  },
  {
   "name": "image_favicons",
   "title": "Build a favicon set",
   "description": "From a logo: favicon.svg (when the trace is faithful), favicon.ico (16/32/48), apple-touch-icon.png (180, opaque), icon-192.png, icon-512.png, icon-512-maskable.png, site.webmanifest and head.html with the <link> lines. Files are returned as resource blobs. Keyless on the shared per-IP quota; with an account's API key as Authorization: Bearer it counts one operation on that plan."
  },
  {
   "name": "image_brand_kit",
   "title": "Build a brand kit",
   "description": "Everything a site and its marketing need from one logo or one name: the favicon set (favicon.svg/.ico, Apple touch, PWA + maskable icons, site.webmanifest), logo lockups (mark, wordmark, horizontal and stacked; SVG + PNG at 1x/2x/4x; brand, black and white), the marketing sizes (og, social-square, avatar-400, avatar-1024, product-hunt, x-header, linkedin-banner, youtube-banner, email-header, press-logo-light, press-logo-dark: og 1200×630, square post, avatars, X/LinkedIn/YouTube/email banners, press logos on light and dark), brand/index.html (a press page), brand/manifest.json and head.html (icon + social-card lines). With `image` the logo is the mark (SVG accepted) and only the wordmark is set in type; without it the mark is a monogram tile and the wordmark is drawn from `name` in one of the shipped fonts (permanent-marker, poppins, archivo-black, lobster, pacifico, bangers; default permanent-marker). 45–70 files: pass return_base64:false for the listing + head only, or fetch POST /api/v1/brand-kit?format=zip for one archive. Free, keyless."
  },
  {
   "name": "image_api_info",
   "title": "About this server",
   "description": "Limits, defaults (presets, raster quality, decision rule), auth and how to connect; no input. Free, keyless."
  }
 ],
 "connect": {
  "claude_code": "claude mcp add --transport http image-optimizer https://d33mzu51alopvl.cloudfront.net/mcp",
  "mcp_json": {
   "mcpServers": {
    "image-optimizer": {
     "type": "http",
     "url": "https://d33mzu51alopvl.cloudfront.net/mcp"
    }
   }
  }
 },
 "limits": {
  "inputBytes": 4718592,
  "inlineResultBytes": 4194304,
  "urls": "https only; private, local and metadata hosts refused",
  "toolCallsPer5MinPerIp": 30,
  "requestsPer5MinPerIp": 300,
  "on_limit": "429 with Retry-After: 300 and a JSON-RPC -32000 error body, data.code rate_limited (WAF rules rate-mcp for tools/call, rate-mcp-all for any /mcp request)"
 },
 "docs": {
  "openapi": "https://d33mzu51alopvl.cloudfront.net/api/v1/openapi.json",
  "skill": "https://d33mzu51alopvl.cloudfront.net/skills/image-optimizer/SKILL.md",
  "llms": "https://d33mzu51alopvl.cloudfront.net/llms.txt",
  "tool": "https://d33mzu51alopvl.cloudfront.net/convert/"
 }
}