Read-onlyPipelinesMCP tool
pipeline_records_list
List pipeline records with filtering.
List pipeline records with filtering. Use to browse a pipeline or find record IDs before get/update/move operations. Filter by stage, care status, priority, source, or search by name/email/title. Returns records with contact info and stage details.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
pipeline_type_id | string | No | Filter by pipeline type · Format: UUID |
stage_key | string | No | Filter by stage key (e.g., "lead", "demo", "trial") |
care_status | enum | No | Filter by care status · One of: no_status, cared, needs_care, didnt_care |
priority | enum | No | Filter by priority level · One of: low, medium, high, urgent |
source | string | No | Filter by source |
search | string | No | Search by contact name, email, or record title |
is_archived | boolean | No | Include archived records (default: false) |
page | integer | No | Page number (default: 1) · Min: 1 |
limit | integer | No | Results per page (default: 25) · Max: 100 · Min: 1 |
sort_by | enum | No | Sort field · One of: created_at, updated_at, estimated_ltv, expected_close_date, priority |
sort_order | enum | No | Sort direction · One of: asc, desc |
Example prompts#
- "List everyone sitting in the demo stage of my pipeline right now."
- "Show urgent pipeline records that still need care, sorted by expected close date."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.