Skip to content
MCP tools
Read-onlyProspects (vendor pipeline)MCP tool

prospects_list

Search for vendor prospects by name, status, vendor type, or interest level.

Last updated

Search for vendor prospects by name, status, vendor type, or interest level. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, status, interest_level, priority, estimated_ltv, care_status, contact info, created_at. Filter by status (identified/researching/outreach/responded/nurturing/converted/disqualified/lost), interest_level (cold/warm/hot), priority (low/medium/high/urgent), or vendor_type. For a specific prospect by ID, use prospects_get instead. For aggregate stats, use prospects_stats.

Parameters#

ParameterTypeRequiredDescription
querystringNoSearch term - matches against title, notes (case-insensitive partial match)
statusenumNoFilter by status. identified=new prospect, researching=gathering info, outreach=initial contact, responded=they replied, nurturing=building relationship, converted=became partner, disqualified=not a fit, lost=went cold (default: all) · One of: all, identified, researching, outreach, responded, nurturing, converted, disqualified, lost
vendor_typestringNoFilter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer)
interest_levelenumNoFilter by interest level (default: all) · One of: all, cold, warm, hot
priorityenumNoFilter by priority (default: all) · One of: all, low, medium, high, urgent
care_statusenumNoFilter by care status (default: all) · One of: all, no_status, cared, needs_care, didnt_care
date_fromstringNoShow prospects created on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
date_tostringNoShow prospects created on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
archivedbooleanNoInclude archived prospects (default: false)
limitnumberNoMaximum results (default: 50, max: 500) · Max: 500 · Min: 1
offsetnumberNoSkip N results for pagination (default: 0) · Min: 0

Example prompts#

  • "Show me all my hot lender prospects still in the outreach stage."
  • "List inspector prospects added since March that have responded to me."

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.