# Contacts

> MCP tools for your address book: view, save and delete contacts.

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

## What it covers [#que-cubre]

The address book lets the agent reuse phone and email when sending a payment link, without asking again. Deleting a contact is irreversible.

## Tools [#herramientas]

### Save contact [#tilopay-save-contact]

- `tilopay_save_contact`
- Access: Write

Saves or updates a merchant contact (name, WhatsApp phone and email) to reuse it when sending links.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Contact name |
| `phone` | string | — | WhatsApp phone, e.g. +50688887777 |
| `email` | string | — | Contact email (saved only if valid) |
| `note` | string | — | Internal note |

**Returns**

`{ contact }`

The saved or updated contact.

### View contacts [#tilopay-list-contacts]

- `tilopay_list_contacts`
- Access: Read only

Lists the merchant's saved contacts; it can filter by name.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | string | — | Text to search in the name |

**Returns**

`{ contacts }`

List of the merchant's saved contacts.

### Delete contact [#tilopay-delete-contact]

- `tilopay_delete_contact`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Deletes a saved merchant contact by its name.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Contact name |

**Returns**

`{ removed }`

removed is true. When no contact exists with that name, it returns an error.