Read-onlyPartners (vendor pipeline)MCP tool
partners_list
Search for vendor partners by name, status, vendor type, or tier.
Search for vendor partners by name, status, vendor type, or tier. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, status, tier, partner_since, care_status, contact info, created_at. Filter by status (onboarding/active/preferred/paused/churned), tier (standard/preferred/vip), vendor_type, or care_status. For a specific partner by ID, use partners_get instead. For aggregate stats, use partners_stats.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term - matches against title, notes (case-insensitive partial match) |
status | enum | No | Filter by status. onboarding=setting up, active=regular partner, preferred=top partner, paused=temporarily inactive, churned=relationship ended (default: all) · One of: all, onboarding, active, preferred, paused, churned |
tier | enum | No | Filter by partner tier (default: all) · One of: all, standard, preferred, vip |
vendor_type | string | No | Filter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer) |
care_status | enum | No | Filter by care status (default: all) · One of: all, no_status, cared, needs_care, didnt_care |
date_from | string | No | Show partners created on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
date_to | string | No | Show partners created on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
archived | boolean | No | Include archived partners (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 preferred tier lender partners."
- "List active inspector partners flagged as needing care this month."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.