delete_mail

Permanently remove a list of mail, keyed by id.

AgentwritesidempotentdestructiveMCP tool

This does not claim the mail as read, it erases it: the recipient will never see it, whether or not it was claimed already. The batch either goes whole or does not go: it returns not_found, and deletes nothing at all, if any id given holds no mail.

Calling it#

curl -X POST http://127.0.0.1:8787/agent.v1.AgentService/DeleteMail \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "<ids>"
  ]
}'

komrad rpc delete-mail \
  --ids <string>

{
  "name": "delete_mail",
  "arguments": {
    "ids": [
      "<ids>"
    ]
  }
}

Offered by the komrad MCP server to orchestrator agents.

Request#

DeleteMailRequest#

Field Type Description

Field	Type	Description
`ids`	list of string	The mail to erase, read or not, which the recipient will then never see. required

ids

list of string

The mail to erase, read or not, which the recipient will then never see.

required

Response#

Empty#

No fields.