Start lead search
Start an Intellimatch search for companies that match a description, with contacts if you ask for them.
MCP tool findymail_write → start_lead_search
write Confirm
Returns a hash. Pass it to get_lead_search to follow the search and read the rows. The search spends Findymail credits: 1 per 10 companies in broad mode or 1 per company in targeted mode, plus 1 per contact, 1 per email and 10 per phone found, charged when the export is generated. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Plain-English description of your target companies. |
| limit integer | integer | Companies to find, 100 by default, 5000 at most. |
| mode string | string | broad (default, includes adjacent companies) or targeted (fewer, more precise). |
| target_job_titles array | array | Up to 3 tiers of job titles in priority order, for example [["Head of Growth", "VP Marketing"]]. Default [["CEO"]]. |
| find_contact boolean | boolean | Find a contact at each company. |
| find_email boolean | boolean | Find the contact email. |
| find_phone boolean | boolean | Find the contact phone number. |
| require_email boolean | boolean | Keep only companies where an email was found. Needs find_contact and find_email. |
| exclusion_list_ids array | array | Exclusion list IDs to apply. 0 is the global list (default), -1 applies none. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "findymail_write",
"arguments": {
"operation": "start_lead_search",
"arguments": {
"query": "Agencies in Europe specializing in paid ads for e-commerce",
"limit": 200,
"mode": "targeted",
"target_job_titles": [
[
"Head of Growth",
"VP Marketing"
]
],
"find_contact": true,
"find_email": true,
"exclusion_list_ids": [
1204
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"hash": "f3b9a1c27d5e4086"
},
"isError": false
}