image-upsert · MCP Index Notes MCP: Risk & Policy

WHAT IT DOES

What image-upsert does on MCP Index Notes

AI agents use image-upsert to create or update resources in MCP Index Notes — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your MCP Index Notes environment.

WHY IT NEEDS A POLICY

Why image-upsert needs a policy

This tool creates or updates image records in the notes system, which is a reversible write operation. It does not execute code, delete data, move money, or trigger external operations. The 'upsert' semantic (update or insert) and image storage capability clearly place it in the Write category.

From the tool's definition Tool performs 'upsert' operation (store/create or modify) on image data, taking base64 data or file path as input and returning an image id, indicating persistent data modification.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

image-upsert Rate-limited

image-upsert 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": {
    "image-upsert": {
      "limits": [
        {
          "counter": "image-upsert_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 MCP Index Notes, so you can run agents against it safely.

FAQ

Questions about image-upsert

What does the image-upsert tool do? +

Store an image (base64 data or file path) under a key. Returns image id. It is categorised as a Write tool in the MCP Index Notes MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on image-upsert? +

Register the MCP Index Notes MCP server in PolicyLayer and add a rule for image-upsert: 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 MCP Index Notes. Nothing to install.

What risk level is image-upsert? +

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

Can I rate-limit image-upsert? +

Yes. Add a rate_limit block to the image-upsert 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 image-upsert completely? +

Set action: deny in the PolicyLayer policy for image-upsert. 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 image-upsert? +

image-upsert is provided by the MCP Index Notes MCP server (vjsr007/mcp-index-notes). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.