Find contacts
list_contactsFind the people in the user's conversations by a name or a phone number the user gives, one entry
per person, the most recently active first. Each entry carries the person's name, their phone
number in E.164 (null when Werify does not know it, as in a .zip import), how many messages
they sent, and the 10 most recent conversations they appear in, whose
conversation_id the read tools take, with conversation_count for all of them. query is the
name (case- and accent-insensitive) or the phone number to look for, and phone, one of the
user's connected numbers, keeps that number's conversations; large lists page with cursor.
These are the people seen in the user's archive, not the phone's address book. Only conversations
the user owns or has been shared are accessible.
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": {
"query": "<query>"
},
"name": "list_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | No | Optional: one of the user's connected numbers, as list_connected_numbers returns it. Lists only the people of that number's conversations; omit it for every conversation, imported ones included. | |
| query | Yes | The name or phone number to look for. A name matches as a case- and accent-insensitive substring; a number matches on its digits. | |
| cursor | No | The next_cursor from a previous page, sent with the query again; the cursor keeps the query and phone it was made with. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contacts | No | ||
| next_cursor | No | Pass back as cursor to get the next page; null on the last page. |