mailosaur_devices_delete
Permanently delete a Mailosaur virtual security device by specifying its ID. Requires confirmation to prevent accidental removal.
Instructions
Permanently delete a Mailosaur virtual security device.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Device ID. | |
| confirm | No |
Implementation Reference
- src/index.ts:475-479 (handler)The async handler function that executes the device deletion logic. It calls requireConfirm to enforce confirmation, then calls mailosaur.devices.del(id) to perform the deletion, and returns a success response.
async ({ id, confirm }) => { requireConfirm(confirm, `delete device ${id}`); await mailosaur.devices.del(id); return emptyResponse("Device deleted."); } - src/index.ts:471-473 (schema)Input validation schema defining the 'id' (required string) and optional 'confirm' (boolean) parameters for the device delete tool.
{ id: z.string().describe("Device ID."), confirm: z.boolean().optional() - src/index.ts:468-480 (registration)Registration of the mailosaur_devices_delete tool with the MCP server via server.tool(), including its name, description, schema, and handler.
server.tool( "mailosaur_devices_delete", "Permanently delete a Mailosaur virtual security device.", { id: z.string().describe("Device ID."), confirm: z.boolean().optional() }, async ({ id, confirm }) => { requireConfirm(confirm, `delete device ${id}`); await mailosaur.devices.del(id); return emptyResponse("Device deleted."); } ); - src/index.ts:94-97 (helper)Helper function used by the handler to enforce that destructive operations require explicit confirmation (confirm=true).
function requireConfirm(confirm: boolean | undefined, action: string) { if (!confirm) { throw new Error(`Refusing to ${action}. Call again with confirm: true.`); } - src/index.ts:90-91 (helper)Helper function that formats a success response indicating the device was deleted.
function emptyResponse(message = "OK") { return response({ ok: true, message });