MCP tool · Email

mail_queue

Show the mail queue for a customer's server — messages waiting to send and why.

mail_queue

R Read

Scope read:email

Read-onlyIdempotentOpen-world

Description

Show the mail queue for a customer's server — messages waiting to send and why. Returns queued messages (id, age, size, sender, recipients, frozen, reason) with total and frozen counts; pass a domain or email as input to narrow it. This is the server-wide backlog — to trace one message's delivery verdict use trace_email, and for raw log lines use read_logs with kind=email. Read over SSH on the hosting node: on a box without shell access it returns degraded:true with a note rather than failing.

Input

Name	Type	Description
`input` required	string	The domain, email or account whose server queue to read — a domain, email, URL or Inleed service id. A domain or email narrows the queue to messages to or from it; the resolved `target` is echoed back.
`limit`	integer	Max queued messages to return (default 50). Range 1–200.

inputSchema

{3 keys}

:{2 keys},

:"The domain, email or account whose server queue to read — a domain, email, URL or Inleed service id. A domain or email narrows the queue to messages to or from it; the resolved `target` is echoed back.",

:"string"

:{4 keys}

:"Max queued messages to return (default 50).",

:1,

:200,

:"integer"

}

:"object",

:[1 item]

"input"

]

}

Click a key to copy its jq path.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mail_queue",
    "arguments": {
      "input": "example.se"
    }
  }
}

A representative call with its required arguments filled.