# x402image

> An x402-paid MCP (Model Context Protocol) server of deterministic image-processing tools that AI agents discover and pay for per call — remove background, AI upscale, resize, optimize. Settlement is USDC on the Base network. No account, no API key, no image library to install.

x402image is built for autonomous agents, not human end users. An agent brings the recipe (which edits and parameters) and the ingredients (a source image URL); x402image provides the compute and returns a finished image as a short-lived signed URL. Call the free `service_info` tool first to discover the current tool list and authoritative live pricing.

## Endpoint

- [MCP endpoint](https://x402image.org/mcp): JSON-RPC over `POST https://x402image.org/mcp`. Any MCP-compatible client works; no keys to provision.
- Discovery: call the free `service_info` tool (no payment, no input). It returns the tool list, per-call USD prices, and how to pay.

## Tools

Prices below are reference values. The authoritative, live price and full parameter schema always come from `service_info` and the HTTP 402 quote.

- `remove_background` (~$0.02): Remove an image's background, isolating the subject (BiRefNet AI segmentation). Optional `background` fill color, or omit for a transparent cutout. Output: cut-out image as a signed URL.
- `upscale` (~$0.02): Upscale with AI super-resolution (ESRGAN) for sharper enlargement. Params: `width` and/or `height` (target pixels; at least one required).
- `resize` (~$0.005): Resize or crop to an exact `width`/`height`. Params include `fit` (scale-down/contain/pad/squeeze/cover/crop) and `gravity` (auto/face/left/right/top/bottom/center/entropy — use `face` to keep faces in frame).
- `optimize` (~$0.005): Convert `format` (webp/avif/jpeg/png/gif) and/or compress at a `quality` (1–100). At least one of format/quality required.
- `process` (dynamic — sum of the included ops): Apply an ordered pipeline of the ops above in a single paid call. Input: `source` (image URL) and `steps` (ordered `[{op, params}]`). One payment, one output.

## Payment

- Protocol: x402. Call any paid tool without payment to receive an HTTP 402 quote with a machine-readable price, currency, recipient address, and retry instructions.
- Settlement: USDC on Base, via a Coinbase CDP facilitator. No sign-up or stored payment method.
- Order of operations: pay first, work second — the image is processed only after settlement confirms; failed work is not charged.
- Input: source images must be reachable over https; private/internal/metadata addresses are refused (SSRF protection), with size and content-type checks.
- Output: a short-lived signed URL that expires and is deleted automatically.

## Optional

- [Homepage](https://x402image.org/): human-readable overview of the service, tools, and pricing.