Critical Risk →

remove_local_cname_record

Remove a local CNAME record from Pi-hole with confirmation token

How to control remove_local_cname_record ↓

What remove_local_cname_record does on Pi-hole MCP Server

AI agents call remove_local_cname_record to permanently remove resources in Pi-hole MCP Server — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Critical Risk

Why remove_local_cname_record needs a policy

Removing a CNAME record permanently deletes DNS routing configuration that cannot be automatically recovered. This is an irreversible destructive action. While the confirmation token adds a safeguard, the underlying operation is destructive. This is more severe than a Write operation because DNS records, once removed, require manual re-creation to restore service.

From the tool's definition Tool name contains 'remove' and description states 'Remove a local CNAME record from Pi-hole', indicating irreversible deletion of DNS configuration data.

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

How to control remove_local_cname_record

PolicyLayer is an MCP gateway — it sits between your AI agents and Pi-hole MCP Server, and nothing reaches the server without passing your rules. This is the rule we recommend for remove_local_cname_record:

policy.json
{
  "version": "1",
  "default": "deny",
  "hide": [
    "remove_local_cname_record"
  ]
}

remove_local_cname_record disappears from the agent's tool list entirely, and any attempt to call it is denied. The rest of the server keeps working.

  1. Create a free account and register Pi-hole MCP Server — 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.
RESTRICT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about remove_local_cname_record

What does the remove_local_cname_record tool do? +

Remove a local CNAME record from Pi-hole with confirmation token. It is categorised as a Destructive tool in the Pi-hole MCP Server MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on remove_local_cname_record? +

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

What risk level is remove_local_cname_record? +

remove_local_cname_record is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit remove_local_cname_record? +

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

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

remove_local_cname_record is provided by the Pi-hole MCP Server MCP server (sbarbett/pihole-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Pi-hole MCP Server tool call.

Start from Pi-hole MCP Server, 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.

8 Pi-hole MCP Server 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.