Skip to main content

Build with AI Agents

PushEngage ships two official tools for AI agents, one for operating your account and one for integrating our SDK into your app:

  • MCP Server: a Model Context Protocol server that connects assistants such as Claude Desktop, Claude Code, and Cursor to your PushEngage account. Send and schedule notifications, run A/B tests, build audiences, inspect analytics, and manage site settings just by asking.
  • Agent Skills: a skill pack that teaches AI coding agents to integrate and debug the PushEngage Mobile SDK across iOS, Android, Flutter, and React Native apps.

They work great together: install the Agent Skills plugin in Claude Code and the MCP server is configured for you automatically.

MCP Server​

The @pushengage/mcp server lets you manage your PushEngage account from any MCP-capable assistant, in plain language. Once connected, just describe what you want:

  • "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."
  • "Run an A/B test of two headlines and auto-roll-out the winner by click rate."
  • "Create a segment for visitors of /pricing."
  • "How many subscribers do I have, and what was my click rate over the last 30 days?"
  • "Set my default notification expiry to 7 days."

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 such as Claude Desktop, Claude Code, Cursor, or any other client that speaks MCP over stdio.

Install​

The easiest path is the one-click 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.

Prefer manual config? Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your platform, then restart Claude Desktop:

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

First run: logging in​

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

  1. Ask: "Log me into PushEngage." The server opens a browser tab to the PushEngage authorize page.
  2. Click Authorize. The tab confirms success and an access token is saved locally with 0600 permissions.
  3. Ask: "Show my PushEngage sites," then "Use site 12345" to pick the site to work with. The selection is remembered across restarts.

Available tools​

The server exposes tools across the whole platform:

AreaWhat you can do
Authentication & sitesLog in and out, list your sites, select the site to work with.
Sending notificationsList, send, and schedule notifications: one-shot, per-subscriber timezone, recurring, and A/B tests.
AudiencesCreate and list segments, audience groups, and custom subscriber attributes.
Campaigns & automationsInspect drip autoresponders, triggered campaigns, RSS auto push, and workflows, with analytics.
AnalyticsLifetime totals and per-day/week/month timeseries for subscribers, sends, views, clicks, and CTR.
Site settingsSite details, campaign defaults, and service worker settings.

For the full tool reference, configuration options, and troubleshooting, see the pushengage-mcp README.

Agent Skills​

PushEngage Agent Skills help an AI coding agent integrate and debug the PushEngage push-notification SDK in your app. The skills follow two open standards: the Agent Skills (SKILL.md) standard and the Agent Plugins format, so they work with any agent that supports either one, including Claude Code, Cursor, Codex, Copilot, Windsurf, VS Code, and others.

The pack contains six skills:

SkillPurpose
pushengageEntry skill that detects your platform and routes to the right one.
pushengage-iosiOS integration and debugging.
pushengage-androidAndroid integration and debugging.
pushengage-flutterFlutter integration and debugging.
pushengage-react-nativeReact Native integration and debugging.
pushengage-debugShared diagnostic skill for broken integrations.

Install​

Install as a plugin:

/plugin marketplace add awesomemotive/pushengage-skills
/plugin install pushengage

Installing the plugin also configures the official MCP server, so the agent can operate your PushEngage account too.

Usage​

After installing, just talk to your agent:

  • "Help me integrate PushEngage into this app." runs the full integration flow.
  • "PushEngage notifications aren't arriving on my iPhone." runs the diagnostic flow.
  • "Audit my PushEngage setup." runs the static audit.

The plugin detects your platform automatically and hands off to the matching integration or debug skill. Prefer to follow the steps yourself? Head to the Mobile SDK docs.

Docs for Your Agent​

This documentation is built to be read by AI agents as well as humans:

  • Every page has a markdown version. Append .md to any page URL (for example, /api/ai-agents.md), or use the Copy as markdown button at the top of each page.
  • llms.txt is an index of every page with links to the markdown versions.
  • llms-full.txt contains the entire documentation in a single file, ready to drop into an agent's context.

To onboard an agent, paste a prompt like this:

Read https://www.pushengage.com/api/ai-agents.md and set up the PushEngage
MCP server and Agent Skills in this project.

Resources​

Last updated on