put_content · Obsidian Modified MCP: Risk & Policy

WHAT IT DOES

What put_content does on Obsidian Modified

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

WHY IT NEEDS A POLICY

Why put_content needs a policy

This tool replaces the full content of a file, which is a destructive-in-practice write operation. However, since it can create files and overwrite (not delete) them, and overwrites are technically reversible if backups exist (Obsidian has version history/sync), Write is the most appropriate category.

From the tool's definition 'Overwrite the entire content of a file. Creates the file if it does not exist.'

Risk signalsBulk/mass operation — affects multiple targets

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

put_content Rate-limited

put_content 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": {
    "put_content": {
      "limits": [
        {
          "counter": "put_content_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 Obsidian Modified, so you can run agents against it safely.

FAQ

Questions about put_content

What does the put_content tool do? +

Overwrite the entire content of a file. Creates the file if it does not exist. It is categorised as a Write tool in the Obsidian Modified MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on put_content? +

Register the Obsidian Modified MCP server in PolicyLayer and add a rule for put_content: 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 Obsidian Modified. Nothing to install.

What risk level is put_content? +

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

Can I rate-limit put_content? +

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

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

put_content is provided by the Obsidian Modified MCP server (@marwansaab/obsidian-modified-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.