Image Editor by Apoth3osis

Name: Image Editor
Brand: Apoth3osis
SKU: 695c368d767df5adfd9bc86e
Price: 0.10 USD
Availability: InStock

Image Editor

Core Utility

Available ActionsEach successful request consumes credits as outlined below.

blur^10crborder^10crcomposite^10crcreate^10crcrop^10crdraw^10crinfo^10crinvert^10crmulti_step^10crresize^10crrotate^10crshear^10crtext^10crtransparent^10cr

Details

Edit and transform images without any design software. Resize, crop, rotate, blur, invert colors, add borders, draw shapes, overlay text, composite layers, remove backgrounds, and apply shear transforms — all from a single tool. Chain multiple operations together in one request to build complete editing workflows like watermarking, thumbnail generation, or branded graphics. Supports PNG, JPEG, and WebP input and output. Upload an image, provide a URL, or reference a file already in cloud storage, and get your edited result back as a stored file with a shareable link or as inline data ready to use immediately.

Use Cases

Generating branded social media graphics by compositing logos onto product images, automating thumbnail creation by resizing and cropping uploaded images to standard dimensions, adding watermarks or copyright text overlays to protect visual content, creating placeholder images with custom colors and dimensions for UI mockups, batch processing profile photos with consistent borders and formatting, applying blur effects to sensitive regions before sharing screenshots, building dynamic certificate or badge generators with text overlays, removing white backgrounds from product images using transparency conversion, preparing images for web optimization by converting formats and resizing for performance, chaining multi-step edits to rotate, crop, resize, and watermark images in a single automated workflow, inverting image colors to create negative versions for dark mode assets or artistic effects, generating high-contrast inverted previews for accessibility testing

Actions(14)

blur^10cr8 params

Apply Gaussian blur to an image.

image_base64string

Base64-encoded image input (png, jpg, webp).

image_urlstring

Public URL to an image (png, jpg, webp).

file_idstring

File ID of an image stored in cloud storage.

paramsobject

Blur parameters. Includes 'radius' (float, default 2.0).

Properties:

radius(number)- Blur radius (higher = more blur).

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output. Defaults to edited.<ext>.

store_fileboolean

Store output in cloud storage for file management access.

Default: true

return_base64boolean

Return base64 output inline when size permits (max 10MB).

Default: false

border^10cr8 params

Add a solid-color border around an image.

image_base64string

Base64-encoded image input (png, jpg, webp).

image_urlstring

Public URL to an image (png, jpg, webp).

file_idstring

File ID of an image stored in cloud storage.

paramsobject

Border parameters.

Properties:

size(integer)- Border width in pixels.

color(string)- Border color (hex string like '#000000', RGB array, or RGBA array).

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline when size permits.

Default: false

composite^10cr8 params(1 required)

Overlay one image on top of another with optional opacity.

paramsrequiredobject

Composite parameters. Provide overlay via overlay_url, overlay_base64, or overlay_file_id.

Properties:

overlay_url(string)- URL of the overlay image.

overlay_base64(string)- Base64-encoded overlay image.

overlay_file_id(string)- File ID of the overlay image.

position(array)- [x, y] position to place the overlay.

opacity(number)- Overlay opacity (0.0 to 1.0).

image_base64string

Base64-encoded base image input.

image_urlstring

Public URL to the base image.

file_idstring

File ID of the base image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

create^10cr5 params

Create a new blank image canvas with custom dimensions and background color.

paramsobject

Canvas creation parameters.

Properties:

width(integer)- Canvas width in pixels.

height(integer)- Canvas height in pixels.

color(string)- Fill color (hex string, RGB array, or RGBA array).

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

crop^10cr8 params(1 required)

Crop an image to a rectangular region defined by [left, top, right, bottom] coordinates.

paramsrequiredobject

Crop parameters.

Properties:

box*(array)- Crop region as [left, top, right, bottom] in pixels.

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

draw^10cr8 params(1 required)

Draw shapes (line, rectangle, or ellipse) onto an image.

paramsrequiredobject

Draw parameters.

Properties:

shape(string)- Shape type to draw.

coordinates*(array)- Coordinate pairs (e.g., [x1, y1, x2, y2]).

