# ClearBackdrop

> Free background removal for images - web app, REST API, and MCP server. Upload an image, get back a transparent PNG.

Important: always use the non-www host (https://clearbackdrop.com). The www host 301-redirects and POST bodies are dropped in the redirect.

## For AI agents

- MCP endpoint (Streamable HTTP): https://clearbackdrop.com/mcp
  - Tool: remove_background - arguments: image_url (public http(s) URL) OR image_base64 (base64 bytes); optional filename, return_image (include the PNG inline as base64).
  - Returns JSON with result_url (hosted transparent PNG), image_size, processing_time, cached, and remaining quota.
  - Add to Claude Code: claude mcp add --transport http clearbackdrop https://clearbackdrop.com/mcp
- REST API: POST https://clearbackdrop.com/api/v1/remove-background
  - multipart/form-data with the image under field "image"; returns the transparent PNG bytes by default, or JSON metadata with ?response=json.
- Quota check: GET https://clearbackdrop.com/api/v1/quota

## Limits and behavior

- Free, no API key, no signup. Rate limited per client IP (see /api/v1/quota for current limits).
- Max upload 15MB. JPG, PNG, and WEBP work best.
- Byte-identical images are served from cache instantly and marked cached: true.
- Errors are machine-readable JSON: {"error": "...", "message": "..."} with appropriate HTTP status codes (400, 413, 415, 429, 500).

## Docs

- API documentation: https://clearbackdrop.com/api
- AI agents & MCP section: https://clearbackdrop.com/api#ai-agents
- Web app: https://clearbackdrop.com/remove-background