# Contactos

> Herramientas del MCP para la agenda del comercio: ver, guardar y borrar contactos.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/agentes/mcp/contactos

## Qué cubre [#que-cubre]

La agenda le permite al agente reutilizar teléfono y correo al enviar un enlace de pago, sin volver a pedirlos. Borrar un contacto es irreversible.

## Herramientas [#herramientas]

### Ver contactos [#tilopay-list-contacts]

- `tilopay_list_contacts`
- Acceso: Sólo lectura

Lista los contactos guardados del comercio; opcionalmente filtra por nombre.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `search` | string | — | Texto a buscar en el nombre |

**Devuelve**

`{ contacts }`

Lista de contactos guardados del comercio.

### Guardar contacto [#tilopay-save-contact]

- `tilopay_save_contact`
- Acceso: Escritura

Guarda o actualiza un contacto del comercio (nombre, teléfono de WhatsApp y correo) para reutilizarlo en envíos.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `name` | string | sí | Nombre del contacto |
| `phone` | string | — | Teléfono de WhatsApp, ej. +50688887777 |
| `email` | string | — | — |
| `note` | string | — | — |

**Devuelve**

`{ contact }`

El contacto guardado o actualizado.

### Eliminar contacto [#tilopay-delete-contact]

- `tilopay_delete_contact`
- Acceso: Sensible

Elimina un contacto guardado del comercio por su nombre.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `name` | string | sí | Nombre del contacto |

**Devuelve**

`{ removed }`

removed es true. Si no existe un contacto con ese nombre, devuelve error.