mindmap_promote · Mindmap MCP: Risk & Policy

WHAT IT DOES

What mindmap_promote does on Mindmap

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

WHY IT NEEDS A POLICY

Why mindmap_promote needs a policy

This tool modifies the properties of existing data (memories) by altering their trust status or blessing state. It does not retrieve data (Read), execute arbitrary code (Execute), irreversibly delete data (Destructive), or involve financial transactions (Financial). The modification is reversible—a promoted memory can presumably be demoted.

From the tool's definition Tool name 'mindmap_promote' and description 'Explicitly bless a memory as trusted: marks it' indicate modification of metadata/status associated with stored memories, changing their trust level or state.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

mindmap_promote Rate-limited

mindmap_promote 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": {
    "mindmap_promote": {
      "limits": [
        {
          "counter": "mindmap_promote_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 Mindmap, so you can run agents against it safely.

FAQ

Questions about mindmap_promote

What does the mindmap_promote tool do? +

Explicitly bless a memory as trusted: marks it. It is categorised as a Write tool in the Mindmap MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on mindmap_promote? +

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

What risk level is mindmap_promote? +

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

Can I rate-limit mindmap_promote? +

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

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

mindmap_promote is provided by the Mindmap MCP server (@ravi-labs/mindmap-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.