Manage Pipelines with MCP

34 min

Peach's Model Context Protocol (MCP) server lets a compatible AI assistant inspect and manage your Pipelines using natural-language requests.

You can ask the assistant to create a pipeline, inspect its stages, enroll a contact, move an item, configure drop-off thresholds, or attach automations to stage events. The assistant translates your request into Peach MCP tool calls.

Before you begin

You need:

A Peach account with Pipelines enabled.

Permission to access the relevant account and Pipelines.

An MCP-compatible client, such as ChatGPT, Claude, Claude Code, Antigravity, or another remote HTTP MCP client.

Peach connected and authorized in that client.

Connect Peach to your AI assistant

In Peach, open the Connect Peach to your AI assistant setup page.

Choose your AI client.

Copy the displayed Peach MCP server URL.

Add it as a custom MCP server or connector in your AI client.

Complete the Peach authorization prompt in the browser window opened by your client.

Return to the client and ask it to list your Peach Pipelines.

The exact connection screen varies by client:

Client	Where to add Peach
ChatGPT	Settings → Connectors → Add custom connector
Claude	Settings → Connectors → Add custom connector
Claude Code	Add a remote HTTP MCP server with claude mcp add --transport http
Antigravity	Settings → Customizations → Add MCP
Other clients	Add the displayed URL as a remote HTTP MCP server with OAuth

Your client should handle Peach sign-in and OAuth authorization. Do not paste passwords or access tokens into prompts.

For more details, checkout https://trypeach.ai/mcp

Start by asking the assistant to orient itself

Pipeline operations use IDs such as pipe_…, stg_…, and pli_…. You normally do not need to type them yourself. Ask the assistant to find the relevant Pipeline, stage, and item before changing anything.

A good opening prompt is:

List my Peach Pipelines. For each one, show its friendly item name and stages. Do not make any changes.

For changes affecting several records, ask for a preview first:

Find all active leads in the Contacted stage of the Sales pipeline. Show me what would move to Demo Scheduled, but do not move anything yet.

After reviewing the result:

Move the items from that preview to Demo Scheduled. Report each item that changed and any failures.

This two-step pattern reduces mistakes when names are similar or a request affects multiple contacts.

What you can manage through MCP

Task	Available through MCP
List Pipelines	Yes
View a Pipeline and its stages	Yes
Create or update a Pipeline	Yes
Create, rename, recolor, reorder, or delete stages	Yes
List active items, optionally filtered by stage	Yes
Enroll a contact	Yes
Move an item to another stage	Yes
Update an item's title or assignee	Yes
Configure stage drop-off thresholds	Yes
Attach Peach automations to stage entry, exit, or drop-off	Yes
Read Pipeline Analytics reports	Not currently exposed as Pipeline MCP tools
Set item priority, next action, due date, or a general work status	Not supported by the current Pipeline model or MCP tools

Common prompts

Discover Pipelines and stages

List all active Pipelines in Peach. Include each Pipeline's ID, friendly item label, and lifecycle settings.

Show me the stages in the Customer Support pipeline in their current order. Explain which ones are Open, Won, and Lost.

List up to 50 active tickets in the Waiting for customer stage. Include the contact, assignee, days in stage, and drop-off indicator.

Create a Pipeline

Create a Pipeline called Partner Onboarding. Call its items Partner and Partners. Use PARTNER as the item ID prefix. Then add these stages in order: New as Open, Verification as Open, Training as Open, Live as Won, and Cancelled as Lost. Show me the final structure before doing anything else.

A newly created Pipeline is empty. Creating stages is a separate set of operations, so ask the assistant to return the completed structure and report any stage it could not create.

Update Pipeline details

Rename the Sales Leads pipeline to Enterprise Sales. Change the friendly item labels to Opportunity and Opportunities. Do not change its stages.

Enable re-enrollment for the Renewals pipeline so a customer can start a new journey after reaching Won, Lost, or Dropped off. Explain what will happen to the earlier item.

Configure the Collections pipeline so a dropped-off item moves to its Lost stage.

Enroll a contact

Add Priya Shah, phone number +91 90000 00000, to the Sales pipeline. Use the first open stage. Do not send a WhatsApp message.

Enroll Ahmed Hassan, phone number +971 50 000 0000, into the Qualified stage of Enterprise Sales and assign the item to user usr_…. Confirm the Pipeline and stage before enrolling.

If the phone number already belongs to a Peach contact, Peach uses that contact. Otherwise, Peach creates one. Enrollment through MCP does not send a message.

Only one active item is allowed for a contact in the same Pipeline. If re-enrollment is enabled and the earlier item is terminal or dropped off, Peach archives the earlier journey and creates a new one.

Find and move an item

Find the active Sales pipeline item for Acme Ltd. Show its current stage and readable item ID. Do not change it.

Move Acme Ltd from Contacted to Demo Scheduled. Verify the destination stage belongs to the same Pipeline and report the resulting stage.

Show all active items in Demo Scheduled that have been there for at least seven days. Do not modify them.

The assistant should list items first when a name could match more than one contact. Peach MCP moves items using the item's pli_… ID and destination stg_… ID rather than guessing from names.

Update an item's title or assignee

Find the active item for Northwind Traders in Enterprise Sales and change its title to “Northwind — annual renewal”.

Assign item pli_… to user usr_…. Show the updated assignee.

The current MCP tool accepts only a title and assignee for item updates. Supply a Peach user ID when assigning; do not ask the assistant to invent one.

Manage stages

Add a stage named Security Review after Demo Scheduled in Enterprise Sales. Make it an Open stage with color #6366f1.

