@pushengage/mcp

Manage your PushEngage account from any AI assistant, in plain language.

PushEngage is a push notification platform for web push, mobile app push, WhatsApp, and on-site chat widgets, used to grow subscribers and recover revenue (cart abandonment, price drops, back-in-stock, and more).

This package is a Model Context Protocol (MCP) server. It connects MCP-capable assistants such as Claude Desktop, Claude Code, and Cursor to your PushEngage account so you can send and schedule notifications, run A/B tests, build audiences, inspect analytics, and manage site settings just by asking, without leaving your chat.

You log in once through your browser; the assistant then acts on your behalf against whichever PushEngage site you select.

Contents

• What you can do
• Requirements
• Install
• First run: logging in
• Tools
• Configuration
• Security and token storage
• Troubleshooting
• License

What you can do

Once connected, just describe what you want. A few examples:

Send and schedule

• "Send a notification titled 'Sale ends tonight', message 'Last call, 50% off', linking to https://example.com/sale."
• "Schedule that for 9 AM in each subscriber's local timezone."
• "Set up a recurring digest every Monday and Thursday at 8 AM through the end of the month."
• "Run an A/B test of two headlines and auto-roll-out the winner by click rate."

Target the right people

• "Create a segment for visitors of /pricing."
• "Build an audience of gold-plan customers in the US and send only to them."

Understand performance

• "How many subscribers do I have, and what was my click rate over the last 30 days?"
• "List my active drip campaigns with their sent, seen, and clicked stats."

Configure a site

• "Set my default notification expiry to 7 days."
• "Change my site timezone to Asia/Kolkata and turn on geolocation."

Requirements

• A PushEngage account (free or paid) with at least one site.
• Node.js 18 or newer (the assistant runs the server via npx).
• An MCP-capable client (Claude Desktop, Claude Code, Cursor, or any other).

Install

Add the server to your client's MCP config. No global install is needed; npx fetches it on demand.

Claude Desktop (one-click bundle)

The easiest path on Claude Desktop is the MCP Bundle:

1. Download the latest pushengage-mcp-<version>.mcpb file from the GitHub releases page.
2. Open it with Claude Desktop (double-click it, or drag it onto the window) and click Install.

Everything is bundled — no JSON editing needed. The install dialog optionally lets you set the label shown on the PushEngage authorize screen and a custom token file path (for running multiple accounts).

Claude Desktop (manual config)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Restart Claude Desktop. The "pushengage" server should appear in your tool list.

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Other MCP clients

Any client that speaks MCP over stdio works. Configure it to run the command npx -y @pushengage/mcp.

First run: logging in

Authentication is browser-based, so your credentials never touch the assistant.

1. As

... View full README on GitHub