Pixel Agent

Remote MCP image conversion tool for PNG, JPEG, WebP, AVIF, GIF, SVG, and HEIC workflows.

View on workers.dev

Documentation

Pixel Agent

Pixel Agent converts image bytes to PNG, JPEG, WebP, or AVIF. It has a browser UI and a headless HTTP API. AI agents should use the API directly; browser automation is not required.

Discover the API

  • API catalog: /.well-known/api-catalog
  • OpenAPI document: /openapi.json
  • Capabilities: /v1/capabilities
  • Agent skill: /skills/pixel-agent/SKILL.md
  • Well-known skills directory: /.well-known/skills/index.json
  • MCP server card: /.well-known/mcp.json
  • MCP endpoint: /mcp (tool: convert_image)
  • Authentication guidance: /auth.md
  • Task-specific conversion recipes: /recipes/index.html

Convert an image

Send a POST request to /v1/convert with raw image bytes in the request body.

curl --fail --silent --show-error \
  --request POST "https://YOUR-WORKER/v1/convert?format=webp&quality=85" \
  --header "Content-Type: image/png" \
  --header "X-Filename: input.png" \
  --data-binary "@input.png" \
  --output "input.webp"

Inputs and outputs

  • Inputs: PNG, JPEG, GIF, WebP, SVG, AVIF, and HEIC
  • Outputs: PNG, JPEG, WebP, and AVIF
  • Maximum API input: 20 MB
  • quality: optional integer from 1 to 100 for JPEG, WebP, and AVIF

The response body is the converted image, with a safe filename in Content-Disposition. The API does not persist image bytes and sends Cache-Control: no-store.

Other Matrix experiments