Critical Risk →

waha_clear_chat_messages

Clear all messages from a chat. WARNING: This is a destructive operation that cannot be undone.

How to control waha_clear_chat_messages ↓

What waha_clear_chat_messages does on WAHA MCP Server

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

Critical Risk

Why waha_clear_chat_messages needs a policy

This tool permanently deletes all messages from a chat without recovery option, making it irreversible. While the blast radius is limited to a single chat's history (not system-wide data deletion), the permanent loss of communication records represents significant destructive capability.

From the tool's definition The tool description explicitly states 'Clear all messages from a chat' and includes a WARNING: 'This is a destructive operation that cannot be undone.' The irreversible deletion of all chat messages fits the Destructive category.

Risk signalsBulk/mass operation — affects multiple targets

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

How to control waha_clear_chat_messages

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

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

waha_clear_chat_messages 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 WAHA 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 waha_clear_chat_messages

What does the waha_clear_chat_messages tool do? +

Clear all messages from a chat. WARNING: This is a destructive operation that cannot be undone. It is categorised as a Destructive tool in the WAHA 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 waha_clear_chat_messages? +

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

What risk level is waha_clear_chat_messages? +

waha_clear_chat_messages 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 waha_clear_chat_messages? +

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

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

waha_clear_chat_messages is provided by the WAHA MCP Server MCP server (seejux/waha-whatsapp-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every WAHA MCP Server tool call.

Start from WAHA 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.

52 WAHA 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.