list_leads
List recent leads with status: active, bounced or unsubscribed.
›List our leads and break them down by status so I can see the bounce rate on the last import.
What it does
Returns the most recent 200 leads with their current status. Status is the useful column — it separates the list you can still email from the records that exist only so they never get emailed again.
Watching bounced counts after an import is the earliest available warning about list quality. Bounce rates in the double digits mean the source is bad, and continuing to send against it damages the domain far more than the campaign could ever return.
The habit worth building is checking this immediately after the first small batch of a new list, before enrolling the rest. A hundred leads will tell you whether the source is clean, and stopping there costs you nothing. Finding out at four thousand costs you the domain.
Unsubscribed records are worth looking at too, not just bounced ones. A rising opt-out rate on a particular source or segment is telling you the targeting is wrong well before the complaint rate does, and it is the cheaper signal to act on.
Parameters
None. Call it with an empty object — there is nothing to configure.
* required · Maps to GET /api/leads
What comes back
Up to 200 recent leads with `status` of active, bounced or unsubscribed.
The thing people get wrong
This is a recent-records view, not a full export. Do not use the count here as your total list size.
Use it with
More leads tools
See all 22 tools and the connection string on the MCP server page.