Get lead search
Check an Intellimatch lead search and read its results once it is done.
MCP tool findymail_read → get_lead_search
read
Returns the status first: pending, processing, success, failed or not_found. While it is processing, it adds progress and the counts of finished and pending jobs. When the status is success, it also returns the rows with company, domain, description, employee count range, industries, country, match score and the contact found, with page numbers. Checking the status and reading results are free.
Parameters
| Name | Type | Description |
|---|---|---|
| hash string required | string | Hash returned by start_lead_search. |
| page integer | integer | Results page, starting at 1. |
| per_page integer | integer | Rows per page, up to 500. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "findymail_read",
"arguments": {
"operation": "get_lead_search",
"arguments": {
"hash": "hash"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"hash": "f3b9a1c27d5e4086",
"status": "success",
"data": [
{
"company_name": "Northwind Logistics",
"domain": "northwind.com",
"employee_count_range": "51-200",
"industries": [
"Marketing services"
],
"country": "DE",
"match_score": 94,
"contact_name": "Dana Whitfield",
"contact_email": "dana@northwind.com",
"contact_job_title": "Head of Growth"
},
{
"company_name": "Globex",
"domain": "globex.co",
"employee_count_range": "11-50",
"industries": [
"Advertising"
],
"country": "NL",
"match_score": 88,
"contact_name": "Luis Ortega",
"contact_email": "luis@globex.co",
"contact_job_title": "VP Marketing"
}
],
"meta": {
"page": 1,
"per_page": 100,
"total": 200
}
},
"isError": false
}