# Alerts and notifications

> MCP tools to read and change your WhatsApp alerts: approved charges, declined charges, daily summary and orders.

- kind: mcp-tool
- status: stable
- access: write
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/avisos

## What it covers [#que-cubre]

The agent can notify you over WhatsApp when a charge comes in, when a charge is declined,
when an order arrives, and send a daily summary at the chosen time. These two tools read and change
those settings.

They do not send messages on their own: they only turn alerts on and off and report the current
settings. Fields that are not sent are preserved.

## Tools [#herramientas]

### View notification settings [#tilopay-get-notification-settings]

- `tilopay_get_notification_settings`
- Access: Read only

Shows how the merchant's notifications are configured: whether payments received are notified over WhatsApp and/or email, which email, from which amount and whether there is a quiet-hours window.

**Parameters**

No parameters.

**Returns**

`{ settings }`

settings = the merchant's notification configuration: which WhatsApp notifications are on (approved charges, failed charges, daily summary, orders) and what time the daily summary is sent.

### Configure the merchant's notifications [#tilopay-set-notification-settings]

- `tilopay_set_notification_settings`
- Access: Write

Changes the merchant's notification settings: turn on or off the payment-received notification over WhatsApp and email, the destination email, the minimum amount to notify and the quiet-hours window (in the merchant's local time). Only send the fields the user asked to change.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `payment_whatsapp` | boolean | — | Notify over WhatsApp when a payment is received |
| `payment_email` | boolean | — | Notify over email when a payment is received |
| `notify_email` | string | — | Email that receives the notifications (if omitted, the account's) |
| `min_amount` | number | — | Minimum amount to notify (0 = notify for any amount) |
| `quiet_from` | integer | null | — | Local time when the quiet window starts (null to remove it) |
| `quiet_to` | integer | null | — | Local time when the quiet window ends (null to remove it) |

**Returns**

`{ settings }`

settings = the already updated notification configuration. Fields that are not sent are kept.
