# GetWebP

> Local-first image conversion. Converts JPG, PNG, BMP, HEIC, HEIF, AVIF → WebP using WebAssembly on the user's machine. No uploads. No cloud. No external API keys.

GetWebP is a privacy-first image optimization product with three surfaces sharing the same WASM conversion engine: a CLI, an MCP server for AI agents, and a WordPress plugin. All processing happens locally; the web app never uploads files.

Maintainer: GetWebP · Homepage: https://getwebp.com · License: CLI/Extension source-available, WordPress plugin GPL-2.0+, MCP server MIT · Last-Updated: 2026-04-17

## Quick install

- CLI: `npx getwebp <input> [options]`
- MCP server (Claude Code): `claude mcp add getwebp -- npx -y @getwebp/mcp-server`
- MCP server (Claude Desktop / Cursor / Windsurf / etc.):
  ```json
  { "mcpServers": { "getwebp": { "command": "npx", "args": ["-y", "@getwebp/mcp-server"] } } }
  ```
- WordPress: install "GetWebP" from the WordPress plugin directory
- Chrome Extension: https://chromewebstore.google.com/ (search "GetWebP")

Requires Node.js 18+ for CLI/MCP. License optional — Free plan works without activation.

## MCP server tools

- `scan_images(path, recursive?=false)` — list convertible images. Returns `{ total, files[] }` with `path`, `size`, `format`, `has_webp`.
- `convert_images(input, output?, quality?, recursive?=false, skip_existing?=true, format?='webp', manifest_path?)` — convert to WebP or AVIF. Returns `{ success, plan, total, succeeded, failed, skipped, skipped_by_limit?, warnings[], results[], manifest? }`. Each result has `saved_ratio` (0–1). Size-guard: output never larger than input. Default quality: auto (SSIM) for WebP; AVIF uses 55. `format: 'avif'` switches to AVIF; `manifest_path` writes a SHA-256 manifest. Errors are structured: `error: { code, message, context? }`.
- `get_status()` — returns `{ activated, plan, limits }`. Plan is `"free"` or `"pro"`.

Typical workflow: `get_status` → `scan_images` → `convert_images` → report `saved_ratio` to user.

## Plan limits

| | Free | Pro |
|---|---|---|
| Files/run | 20 | Unlimited |
| Delay | 3s per file | None |
| Max file | 5 MB | 50 MB |

Activate Pro: `npx getwebp auth <key>`. Pricing: https://getwebp.com/pricing

## Core docs

