# PushEngage MCP > PushEngage MCP Server connects your AI agent directly to your web push notification data. Use this server to manage campaigns, analyze subscriber segments, trigger broadcasts, and monitor automation workflows—all through natural conversation. You can check API status, list notifications, segment subscribers, or send immediate broadcasts without leaving your chat client. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** web-push, browser-notifications, subscriber-segmentation, cart-recovery, outreach-orchestration ## Description **PushEngage MCP Server connects your AI agent directly to your entire web push notification stack.** You'll use this server to manage campaigns, analyze subscriber segments, trigger broadcasts, and monitor automation workflows—all through natural conversation. It lets your agent check the API status to verify that your PushEngage connection is active; it also provides a comprehensive list of all websites registered with your account. When you need to understand who you're talking to, your AI client can retrieve detailed profiles and activity history for every push subscriber; you can also get a full directory of defined subscriber segments to help you pinpoint exactly which groups need targeted outreach. If you gotta see what kind of content you've pushed before, the agent retrieves a complete list of all past and current push notifications along with their performance metadata. For campaign management, it gives you visibility into your site's automation triggers; you can list out every active workflow and trigger configured on your site programmatically. You'll also access a full listing of any existing push notifications created for your account to review historical actions. When it's time to send something, the agent lets you trigger an immediate push broadcast directly to a specific segment or a defined list of subscribers in one go. This server turns those complex marketing dashboards into simple conversation queries; you don't gotta manually draft anything—your AI acts like your dedicated push coordinator and outreach architect. ## Tools ### send_pushengage_broadcast Triggers an immediate push broadcast to a specific segment or list of subscribers. ### list_pushengage_notifications Retrieves a list of all push notifications created for your account. ### list_pushengage_segments Lists and retrieves details about the defined subscriber segments. ### list_pushengage_sites Provides a list of all websites registered with your PushEngage account. ### check_pushengage_status Checks if the PushEngage API connection is active and working. ### list_pushengage_subscribers Retrieves detailed profiles and activity history for push subscribers. ### list_pushengage_triggers Lists the active automation workflows and triggers configured on your site. ## Prompt Examples **Prompt:** ``` List all active push segments and show their subscriber count. ``` **Response:** ``` I've retrieved your segments. You currently have 5 active high-fidelity profiles, including 'Blog Readers' (Subscribers: 1,200) and 'UK Audience'. Would you like the detailed performance metadata for any of them? ``` **Prompt:** ``` Show the last 5 broadcasts and their click rates. ``` **Response:** ``` Outreach orchestrated! I've identified 5 recent high-fidelity push broadcasts, including 'New Product Launch' (Click Rate: 4.5%). I've retrieved the technical delivery and engagement metadata for your review. Shall I summarize the campaign impact? ``` **Prompt:** ``` Check the available automation triggers for my site. ``` **Response:** ``` Automation directory orchestrated! Your site currently has 3 high-fidelity trigger profiles active, including 'Abandoned Cart' and 'Welcome Sequence'. Your API connection is healthy. Shall I retrieve the detailed orchestration metadata for these workflows? ``` ## Capabilities ### Monitor System Health Check the API status to verify that your PushEngage connection is active. ### View Notification History List all past and current push notifications and view their performance metadata. ### Analyze Audience Segments Access your complete directory of subscriber segments to understand which groups need targeted outreach. ### Manage Subscriber Data List and analyze individual push subscribers and their activity history directly through your agent. ### Trigger Campaigns Send immediate, high-fidelity push broadcasts to specific audience segments in a single command. ### Review Automation Workflows Access and manage your automation triggers and workflow settings programmatically. ## Use Cases ### Recuperating Lost Customers A customer service lead notices engagement is dropping. They ask their agent: 'Show me the segments of users who haven't logged in for 30 days.' The agent runs `list_pushengage_segments` and then uses `send_pushengage_broadcast` to blast a win-back coupon only to that specific, highly defined group. ### Checking Campaign Readiness An operations manager needs to launch an emergency sale. They first use `check_pushengage_status` to confirm the API connection is live. Next, they check `list_pushengage_triggers` to make sure the cart recovery automation isn't already running, then they execute a new blast via `send_pushengage_broadcast`. ### Deep Dive into Audience Behavior A growth marketer wants to know who is responding best. They use `list_pushengage_subscribers` to pull the most active 100 users, analyze their activity history via the agent, and determine if a niche segment needs a completely different type of push notification. ### Auditing Marketing Setup A manager wants an overview. They ask the agent to list all registered sites (`list_pushengage_sites`) and then pull a report on all existing notifications (`list_pushengage_notifications`), getting a full, programmatic audit of their entire push ecosystem. ## Benefits - You get real-time campaign analytics instantly. Instead of logging into a dashboard, you ask your agent to show the last 5 broadcasts and their click rates using `list_pushengage_notifications`. - Targeting becomes precise. You don't guess who needs an offer; you use `list_pushengage_segments` to pull exact directories of subscribers (like 'Abandoned Cart') for perfect outreach. - Automation monitoring is simple. Need to know if your welcome sequence broke? Use `list_pushengage_triggers` to check the workflow status and ensure everything runs right. - You control the message flow. The `send_pushengage_broadcast` tool lets you trigger a campaign immediately, sending notifications without drafting or leaving your chat client. - Audience data is centralized. Use `list_pushengage_subscribers` to pull complete profiles and activity history for any user segment in one go. ## How It Works The bottom line is: Your AI handles the API calls so you don't have to click through multiple dashboards just to get data or run a campaign. 1. Subscribe to the server, then grab your API Key from your PushEngage dashboard (Settings > Site Settings > API Keys). 2. Connect your preferred AI client (Claude, Cursor, etc.) and authorize it with the MCP Server using the key. 3. Ask your agent a specific question—like 'List all segments for cart recovery'—and it executes the required tool call. ## Frequently Asked Questions **How do I find my PushEngage API Key?** Log in to your account, navigate to **Settings** > **Site Settings** > **API Keys**, and copy your unique high-fidelity **API Key**. **Can I check subscriber analytics via AI?** Yes! The `list_pushengage_subscribers` tool allows your agent to retrieve high-fidelity profile metadata and engagement history for your audience. **How do I list my subscriber segments?** Use the `list_pushengage_segments` tool to retrieve the complete high-fidelity directory of audience segments along with their unique identifiers. **When I run `send_pushengage_broadcast`, what format should my message payload be?** The broadcast function requires a structured JSON input. You must define the target segment ID and include the full notification payload. Your agent validates the structure before sending it out. **How do I troubleshoot an error after listing notifications using `list_pushengage_notifications`?** First, run `check_pushengage_status` to verify API connectivity. If that's fine, check the notification metadata for specific failure codes or service limits. **Does `list_pushengage_triggers` show me active and inactive automation workflows?** Yes, it shows all available trigger profiles along with their current status. Each profile details whether the associated event is live or paused for use. **If I manage multiple domains, how do I ensure `send_pushengage_broadcast` targets the right site?** You first run `list_pushengage_sites` to get all connected IDs. Then, you must specify the exact Site ID in your broadcast request payload. **How does my agent handle large datasets when calling `list_pushengage_subscribers`?** The API returns results in paginated batches. Your agent automatically detects the next page token and iterates through all records until the complete subscriber list is compiled.