process_folder · Imagic MCP: Risk & Policy

WHAT IT DOES

What process_folder does on Imagic

AI agents use process_folder to create or update resources in Imagic — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Imagic environment.

WHY IT NEEDS A POLICY

Why process_folder needs a policy

This tool batch-processes all images in a folder, modifying or creating image files. It writes/overwrites output files but is not explicitly described as irreversible deletion. However, if it overwrites originals in-place, effects could be hard to reverse — but the description does not confirm destructive overwriting, so Write is the most appropriate category.

From the tool's definition Apply a convert, resize, or convert-and-resize operation to all image files in a folder

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

process_folder Rate-limited

process_folder stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "process_folder": {
      "limits": [
        {
          "counter": "process_folder_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Imagic, so you can run agents against it safely.

FAQ

Questions about process_folder

What does the process_folder tool do? +

Apply a convert, resize, or convert-and-resize operation to all image files in a folder. Non-image files are automatically skipped. It is categorised as a Write tool in the Imagic MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on process_folder? +

Register the Imagic MCP server in PolicyLayer and add a rule for process_folder: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Imagic. Nothing to install.

What risk level is process_folder? +

process_folder is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit process_folder? +

Yes. Add a rate_limit block to the process_folder rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block process_folder completely? +

Set action: deny in the PolicyLayer policy for process_folder. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides process_folder? +

process_folder is provided by the Imagic MCP server (sonic0002/imagic-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.