{"name":"ai.pictomancer/image-processing","title":null,"url":"https://api.pictomancer.ai/mcp","host":"api.pictomancer.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":1},"findings":[{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports Agent-to-agent image processing: resize, convert, compress, crop, pipeline, background removal, and ; the registry lists 0.4.0.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"Pictomancer.ai","version":"Agent-to-agent image processing: resize, convert, compress, crop, pipeline, background removal, and ","title":null},"capabilities":["experimental","tools"]},"sign_in":null,"tools":[{"name":"get_format_info","title":null,"description":"Get supported formats and options\n\nReturns supported output formats and their configurable options.\n\n### Responses:\n\n**200**: Successful Response (Success Response)\nContent-Type: application/json","read_only":null,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"estimate_cost","title":null,"description":"Estimate the price of an operation\n\nReturns 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 compress that does not shrink the file).\n\n### Responses:\n\n**200**: Successful Response (Success Response)\nContent-Type: application/json\n\n**Example Response:**\n```json\n{\n  \"operation\": \"Operation\",\n  \"price_usd\": 1.0,\n  \"base_usd\": 1.0,\n  \"surcharges_usd\": {},\n  \"size_multiplier\": 1.0,\n  \"within_free_tier\": true,\n  \"free_tier_remaining\": 1,\n  \"currency\": \"Currency\",\n  \"network\": \"Network\"\n}\n```","read_only":null,"destructive":null,"inputs":["operation","input_bytes","format","quality_target","operations"],"required":["operation","input_bytes"],"price_stated_usd":null},{"name":"analyze_image","title":null,"description":"Analyze an image\n\nFetch 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.\n\n### Responses:\n\n**200**: Successful Response (Success Response)\nContent-Type: application/json\n\n**Example Response:**\n```json\n{\n  \"size_bytes\": 1,\n  \"c2pa_manifest\": true\n}\n```","read_only":null,"destructive":null,"inputs":["source"],"required":["source"],"price_stated_usd":null},{"name":"resize_image","title":null,"description":"Resize an image\n\nScale 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 modifiers: denoise (1-3), equalize, sharpen (applied denoise -> equalize -> op -> sharpen).\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","scale_x","scale_y","scale","format","width","height","gravity","autorot","denoise","equalize","sharpen"],"required":["source"],"price_stated_usd":null},{"name":"compress_image","title":null,"description":"Compress an image\n\nRe-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 is free (X-Pig-Billed: 0) and does not consume free-tier quota. Optional enhancement modifiers: denoise (1-3), equalize, sharpen (applied denoise -> equalize -> op -> sharpen).\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","q","format","strip","quality_target","autorot","denoise","equalize","sharpen"],"required":["source"],"price_stated_usd":null},{"name":"convert_image","title":null,"description":"Convert image format\n\nConvert 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-Pictomancer-Quality-* headers). Optional enhancement modifiers: denoise (1-3), equalize, sharpen (applied denoise -> equalize -> op -> sharpen).\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","format","q","strip","lossless","effort","quality_target","autorot","denoise","equalize","sharpen"],"required":["source","format"],"price_stated_usd":null},{"name":"crop_image","title":null,"description":"Crop an image\n\nExtract 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 a uniform background border via content detection; the applied rect is reported in X-Pictomancer-Trim-* headers. Optional enhancement modifiers: denoise (1-3), equalize, sharpen (applied denoise -> equalize -> op -> sharpen).\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","x","y","width","height","gravity","trim","threshold","autorot","denoise","equalize","sharpen","format"],"required":["source"],"price_stated_usd":null},{"name":"optimize_for_vision","title":null,"description":"Resize an image for a vision model\n\nResize 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, unavailable on OpenAI (cost follows the aspect ratio alone), and on Gemini reaches only a flat 258. An image already within budget is returned untouched and free (X-Pig-Billed: 0).\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","target_model","max_tokens","format","q"],"required":["source","target_model"],"price_stated_usd":null},{"name":"optimize_generated_image","title":null,"description":"Optimize an AI-generated image for the web\n\nThe 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 with SSIM >= target, flat surcharge) control quality. Same price as convert. If the result is not smaller than the input it is still returned but free (X-Pig-Billed: 0). X-Pictomancer-Bytes-Before/-After/-Saved-Percent report the saving. The input's C2PA manifest, if any, is reported in X-Pictomancer-C2PA-Input but is not carried over: re-encoding invalidates it.\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","format","q","quality_target","max_dimension","strip"],"required":["source"],"price_stated_usd":null},{"name":"remove_image_background","title":null,"description":"Remove the background from an image\n\nCut 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.\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","format","q"],"required":["source"],"price_stated_usd":null},{"name":"image_pipeline","title":null,"description":"Run a multi-step image pipeline\n\nChain 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.\n\n### Responses:\n\n**200**: Processed image binary (Success Response)\nContent-Type: application/json\nContent-Type: image/jpeg\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/png\n\n**Example Response:**\n```json\n\"string\"\n```\nContent-Type: image/webp\n\n**Example Response:**\n```json\n\"string\"\n```","read_only":null,"destructive":null,"inputs":["delivery","source","operations"],"required":["source","operations"],"price_stated_usd":null}],"tools_listed":11,"samples":[],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2026-12-20","days_after_check":40,"issuer":"Let's Encrypt"},"registry":{"version":"0.4.0","status":200,"published_at":"2026-08-17T23:42:09.357222Z","website_url":null,"repository":"https://gitlab.com/pictomancer.ai/pig-gateway"},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.pictomancer/image-processing","badge":{"url":"https://agoranome.com/mcp-servers/ai.pictomancer/image-processing/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.pictomancer/image-processing/badge.svg)](https://agoranome.com/mcp-servers/ai.pictomancer/image-processing)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}