Image processing for AI agents: resize, convert, compress, crop, and web-ready AI-generated images.
| Endpoint | https://api.pictomancer.ai/mcp (streamable-http) |
|---|---|
| Registry version | 0.4.0 |
| Now | 11 tools · grade F (49) · pin ts_f6112348ecf0f8f81fc24e95ad3b1357 · protocol 2025-06-18 |
| First / last listed | 2026-10-31 03:08 UTC / 2026-10-31 03:08 UTC |
| Grade over time | 2026-10-31: F (49), 11 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_format_info estimate_cost analyze_image resize_image compress_image convert_image crop_image optimize_for_vision optimize_generated_image remove_image_background image_pipeline
get_format_info | Get supported formats and options
Returns supported output formats and their configurable options.
### Responses:
**200**: Successful Response (Success Response)
Content-Type: application/json params: none |
estimate_cost | Estimate the price of an operation
Returns the exact USD price this API would charge for an operation on an input of the given size, without fetching or processing anything. Free. Use it before paying: send X-Max-Cost-USD on the real request to have the API refuse (412) instead of charging more than you allowed. The list price is returned even when the request could end up free (free tier, or a c params: operation*, input_bytes*, format, quality_target, operations |
analyze_image | Analyze an image
Fetch an image from a URL or base64 and return its metadata: size in bytes, pixel dimensions, source format, and what it costs every supported vision model in tokens. Always free. Dimensions are omitted if the image header cannot be read. Also reports whether the input carries a C2PA (Content Credentials) manifest and in which container; the manifest is not validated.
### Respon params: source* |
resize_image | Resize an image
Scale an image by a factor, or fill an exact box. Use 'scale' for uniform scaling, or 'scale_x'/'scale_y' for independent axes (float factors, e.g. 0.5 = half size). Alternatively set 'width'+'height' for fill mode: resize and smart-crop to those exact dimensions in one call (optional 'gravity', default attention). The two modes are mutually exclusive. Optional enhancement modifie params: delivery, source*, scale_x, scale_y, scale, format, width, height, gravity, autorot, denoise, equalize, sharpen |
compress_image | Compress an image
Re-encode an image with quality/format options to reduce file size. Supports jpeg, png, webp, tiff, gif. Instead of a q number you can set quality_target (0-1]: the smallest file with SSIM at or above the target, searched on the worker (jpeg, webp, avif; flat surcharge; outcome reported in X-Pictomancer-Quality-* headers). If the output is not smaller than the input, the request params: delivery, source*, q, format, strip, quality_target, autorot, denoise, equalize, sharpen |
convert_image | Convert image format
Convert an image to a different format (jpeg, png, webp, tiff, gif, avif). Optionally set quality, strip metadata, enable lossless mode (webp, avif), or tune encoder effort (avif). Instead of a q number you can set quality_target (0-1]: the smallest file with SSIM at or above the target, searched on the worker (jpeg, webp, avif; flat surcharge; outcome reported in X-Pictomanc params: delivery, source*, format*, q, strip, lossless, effort, quality_target, autorot, denoise, equalize, sharpen |
crop_image | Crop an image
Extract a rectangular region from an image, in one of three mutually exclusive modes. Manual: give the top-left corner (x, y) and dimensions (width, height) in pixels. Smart crop: give 'gravity' (attention, entropy, centre) plus width and height; the window is picked automatically, clamped to the source if the target is larger. Trim: set 'trim: true' (optional 'threshold') to remove params: delivery, source*, x, y, width, height, gravity, trim, threshold, autorot, denoise, equalize, sharpen, format |
optimize_for_vision | Resize an image for a vision model
Resize an image to the largest size a given vision model still benefits from, and report what it costs that model in tokens before and after. Every provider downscales oversized input before counting tokens, so this alone saves bytes and upload latency rather than tokens. Pass max_tokens to trade resolution for tokens: that lever is continuous on Claude, unavail params: delivery, source*, target_model*, max_tokens, format, q |
optimize_generated_image | Optimize an AI-generated image for the web
The step after image generation. gpt-image, DALL-E, Flux, Midjourney and Stable Diffusion hand back 2-8 MB PNGs; this returns the same picture as a web-ready webp (default), avif, jpeg or png, metadata stripped, transparency kept on webp/avif/png. Optional max_dimension caps the longest side (never upscales); optional q or quality_target (smallest file w params: delivery, source*, format, q, quality_target, max_dimension, strip |
remove_image_background | Remove the background from an image
Cut the subject (person, product, animal, object) out of a photo and return it on a transparent background as png (default), webp or avif. Optional q (1-100) for webp/avif. Runs a segmentation model (U2Net) on CPU: expect a few seconds per image, not milliseconds. Not available in pipeline.
### Responses:
**200**: Processed image binary (Success Response)
Con params: delivery, source*, format, q |
image_pipeline | Run a multi-step image pipeline
Chain multiple operations (resize, compress, convert, crop) in sequence. The image is fetched once, then each operation is applied to the output of the previous one. Max 10 operations per pipeline.
### Responses:
**200**: Processed image binary (Success Response)
Content-Type: application/json
Content-Type: image/jpeg
**Example Response:**
```json
"string"
```
C params: delivery, source*, operations* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.