unsubscribe_sender
Unsubscribes a newsletter sender via RFC 8058 one-click POST or Bridge mailto, supports dry-run detection, and falls back to an archive filter.
Instructions
Unsubscribe from a newsletter sender - PURELY DETERMINISTIC through the two safe ways (HTTPS one-click POST per RFC 8058, or mailto through your own Bridge, which needs PROTON_SMTP_ENABLED=1). No model decides; protected senders and messages with an auth failure are NEVER unsubscribed. Contacts the sender's server - do not auto-approve.
target: Message-ID (with angle brackets) OR an email address. For an
address, the newest matching message in the INBOX is used.
mode: 'auto' executes (tier 1/2), 'dry_run' only shows the detected tier.
Exactly ONE attempt per sender, ever (never a retry). If an attempt fails,
an archive filter for the sender is created as a fallback.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"target": "<target>"
},
"name": "unsubscribe_sender"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | auto | |
| target | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |