clear_chat_history

Delete the history file for a session.

Server AgentSpawnMCP sandsaber/agentspawnmcp
Category Destructive
Risk class Critical
Parameters 00 required

What clear_chat_history does on AgentSpawnMCP

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

Why clear_chat_history needs a policy

The tool irreversibly deletes chat history data. This is a destructive operation that cannot be undone - deleted chat history cannot be recovered. The word 'Delete' combined with 'history file' confirms this is a destructive action.

From the tool's definition Delete the history file for a session

Questions about clear_chat_history

What does the clear_chat_history tool do? +

Delete the history file for a session. It is categorised as a Destructive tool in the AgentSpawnMCP 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 clear_chat_history? +

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

What risk level is clear_chat_history? +

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

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

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

clear_chat_history is provided by the AgentSpawn MCP server (sandsaber/agentspawnmcp). 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.