Medium Risk

create_memory

Create a new structured memory document with optional initial content. IMPORTANT: After using this tool, you MUST show the user the complete installation instructions returned by the tool - the memory will not work without proper MCP server setup and project context configuration.

How to control create_memory ↓

What create_memory does on Mcp Structured Memory

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

Medium Risk

Why create_memory needs a policy

This tool creates or initializes new memory structures within the application's context system. It is reversible (the created memory can be modified or removed) and has no irreversible side effects, code execution, financial impact, or destructive capabilities.

From the tool's definition Tool description states 'Create a new structured memory document with optional initial content.' The verb 'create' and 'new document' indicate data creation rather than retrieval (Read) or deletion (Destructive).

Documented attack patterns abuse exactly the kind of access create_memory gives an agent:

How to control create_memory

PolicyLayer is an MCP gateway — it sits between your AI agents and Mcp Structured Memory, and nothing reaches the server without passing your rules. This is the rule we recommend for create_memory:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "create_memory": {
      "limits": [
        {
          "counter": "create_memory_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

create_memory 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.

  1. Create a free account and register Mcp Structured Memory — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
LIMIT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about create_memory

What does the create_memory tool do? +

Create a new structured memory document with optional initial content. IMPORTANT: After using this tool, you MUST show the user the complete installation instructions returned by the tool - the memory will not work without proper MCP server setup and project context configuration. It is categorised as a Write tool in the Mcp Structured 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 create_memory? +

Register the Mcp Structured Memory MCP server in PolicyLayer and add a rule for create_memory: 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 Structured Memory. Nothing to install.

What risk level is create_memory? +

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

Can I rate-limit create_memory? +

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

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

create_memory is provided by the Mcp Structured Memory MCP server (nmeierpolys/mcp-structured-memory). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Mcp Structured Memory tool call.

Start from Mcp Structured Memory, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

10 Mcp Structured Memory tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.