List leads
List and filter the workspace’s leads. Also returns the declared custom columns, the past lead searches that produced these leads, the workspace total and the plan’s lead limit — everything a grid needs in one call.
Requires the read permission.
Authorizations
A ManyPI API key (mpi_...) from Settings → API keys, or an OAuth 2.1 access token obtained through the MCP consent flow.
Query Parameters
Free text across company, full name, email and domain.
A lead status, or archived / unsubscribed (which are flags, not statuses).
new, qualified, contacted, disqualified, archived, unsubscribed The agent run id of the lead search that produced the leads.
Narrow to one brand, or all for the whole workspace.
Max 500.
x <= 500Response
Leads and grid metadata.