fill(string)- Fill color (hex, RGB, or RGBA).

outline(string)- Outline color for rectangle and ellipse.

width(integer)- Line/outline width in pixels.

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

info^10cr3 params

Get image dimensions and mode without modifying the image.

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

invert^10cr7 params

Invert all colors in an image, producing a photographic negative effect. Each RGB pixel value is replaced with 255 minus its original value. Alpha transparency is preserved.

image_base64string

Base64-encoded image input (png, jpg, webp).

image_urlstring

Public URL to an image (png, jpg, webp).

file_idstring

File ID of an image stored in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output. Defaults to edited.<ext>.

store_fileboolean

Store output in cloud storage for file management access.

Default: true

return_base64boolean

Return base64 output inline when size permits (max 10MB).

Default: false

multi_step^10cr8 params(1 required)

Chain multiple image operations together in a single request. Each operation is applied sequentially to the image.

operationsrequiredarray

List of operations to apply sequentially. Each object has 'action' (string) and 'params' (object).

Array of: object

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

resize^10cr8 params(1 required)

Resize an image to specific dimensions or by a scale factor.

paramsrequiredobject

Resize parameters. Provide width+height or scale.

Properties:

width(integer)- Target width in pixels.

height(integer)- Target height in pixels.

scale(number)- Scale factor (e.g., 0.5 for half size, 2.0 for double).

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

rotate^10cr8 params

Rotate an image by a specified number of degrees (counter-clockwise).

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

paramsobject

Rotation parameters.

Properties:

degrees(number)- Rotation angle in degrees (counter-clockwise).

expand(boolean)- Expand canvas to fit rotated image.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

shear^10cr8 params

Apply an affine shear transformation to an image.

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

paramsobject

Shear parameters.

Properties:

x(number)- Horizontal shear factor.

y(number)- Vertical shear factor.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

text^10cr8 params(1 required)

Draw text onto an image at a specified position with customizable size and color.

paramsrequiredobject

Text parameters.

Properties:

text*(string)- The text content to draw on the image.

x(integer)- X position in pixels.

y(integer)- Y position in pixels.

size(integer)- Font size.

color(string)- Text color (hex, RGB, or RGBA).

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

output_formatstring

Output image format.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

transparent^10cr8 params

Make a specific color transparent in the image. Output as PNG to preserve transparency.

image_base64string

Base64-encoded image input.

image_urlstring

Public URL to an image.

file_idstring

File ID of an image in cloud storage.

paramsobject

Transparency parameters.

Properties:

color(string)- The color to make transparent (hex string, RGB array, or RGBA array).

output_formatstring

Output image format. Use 'png' to preserve transparency.

Values:

pngjpegwebp

Default: png

filenamestring

Filename for stored output.

store_fileboolean

Store output in cloud storage.

Default: true

return_base64boolean

Return base64 output inline.

