remove_domain

Remove a domain from the allow or deny list.

Server Mcp Pihole obrien-matthew/mcp-pihole
Category Destructive
Risk class Critical
Parameters 00 required

What remove_domain does on Mcp Pihole

AI agents call remove_domain to permanently remove resources in Mcp Pihole — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why remove_domain needs a policy

Removing a domain from allow/deny lists is an irreversible deletion of a configuration entry. If misused, an AI agent could remove critical block rules (allowing malicious domains) or remove allow-list entries (breaking legitimate access), with significant security and availability impact. This matches the Destructive category as the deletion cannot be undone without re-adding the entry manually.

From the tool's definition 'Remove a domain from the allow or deny list' — permanently removes a domain entry from Pi-hole's filtering configuration

Questions about remove_domain

What does the remove_domain tool do? +

Remove a domain from the allow or deny list. It is categorised as a Destructive tool in the Mcp Pihole 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_domain? +

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

What risk level is remove_domain? +

remove_domain 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_domain? +

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

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

remove_domain is provided by the Mcp Pihole MCP server (obrien-matthew/mcp-pihole). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.