PhotoCraft for your agent

Use PhotoCraft in your agent’s chat

1. Connect once. Follow the MCP setup instructions to add all 13 toolsets to your agent.
2. Provide the file. Give your agent a path it can read, or attach the file if your client supports uploads. The agent needs file access and HTTP transfer tools.
3. Describe the task. In your agent’s chat, say which file to use, what to do and what result you want. Your agent calls the connected tool and returns the information or output file.

What to ask your agent

After connecting, replace the example filename with your own file and send this in your agent’s chat:

Rotate scan.png 90 degrees clockwise and return a PNG copy.

No special command or required brand phrase. If your agent chooses another method, ask it to use the connected EasyRunCraft tools. Review the result before continuing.

Supported operations

Use editor_capabilities with editor: "photo" to check supported operations. Pass the selected operation to process_photo.

inspect

Read canvas dimensions, color mode, bit depth and the layer tree.

edit

Apply up to five ordered edits. Rotate the entire canvas clockwise by 90, 180 or 270 degrees; flip it horizontally or vertically; or resize it to an explicit width and height in pixels.

convert

Export the uploaded image as PNG, JPEG, WebP or PSD without applying edits.

Files, limits and results

Your assistant uses create_upload and sends the bytes to the upload URL with HTTP PUT. It then calls process_photo with the uploaded file ID and a new request_id. Reuse the request ID only to retry the same request.

Each input and output file can be up to 20 MB for accounts without a subscription and Starter, or 100 MB on Creator and Studio. See plan file limits. Each account can have two active jobs and each native command has a 45-second limit. Both resize dimensions must be between 1 and 4096 pixels. Images over 16,777,216 canvas pixels are outside the supported range. PNG, JPEG and WebP output flatten layers. JPEG also drops transparency. Use PSD for layered output and review it for compatibility.

Poll get_job at most once per second. Inspection data is in result; downloadable outputs are in file. Edits create a private copy. Open the PhotoCraft editor.

Files and jobs expire after 24 hours. Upload and download links expire after 10 minutes. Anyone holding a valid link can use it until it expires.

Tool-call example for agents and developers

Your agent handles the tool calls. For a direct integration, the arguments to process_photo look like this:

{
  "file_id": "<uploaded file ID>",
  "request_id": "<new request ID>",
  "operation": {
    "type": "edit",
    "steps": [
      {
        "type": "rotate",
        "degrees": 90
      }
    ],
    "format": "png"
  }
}