Read-onlyLeadsMCP tool
leads_list
Search for leads by status, source, or text.
Search for leads by status, source, or text. Use to find lead IDs before updating or converting, or to answer questions about the lead pipeline. Returns IDs only by default for efficiency; use the fields parameter to include additional data. Response includes relatedIds.contactIds for chainable operations.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term (searches name, email, phone) |
status | enum | No | Filter by lead status · One of: new, contacted, qualified, unqualified, converted, lost |
source | string | No | Filter by lead source |
fields | array of enum | No | Field groups to include. Empty/omitted = IDs only. Options: basic (id, type, status), contact (name, email, phone), source (source, score), timeline (dates), full (all fields). · Values: basic, contact, source, timeline, full |
limit | string | No | Max results. Use a number (e.g. "25") or "all". "all" and any value above 200 are capped at 200 server-side. |
Example prompts#
- "Show me all my qualified leads that came from open houses."
- "Find leads named Garcia and include their contact info and lead score."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.
Previous name#
This tool was previously published as search_leads. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.