Read-onlyDeals (vendor pipeline)MCP tool
deals_list
Search for vendor deals by title, status, vendor type, or deal type.
Last updated
Search for vendor deals by title, status, vendor type, or deal type. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, deal_type, status, payment_status, amount, fee, commission_amount, property_address, contact info, created_at. Filter by status (pending/in_progress/completed/invoiced/paid/cancelled/disputed), payment_status (unpaid/invoiced/paid/refunded), vendor_type, or deal_type. For a specific deal by ID, use deals_get instead. For aggregate stats, use deals_stats.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term - matches against title, property_address, notes (case-insensitive partial match) |
status | enum | No | Filter by status. pending=awaiting start, in_progress=work underway, completed=work done, invoiced=invoice sent, paid=payment received, cancelled=deal off, disputed=payment issue (default: all) · One of: all, pending, in_progress, completed, invoiced, paid, cancelled, disputed |
payment_status | enum | No | Filter by payment status (default: all) · One of: all, unpaid, invoiced, paid, refunded |
vendor_type | string | No | Filter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer) |
deal_type | string | No | Filter by deal type (e.g. inspection, appraisal, escrow_service, title_service, photography, staging, repair) |
vertical | string | No | Filter by industry vertical (e.g., lending, insurance, inspection) |
date_from | string | No | Show deals created on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
date_to | string | No | Show deals created on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
archived | boolean | No | Include archived deals (default: false) |
limit | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
offset | number | No | Skip N results for pagination (default: 0) · Min: 0 |
Example prompts#
- "Show me all my unpaid inspection deals from the last 30 days."
- "Pull up every invoiced deal that has not been paid yet."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.