Stop sending to an address
add_suppressionBlocks sending to an email address or entire domain so you can honor opt-out and do-not-contact requests immediately.
Instructions
Purpose: stop sending to an address, or to a whole domain (pass "@example.com"). Use it the moment someone asks not to be contacted. NOT for: undoing one (remove_suppression). Returns: the row that now blocks that address. Adding is always allowed and always safe; it is the direction that protects the account.
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": {
"email": "<email>"
},
"name": "add_suppression"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | The address to suppress, or "@example.com" for a whole domain. | ||
| level | No | Defaults to address, or domain when the value starts with @. | |
| origin | No | Why the address is blocked. Defaults to manual. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| No | |||
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| level | No | ||
| origin | No |