MCP
12 min
peach mcp lets chatgpt, claude, cursor, claude code, and other mcp compatible ai clients work with your peach account depending on your peach product and permissions, your ai client can search whatsapp conversations, find contacts, draft and send replies, manage pipelines, configure automations, inspect events, and operate ai agents mcp server url use this url when adding peach as a custom mcp server or connector https //app trypeach ai/api/mcp the url is the same for chatgpt, claude, cursor, claude code, and other remote http mcp clients that support oauth before you connect make sure you have a peach account with copilot or peach core enabled permission to connect third party ai clients to the account an mcp compatible client such as chatgpt, claude, cursor, claude code, or another remote http mcp client access to peach in the browser when your ai client opens the authorization flow setup open your ai client's connector or mcp settings add peach as a custom mcp server paste the mcp server url https //app trypeach ai/api/mcp follow the peach authorization flow return to your ai client and refresh the available tools if needed ask a simple test question list the peach tools available to you and summarize what you can do typical setup locations client where to add peach chatgpt settings > connectors > add custom connector claude settings > connectors > add custom connector cursor settings > mcp > add new mcp server, or add peach to mcp json claude code add peach as a remote http mcp server other clients add a remote http mcp server that supports oauth with dynamic registration and pkce what you can do area example requests copilot find recent whatsapp messages, summarize conversations, draft replies, send replies inside the customer service window contacts search contacts, create contacts, update contact fields, inspect recent conversation history messaging send supported whatsapp messages, use approved templates, upload and reuse media pipelines create pipelines, manage stages, enroll contacts, move pipeline items, configure drop off rules automations create streams, attach triggers, test event payload mappings, debug recent events ai agents create and configure agents, connect tools, inspect test sessions and exchange logs integrations inspect incoming events and connect supported event driven workflows tools and capabilities the exact tool list can vary by peach product, account feature flags, oauth scopes, and ai client support use this table as a capability map your ai client may show fewer tools if a product area is not enabled for your account area capabilities mcp tools messaging send approved whatsapp templates, send test template messages, launch app or flow messages, inspect template message delivery events peach send template message , peach send test template message , peach send app message , peach list template messages , peach get event status conversations list conversations, read message history, read activity timelines, update conversation status, assign conversations, reply inside supported whatsapp windows peach list conversations , peach list messages , peach list activities , peach update conversation , peach assign conversation , peach reply to conversation contacts search contacts, create one contact, bulk create contacts, update profile fields and communication preferences peach search contacts , peach create contact , peach create contacts , peach update contact media list reusable media, upload media for replies or templates, delete uploaded media peach list media , peach upload media , peach delete media templates list, inspect, create, update, submit, pause, or archive whatsapp templates peach list templates , peach get template , peach create template , peach update template , peach submit template , peach pause template , peach archive template broadcasts launch template broadcasts, list campaigns, inspect a campaign, cancel or archive broadcasts peach launch broadcast , peach list broadcasts , peach get broadcast , peach cancel broadcast , peach archive broadcast pipelines create and update pipelines, manage stages, list active cards, enroll contacts, move items, update status and next actions, configure drop off behavior and stage playbooks peach list pipelines , peach get pipeline , peach create pipeline , peach update pipeline , peach list pipeline items , peach enroll contact in pipeline , peach move pipeline item , peach update pipeline item , peach create pipeline stage , peach update pipeline stage , peach reorder pipeline stages , peach delete pipeline stage , peach configure stage dropoff , peach configure stage playbooks automations list and inspect streams, create or update automation definitions, create or update triggers, list event conditions, test triggers, run an automation for a test contact peach list automations , peach get automation , peach create automation , peach update automation , peach trigger automation , peach list expressions , peach list triggers , peach create trigger , peach update trigger , peach evaluate trigger condition ai agents list, inspect, create, and update ai agents; connect contacts to agents; manage instructions, goals, tools, test sessions, transcripts, exchange logs, and knowledge documents peach list ai agents , peach get ai agent , peach create ai agent , peach update ai agent , peach connect to ai agent , peach update ai agent instructions , peach configure agent tools , peach configure agent goals , peach list ai agent sessions , peach list test sessions , peach start test session , peach send test message , peach get ai agent transcript , peach list ai agent exchange logs , peach get exchange log , peach list knowledge bases , peach upload knowledge base document , peach delete knowledge base document events and integrations search recent events, inspect event processing status, manage shopify webhook topic subscriptions when shopify is connected peach search events , peach get event status , peach list shopify webhook topics , peach list shopify webhook subscriptions , peach create shopify webhook subscription , peach delete shopify webhook subscription setup and account status check onboarding and account setup state, inspect phone setup, list connected coexistence numbers, create or rotate guest setup links peach get onboarding status , peach get account setup , peach get phone setup status , peach list coexistence numbers , peach create setup guest link , peach expire setup guest link , peach regenerate setup guest link admin diagnostic tools exist for peach support and internal operators they are not part of the standard customer facing mcp capability set recommended first prompts find my latest whatsapp business messages and summarize which customers need a reply find the last conversation with maria and draft a friendly follow up show my active pipelines, their stages, and any contacts that look stuck create a draft automation that sends a follow up message when a new qualified lead enters my sales pipeline important limits mcp access is scoped to the authenticated peach account some tools depend on product capabilities a copilot account and a peach core account may expose different tools free form whatsapp replies depend on the whatsapp customer service window outside that window, whatsapp may require an approved template mcp cannot approve whatsapp templates meta controls template approval mcp cannot mint api tokens or enumerate every internal team setting when a value is unavailable through mcp, use the peach ui or ask an account admin automations usually need both an action stream and a trigger creating an automation definition alone does not mean it will run some clients need you to reconnect peach or refresh their tool list after new tools are added troubleshooting issue what to try the client cannot connect confirm the url is https //app trypeach ai/api/mcp and that the client supports remote http mcp with oauth authorization does not finish sign in to peach in the same browser, then reconnect from the ai client tools do not appear reconnect peach, refresh the client tool list, or start a new chat in the ai client a tool says a feature is not enabled confirm the account has the relevant peach product or feature enabled a message cannot be sent check whether the conversation is inside whatsapp's customer service window or use an approved template an automation does nothing check the trigger, condition, recipient mapping, and recent incoming event payload pipeline tools are missing confirm pipelines are enabled for the account recent whatsapp history is missing check whether chat history sharing was approved during copilot setup related guides use peach copilot with chatgpt or claude docid 5wt0vlpvifoueqt0cjc7p connect your whatsapp business app to peach copilot docid\ xhbrgromw l3uiz 3v6ml manage pipelines with mcp # manage automations via mcp #