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

engagements_list

Search for vendor engagements by title, status, vendor type, or engagement type.

Last updated

Search for vendor engagements by title, status, vendor type, or engagement type. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, engagement_type, status, scheduled_date, scheduled_time, duration_minutes, location, contact info, created_at. Filter by status (proposed/scheduled/in_progress/follow_up/completed/cancelled), vendor_type, or engagement_type. For a specific engagement by ID, use engagements_get instead. For aggregate stats, use engagements_stats.

Parameters#

ParameterTypeRequiredDescription
querystringNoSearch term - matches against title, notes (case-insensitive partial match)
statusenumNoFilter by status. proposed=suggested, scheduled=confirmed, in_progress=happening now, follow_up=needs follow-up, completed=done, cancelled=not happening (default: all) · One of: all, proposed, scheduled, in_progress, follow_up, completed, cancelled
vendor_typestringNoFilter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer)
engagement_typestringNoFilter by engagement type (e.g. coffee_meeting, lunch, phone_call, office_visit, networking_event, training, co_marketing)
date_fromstringNoShow engagements scheduled on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
date_tostringNoShow engagements scheduled on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
archivedbooleanNoInclude archived engagements (default: false)
limitnumberNoMaximum results (default: 50, max: 500) · Max: 500 · Min: 1
offsetnumberNoSkip N results for pagination (default: 0) · Min: 0

Example prompts#

  • "What meetings do I have scheduled with lenders this month?"
  • "List every coffee meeting still sitting in proposed status that needs confirming."

Safety#

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