Search contacts on a Beeper account
search_contactsSearch contacts on a specific messaging account by name, phone number, email, or @username—including people you have never chatted with—to find their ID for starting a chat.
Instructions
Find people on one account (e.g. WhatsApp, Signal), including people you have never chatted with. A phone number, email or @username is also looked up exactly on the network. Use the returned id with start_chat. Account IDs come from the official Beeper MCP's get_accounts.
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": {
"accountID": "<accountID>",
"query": "<query>"
},
"name": "search_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 10) | |
| query | Yes | Name, phone number (E.164), email or @username | |
| accountID | Yes | Account to search, e.g. whatsapp.33612345678 |