Default: false

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "695c368d767df5adfd9bc86e",
    "parameters": {
      "action": "blur",
      "output_format": "png",
      "store_file": true,
      "return_base64": false
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "695c368d767df5adfd9bc86e",
    "parameters": {
        "action": "blur",
        "output_format": "png",
        "store_file": true,
        "return_base64": false
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695c368d767df5adfd9bc86e",
  parameters: {
    "action": "blur",
    "output_format": "png",
    "store_file": true,
    "return_base64": false
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695c368d767df5adfd9bc86e",
  parameters: {
    "action": "blur",
    "output_format": "png",
    "store_file": true,
    "return_base64": false
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Image Editor - Instructions

Overview

The Image Editor tool provides programmatic image manipulation capabilities including resizing, cropping, rotating, drawing shapes, adding text, compositing layers, applying blur effects, adding borders, creating transparent regions, inverting colors, and more. Operations can be chained together using multi_step mode.

Image Input

Every action (except create) requires an image input via one of:

image_url - Public URL to a PNG, JPG, or WebP image
image_base64 - Base64-encoded image data
file_id - File ID from cloud storage (from a previous upload or edit)

Common Output Options

Parameter	Type	Default	Description
output_format	string	`"png"`	Output format: `png`, `jpeg`, or `webp`
filename	string	`"edited.<ext>"`	Filename for the stored output
store_file	boolean	`true`	Store the result in cloud storage (returns file_id and signed_url)
return_base64	boolean	`false`	Also return the image as inline base64 (max 10 MB)

Actions

info

Get image dimensions and mode without modifying it.

Required: An image input (image_url, image_base64, or file_id) Optional params: None

Example:

{
  "action": "info",
  "image_url": "https://example.com/photo.png"
}

create

Create a new blank image canvas.

Required: None (defaults apply) Optional params:

Param	Type	Default	Description
width	integer	512	Canvas width in pixels
height	integer	512	Canvas height in pixels
color	string/array	`"#ffffff"`	Fill color (hex string, RGB array, or RGBA array)

Example:

{
  "action": "create",
  "params": { "width": 800, "height": 600, "color": "#ff0000" }
}

resize

Resize an image to specific dimensions or by a scale factor.

Required: An image input + either width/height or scale in params Optional params:

Param	Type	Description
width	integer	Target width in pixels
height	integer	Target height in pixels
scale	float	Scale factor (e.g., 0.5 for half size, 2.0 for double)

Example (explicit dimensions):

{
  "action": "resize",
  "image_url": "https://example.com/photo.png",
  "params": { "width": 256, "height": 256 }
}

Example (scale factor):

{
  "action": "resize",
  "file_id": "abc123",
  "params": { "scale": 0.5 }
}

crop

Crop an image to a rectangular region.

Required: An image input + box in params Optional params: None beyond the required box

Param	Type	Description
box	array of 4 ints	Crop region as `[left, top, right, bottom]` in pixels

Example:

{
  "action": "crop",
  "image_url": "https://example.com/photo.png",
  "params": { "box": [50, 50, 300, 300] }
}

rotate

Rotate an image by a specified number of degrees.

Required: An image input Optional params:

Param	Type	Default	Description
degrees	float	0	Rotation angle in degrees (counter-clockwise)
expand	boolean	true	Expand canvas to fit rotated image

Example:

{
  "action": "rotate",
  "image_url": "https://example.com/photo.png",
  "params": { "degrees": 90 }
}

blur

Apply Gaussian blur to an image.

Required: An image input Optional params:

Param	Type	Default	Description
radius	float	2.0	Blur radius (higher = more blur)

Example:

{
  "action": "blur",
  "file_id": "abc123",
  "params": { "radius": 5.0 }
}

border

Add a solid-color border around an image.

Required: An image input Optional params:

Param	Type	Default	Description
size	integer	10	Border width in pixels
color	string/array	`"#000000"`	Border color

Example:

{
  "action": "border",
  "image_url": "https://example.com/photo.png",
  "params": { "size": 20, "color": "#0000ff" }
}

invert

Invert all colors in an image, producing a photographic negative effect. Each RGB pixel value is replaced with 255 minus its original value. Alpha transparency is preserved on RGBA images.

Required: An image input (image_url, image_base64, or file_id) Optional params: None

Example:

{
  "action": "invert",
  "image_url": "https://example.com/photo.png"
}

Example (with file_id):

{
  "action": "invert",
  "file_id": "abc123",
  "output_format": "png",
  "store_file": true
}

text

Draw text onto an image.

Required: An image input + text in params Optional params:

Param	Type	Default	Description
text	string	(required)	The text to draw
x	integer	0	X position in pixels
y	integer	0	Y position in pixels
size	integer	20	Font size
color	string/array	`"#000000"`	Text color

Example:

{
  "action": "text",
  "image_url": "https://example.com/photo.png",
  "params": { "text": "Hello World", "x": 50, "y": 100, "size": 36, "color": "#ffffff" }
}

draw

Draw shapes (line, rectangle, or ellipse) onto an image.

Required: An image input + coordinates in params Optional params:

Param	Type	Default	Description
shape	string	`"line"`	Shape type: `line`, `rectangle`, or `ellipse`
coordinates	array	(required)	Coordinate pairs (e.g., `[x1, y1, x2, y2]`)
fill	string/array	`"#000000"`	Fill color
outline	string/array	`"#000000"`	Outline color (rectangle and ellipse)
width	integer	1	Line/outline width in pixels

Example (rectangle):

{
  "action": "draw",
  "image_url": "https://example.com/photo.png",
  "params": {
    "shape": "rectangle",
    "coordinates": [10, 10, 200, 150],
    "fill": "#ff000080",
    "outline": "#ff0000",
    "width": 3
  }
}

composite

Overlay one image on top of another with optional opacity.

Required: An image input (the base) + an overlay image via one of: overlay_url, overlay_base64, or overlay_file_id in params Optional params:

Param	Type	Default	Description
overlay_url	string	—	URL of the overlay image
overlay_base64	string	—	Base64-encoded overlay image
overlay_file_id	string	—	File ID of the overlay image
position	array	`[0, 0]`	`[x, y]` position to place the overlay
opacity	float	1.0	Overlay opacity (0.0 to 1.0)

Example:

{
  "action": "composite",
  "image_url": "https://example.com/background.png",
  "params": {
    "overlay_url": "https://example.com/logo.png",
    "position": [50, 50],
    "opacity": 0.8
  }
}

shear

Apply an affine shear transformation to an image.

Required: An image input Optional params:

Param	Type	Default	Description
x	float	0	Horizontal shear factor
y	float	0	Vertical shear factor

Example:

{
  "action": "shear",
  "image_url": "https://example.com/photo.png",
  "params": { "x": 0.3, "y": 0.0 }
}

transparent

Make a specific color transparent in the image.

Required: An image input Optional params:

Param	Type	Default	Description
color	string/array	`"#ffffff"`	The color to make transparent

Example:

{
  "action": "transparent",
  "image_url": "https://example.com/icon.png",
  "params": { "color": "#ffffff" },
  "output_format": "png"
}

multi_step

Chain multiple operations together in a single request. Each operation is applied sequentially.

Required: An image input (or use a create operation first) + operations array operations is an array of objects, each with:

Field	Type	Description
action	string	Any single action listed above (not `multi_step` or `info`)
params	object	Parameters for that action

Example:

{
  "action": "multi_step",
  "image_url": "https://example.com/photo.png",
  "operations": [
    { "action": "resize", "params": { "width": 400, "height": 300 } },
    { "action": "invert", "params": {} },
    { "action": "border", "params": { "size": 5, "color": "#333333" } },
    { "action": "text", "params": { "text": "Inverted", "x": 10, "y": 10, "color": "#ffffff" } }
  ],
  "output_format": "jpeg",
  "filename": "processed.jpg"
}

Color Format

Colors can be specified as:

Hex string: "#RRGGBB" or "#RRGGBBAA"
RGB array: [255, 0, 0]
RGBA array: [255, 0, 0, 128]
Comma-separated string: "255,0,0" or "255,0,0,128"

Common Workflows

Resize and watermark: Use multi_step with resize then text to add a watermark label.
Create branded image: Use create to make a canvas, then multi_step with composite to overlay a logo and text for copy.
Thumbnail generation: Use resize with a scale factor or explicit small dimensions, output as jpeg for smaller file size.
Remove white background: Use transparent with color: "#ffffff" and output as png to preserve transparency.
Annotate a screenshot: Use multi_step with draw (rectangles for highlights) and text (labels).
Create dark mode variant: Use invert to flip all colors, useful for generating negative versions of light-themed assets.
Accessibility contrast check: Use invert to preview how content reads with reversed colors.

Important Notes

Output is stored in cloud storage by default (store_file=true) and returns a file_id and signed_url.
Use file_id from a previous result as input for follow-up edits.
The info action returns dimensions and mode without producing an output image.
The create action does not require any image input.
For multi_step, operations are applied in order; each step modifies the image from the previous step.
Inline base64 output (return_base64=true) is limited to 10 MB.
Stored files expire after 7 days.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 695c368d767df5adfd9bc86e ("Image Editor"). Then call the same tool with action 'call_tool', tool_id 695c368d767df5adfd9bc86e, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Dependencies

1 dependencies will be automatically added when you enable this product.

File Management

Image Editor

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(14)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Image Editor - Instructions

Overview

Image Input

Common Output Options

Actions

info

create

resize

crop

rotate

blur

border

invert

text

draw

composite

shear

transparent

multi_step

Color Format

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Dependencies

Looking for help integrating AI into your business? Set up a free consultation.