Search contacts
search_contactsList and search this workspace's contacts, filtered by company/owner/tag, sorted and paginated. Returns summary rows (id, firstName, lastName, email, phone, jobTitle, company, owner, tags) plus pagination { page, perPage, total }. Use get_contact to fetch one contact's full detail by id.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search over name, email and company. Omit for no text filter. | |
| tag | No | Filter to contacts carrying this tag. Omit for any tag. | |
| page | No | 1-based page number of results to return. Default 1. | |
| sortBy | No | Field to sort by. Default name. Allowed: name, email, createdAt. | name |
| ownerId | No | Filter to contacts owned by this workspace member's user id. | |
| perPage | No | Number of contacts per page (1-100). Default 25. | |
| sortDir | No | Sort direction. Default asc. | asc |
| companyId | No | Filter to contacts at this company id (from search_companies). |