save_knowledge · Domain memory MCP: Risk & Policy

WHAT IT DOES

What save_knowledge does on Domain memory

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

WHY IT NEEDS A POLICY

Why save_knowledge needs a policy

The tool creates or updates knowledge entries (reversible write operations), not reading data (Read), executing arbitrary code (Execute), permanently destroying data (Destructive), or moving money (Financial). The 'archive or supersede' language indicates modification rather than irreversible deletion.

From the tool's definition Tool description states 'Create, update, archive or supersede a knowledge entry' — these are reversible modifications to stored knowledge entries. The tool modifies data state within the domain memory system.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

save_knowledge Rate-limited

save_knowledge 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": {
    "save_knowledge": {
      "limits": [
        {
          "counter": "save_knowledge_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 Domain memory, so you can run agents against it safely.

FAQ

Questions about save_knowledge

What does the save_knowledge tool do? +

Create, update, archive or supersede a knowledge entry. Always call search_knowledge first. Conflicts block the write — resolve with the user before retrying. It is categorised as a Write tool in the Domain memory MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on save_knowledge? +

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

What risk level is save_knowledge? +

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

Can I rate-limit save_knowledge? +

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

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

save_knowledge is provided by the Domain memory MCP server (mashware/domain-memory). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.