find_contact
Search local Signal contacts by name, number, nickname, or username to resolve a recipient's E.164 number before messaging or confirm a contact exists. Optionally include non-address-book recipients.
Instructions
Find contacts whose number, name, given/family name, nickname or username contains query (case-insensitive substring; required). Use it to resolve a name to an E.164 number before send_message, or to check that a contact exists; use list_contacts instead to list everyone or filter by blocked status. all_recipients (default false) also searches people outside your address book, e.g. group members known only by their profile name. Reads the local contact store only. Returns a list (possibly empty) of contact objects with number, uuid, name, given_name, family_name, about, blocked and display_name.
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": "find_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Case-insensitive fragment of a name, nickname, username or phone number | |
| all_recipients | No | Also include recipients that are not in your address book (e.g. members of your groups), with their profile names |