delete_mcp_server
Delete an MCP server instance. This is irreversible, removes connected users
This record as markdown: /tools/codeswhat-portkey-admin-mcp/delete-mcp-server.md
What delete_mcp_server does on Portkey Admin
AI agents call delete_mcp_server to permanently remove resources in Portkey Admin, typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.
Why delete_mcp_server is rated Critical
This tool permanently deletes an MCP server instance and disconnects its users. The irreversible nature and potential impact on connected users (loss of access, state, configuration) makes this Destructive rather than a mere Write operation. While not directly financial, the blast radius is high due to service disruption.
From the tool's definition Tool description states 'Delete an MCP server instance. This is irreversible, removes connected users' - explicitly using 'Delete' and 'irreversible' indicates permanent removal of data and state.
Attacks that exploit this kind of access
The rule that runs delete_mcp_server safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Portkey Admin, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For delete_mcp_server, this is the rule to start with:
delete_mcp_server is removed from the agent's tool list entirely, so the agent never calls it. The rest of the server keeps working.
The button opens the PolicyLayer dashboard: create your workspace, connect Portkey Admin, apply this rule, and every delete_mcp_server call is checked against it from then on.
Questions about delete_mcp_server
Delete an MCP server instance. This is irreversible, removes connected users. It is categorised as a Destructive tool in the Portkey Admin MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.
Register the Portkey Admin MCP server in PolicyLayer and add a rule for delete_mcp_server: 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 Portkey Admin. Nothing to install.
delete_mcp_server is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.
Yes. Add a rate_limit block to the delete_mcp_server 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.
Set action: deny in the PolicyLayer policy for delete_mcp_server. 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.
delete_mcp_server is provided by the Portkey Admin MCP server (codeswhat/portkey-admin-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Portkey Admin, and thousands of servers like it.
Across the catalogue