add_popup · Leaflet MCP: Risk & Policy

WHAT IT DOES

What add_popup does on Leaflet

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

WHY IT NEEDS A POLICY

Why add_popup needs a policy

add_popup generates Leaflet popup code, which modifies map configuration by adding popup elements. This is Write-category: it creates/generates interactive map components reversibly. The blast radius is minimal since popups are UI enhancements with no side effects on underlying data, external systems, or financial operations.

From the tool's definition Tool generates code for 'creating and customizing Leaflet popups' - explicitly creates new UI elements within a map. This is a reversible data/configuration modification (code generation), not destructive or executable.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

add_popup Rate-limited

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

FAQ

Questions about add_popup

What does the add_popup tool do? +

Generate code for creating and customizing Leaflet popups with various options and content. It is categorised as a Write tool in the Leaflet MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on add_popup? +

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

What risk level is add_popup? +

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

Can I rate-limit add_popup? +

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

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

add_popup is provided by the Leaflet MCP server (philgebauer/leaflet-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.