- [MCP Server](https://getwebp.com/docs/cli/mcp-server): Expose GetWebP to AI agents via Model Context Protocol.
- [MCP Landing Page](https://getwebp.com/mcp): High-level overview for agent integrators.
- [For AI Agents](https://getwebp.com/for-ai-agents): Why GetWebP is the most AI-friendly image converter.
- [CLI Getting Started](https://getwebp.com/docs/cli/getting-started): Install, first run, output conventions.
- [CLI Commands Reference](https://getwebp.com/docs/cli/commands): Every flag and subcommand.
- [CLI JSON Output](https://getwebp.com/docs/cli/json-output): Machine-readable output schema for scripting and CI.
- [CLI Exit Codes](https://getwebp.com/docs/cli/exit-codes): Stable exit codes for CI pipelines.
- [CLI Configuration](https://getwebp.com/docs/cli/configuration): Config file format, precedence, defaults.
- [CLI CI Integration](https://getwebp.com/docs/cli/ci-integration): GitHub Actions, GitLab CI, CircleCI recipes.
- [CLI Performance](https://getwebp.com/docs/cli/performance): Concurrency, worker tuning, benchmarks.
- [CLI Security & Privacy](https://getwebp.com/docs/cli/security-privacy): Sandboxing, network isolation, file-system access model.
- [CLI Troubleshooting](https://getwebp.com/docs/cli/troubleshooting): Known errors and fixes.
- [CLI Upgrade & Migration](https://getwebp.com/docs/cli/upgrade-migration): Version-to-version migration notes.
- [CLI Uninstall](https://getwebp.com/docs/cli/uninstall): Clean removal steps.
- [CLI Man Page & Completions](https://getwebp.com/docs/cli/man-page-completions): Shell completion install.
- [CLI Pricing](https://getwebp.com/docs/cli/pricing): Free vs Pro limits.
- [CLI FAQ](https://getwebp.com/docs/cli/faq): Common CLI questions.
- [CLI LLM Context](https://getwebp.com/docs/cli/llm-context): Context block to paste into agent prompts.

## WordPress plugin docs

- [WordPress: Getting Started](https://getwebp.com/docs/wordpress/getting-started)
- [WordPress: Batch Conversion](https://getwebp.com/docs/wordpress/batch-conversion)
- [WordPress: Auto Upload](https://getwebp.com/docs/wordpress/auto-upload)
- [WordPress: Frontend Delivery](https://getwebp.com/docs/wordpress/frontend-delivery)
- [WordPress: Server Rewrite](https://getwebp.com/docs/wordpress/server-rewrite)
- [WordPress: Multisite](https://getwebp.com/docs/wordpress/multisite)
- [WordPress: WP-CLI](https://getwebp.com/docs/wordpress/wp-cli)
- [WordPress: Pricing](https://getwebp.com/docs/wordpress/pricing)
- [WordPress: Troubleshooting](https://getwebp.com/docs/wordpress/troubleshooting)
- [WordPress: FAQ](https://getwebp.com/docs/wordpress/faq)

## Chrome Extension docs

- [Extension: Installation](https://getwebp.com/docs/extension/installation)
- [Extension: Single-image Conversion](https://getwebp.com/docs/extension/single-image)
- [Extension: Batch Processing](https://getwebp.com/docs/extension/batch-processing)
- [Extension: Context Menu](https://getwebp.com/docs/extension/context-menu)
- [Extension: Quality Settings](https://getwebp.com/docs/extension/quality)
- [Extension: Supported Formats](https://getwebp.com/docs/extension/formats)
- [Extension: Output Naming](https://getwebp.com/docs/extension/naming)
- [Extension: Privacy Model](https://getwebp.com/docs/extension/privacy)
- [Extension: Errors](https://getwebp.com/docs/extension/errors)
- [Extension: FAQ](https://getwebp.com/docs/extension/faq)

## Comparisons

- [GetWebP vs ImageMagick](https://getwebp.com/compare/getwebp-vs-imagemagick)
- [GetWebP vs sharp](https://getwebp.com/compare/getwebp-vs-sharp)

## Blog (deep guides)

- [What Is WebP? Complete Beginner's Guide (2026)](https://getwebp.com/blog/what-is-webp-guide-2026)
- [Why WebP Files Are Smaller](https://getwebp.com/blog/why-webp-files-are-smaller)
- [WebP vs JPG vs PNG vs AVIF](https://getwebp.com/blog/webp-vs-jpg-vs-png-vs-avif)
- [Lossy vs Lossless WebP Explained](https://getwebp.com/blog/lossy-vs-lossless-webp-explained)
- [When Not to Use WebP](https://getwebp.com/blog/when-not-to-use-webp)
- [Best CLI Batch WebP Converter](https://getwebp.com/blog/best-cli-batch-webp-converter)
- [AI Agent Image Optimization with MCP Server](https://getwebp.com/blog/ai-agent-image-optimization-mcp-server)
- [Why Local-First Matters](https://getwebp.com/blog/why-local-first-matters)
- [ImageMagick policy.xml Fix](https://getwebp.com/blog/imagemagick-policy-xml-fix)
- [sharp on Alpine Docker Fix](https://getwebp.com/blog/sharp-alpine-docker-fix)

## Reference

- [Full AI reference (extended)](https://getwebp.com/llms-full.txt)
- [Pricing](https://getwebp.com/pricing)
- [Changelog](https://getwebp.com/changelog)
- [Security](https://getwebp.com/security)
- [Privacy Policy](https://getwebp.com/privacy)
- [Sitemap](https://getwebp.com/sitemap.xml)
- [RSS/Atom feed](https://getwebp.com/feed.xml)
- [npm: @getwebp/mcp-server](https://www.npmjs.com/package/@getwebp/mcp-server)
- [npm: getwebp](https://www.npmjs.com/package/getwebp)