Rename the stage “Closed Won” to “Contract Signed” and keep its type as Won.

Reorder the Support stages to: New, In progress, Waiting for customer, Resolved, Closed. First show me the current and proposed order, then wait for confirmation.

Delete the Deprecated stage from the Support pipeline. First confirm that it contains no active items.

Deleting a stage fails while it still contains items or is otherwise referenced. Move its items and remove relevant rules before trying again.

Configure At risk and Dropped off behavior

In the Negotiation stage, flag leads At risk after 48 hours without activity and mark them Dropped off after 168 hours without activity. Measure inactivity from the last activity and record “No progress in negotiation” as the drop-off reason.

In Waiting for customer, measure inactivity from our last outbound message. Flag tickets At risk after 72 hours and Dropped off after 168 hours.

Supported inactivity clocks are:

last_activity_at

entered_stage_at

last_outbound_message_at

Drop-off evaluation runs approximately every 15 minutes. Configuring a threshold does not immediately recalculate every item at the moment the MCP call finishes.

Attach automations to stage lifecycle events

List my Peach automations and find the one called Send demo preparation message. Attach it to the Demo Scheduled stage so it runs when a lead enters that stage. Do not replace any existing stage automations without showing them first.

Attach automation strm_… to the Lost stage's drop-off event. Preserve the stage's existing entry and exit automations.

Stage lifecycle configuration accepts automation or Stream IDs beginning with strm_…. The MCP update replaces any lifecycle list that it supplies, so the assistant should read the current stage configuration and include existing IDs that must be preserved.

For event-driven behavior such as “enroll when a message arrives” or “move when a template is delivered,” ask the assistant to create or update a Peach automation rather than expecting the stage tools to listen for those events themselves.

Recommended prompts for recurring work

Morning pipeline review

Review the Sales pipeline without making changes. Group active leads by stage, identify unassigned items, and highlight items marked At risk or Dropped off. Include days in stage and readable item IDs.

Stale-stage review

List active items in each open stage of Customer Support. Highlight anything that has spent seven or more days in its current stage. Do not move or message anyone.

Safe bulk movement

Find leads in Qualified that match [your criteria]. Return a numbered preview with contact, item ID, current stage, and proposed destination. Wait for my confirmation before moving any item.

Configuration audit

Audit the Sales pipeline configuration without changing it. Report stage order and type, re-enrollment settings, drop-off thresholds, inactivity basis, and stage lifecycle automations. Flag missing Won or Lost stages.

Prompt-writing tips

Name the Pipeline and stage clearly.

Include a phone number when enrolling a contact.

Say do not make changes when you want a report or preview.

Ask the assistant to wait for confirmation before bulk moves, deletion, or reordering.

Ask for item, Pipeline, and stage IDs in the result when you may continue the task later.

State whether existing lifecycle automations must be preserved.

Never ask the assistant to guess an ID when two records have similar names.

Understand IDs returned by MCP

Object	ID format	Example purpose
Pipeline	pipe_…	Select the Pipeline to inspect or change.
Stage	stg_…	Select a starting or destination stage.
Pipeline item	pli_…	Move or update one contact's journey.
Readable item ID	Such as ACM-SALES-42	Refer to an item in conversations with your team.
User	usr_…	Assign an item to a Peach user.
Automation / Stream	strm_…	Attach an automation to a stage lifecycle event.

Always use IDs returned by Peach. IDs belong to one account, and stage IDs belong to one Pipeline.

Troubleshooting

The Pipeline tools do not appear

Confirm that Pipelines is enabled for the Peach account, reconnect the Peach MCP server, and ask the client to refresh its tool list.

Peach says Pipeline or stage not found

Ask the assistant to list Pipelines again, then retrieve the selected Pipeline and its stages. The Pipeline may have been archived, the stage may have been removed, or an ID may belong to another Pipeline.

Enrollment returned an existing item

The contact already has an active journey in that Pipeline. Ask the assistant to show the existing item. A duplicate active item is not created.

A stage cannot be deleted

It still contains items or is referenced by configuration. List the stage's items, move them deliberately, review connected rules, and try again.

An item does not appear in a list

The list tool returns active items and accepts a maximum of 100 results per request. Narrow the request by stage, or ask for the most recently updated items. Archived prior journeys are not included.

The assistant cannot show Pipeline analytics

The current Pipeline MCP tools manage Pipeline structure and active items; they do not expose the Pipeline Analytics reports. Open the Pipeline's Analytics tab in Peach for Overview, Funnel, Response Times, Productivity, Dispositions, Conversions, and Velocity.

Current Pipeline MCP tool reference

MCP tool	Purpose
peach_list_pipelines	List active Pipelines.
peach_get_pipeline	Retrieve one Pipeline and its ordered stages.
peach_create_pipeline	Create an empty Pipeline.
peach_update_pipeline	Update details and supported lifecycle settings.
peach_list_pipeline_items	List active items, optionally filtered by stage or automation status.
peach_enroll_contact_in_pipeline	Find or create a contact and enroll it without sending a message.
peach_move_pipeline_item	Move an active item to another stage.
peach_update_pipeline_item	Update an item's title or assignee.
peach_create_pipeline_stage	Add a stage.
peach_update_pipeline_stage	Rename, recolor, or change a stage type.
peach_reorder_pipeline_stages	Set the complete stage order.
peach_delete_pipeline_stage	Delete an unused stage.
peach_configure_stage_dropoff	Update At-risk and drop-off settings.
peach_configure_stage_playbooks	Attach automations to stage entry, exit, or drop-off.