search_contacts
Search the user's own contacts, the only people they can look up: free text (name, email, company), job titles and keywords (any of, partial match), seniority, department, country, city, tags, exact company or title, and status.
What it does
Search the user's own contacts, the only people they can look up: free text (name, email, company), job titles and keywords (any of, partial match), seniority, department, country, city, tags, exact company or title, and status. tag_match 'all' requires every tag, 'any' requires one. Returns {items, total}; paginate with limit and offset. Use the returned ids for enroll_contacts and tag_contacts. To find new people, set a campaign's ICP (set_campaign_icp).
Parameters
| Name | Type | Notes |
|---|---|---|
| q | string | |
| titles | array | Any of these, partial match: [\"head of sales\", \"cto\"] |
| keywords | array | Any of these in company or title |
| seniority | array | |
| department | array | |
| country | array | |
| city | array | |
| tags | array | |
| tag_match | any | all | |
| company | string | Exact company name, case-insensitive |
| title | string | Exact job title, case-insensitive |
| status | active | bounced | unsubscribed | |
| limit | number | |
| offset | number |
* required
More contacts tools
See all 147 tools and the connection string on the MCP server page.