How to Use the PushEngage MCP in Mastra AI

Q: How do I handle failed PushEngage broadcasts in Mastra AI?

Configure Mastra AI to watch the sendpushengagebroadcast tool output. If the API returns an error, the framework triggers an automatic retry loop before escalating to your admin channel.

Q: Can Mastra AI automatically segment PushEngage subscribers?

Yes. You can build a workflow that calls listpushengagesubscribers and listpushengagesegments. Mastra AI evaluates the lists and groups users based on your custom criteria.

Q: How do I register multiple PushEngage sites in Mastra AI?

Use the listpushengagesites tool within your agent definition. Mastra AI reads the registered domains from the MCP Server and lets you switch context between different web properties dynamically.

Q: How do I require human approval before sending a broadcast?

Set requireToolApproval to true on your Mastra AI agent. When the agent tries to run sendpushengagebroadcast, the workflow pauses until a human signs off on the notification text.

Automate push notifications with resilient Mastra AI workflows that retry failed PushEngage broadcasts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PushEngage MCP to Mastra AI

Create your Vinkius account to connect PushEngage to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup PushEngage with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Resilient push automation via Mastra AI MCP Server workflows

Build automated PushEngage campaigns that don't break when network glitches happen in your Mastra AI workflows. If a call to `send_pushengage_broadcast` fails, Mastra AI uses its built-in retry engine to try again with exponential backoff. You can chain this with other PushEngage tools to handle complex delivery flows. This MCP Server integration ensures your Mastra AI system retries the broadcast automatically without manual developer intervention.

Conditional subscriber segmentation

Route PushEngage notifications based on real-time subscriber lists within Mastra AI. Your agent calls `list_pushengage_subscribers` and `list_pushengage_segments` over the MCP connection to evaluate which users should receive a specific message. Mastra AI executes these PushEngage checks as sequential steps in a structured workflow. You can set Mastra AI rules to stop a run if PushEngage subscriber counts drop below a certain threshold, protecting your sender reputation.

Automated trigger validation

Verify your PushEngage automation setups before launching major campaigns in Mastra AI. The agent uses `list_pushengage_triggers` to audit active rules, checking them against your site settings from `list_pushengage_sites`. If the Mastra AI workflow detects a mismatch, it halts the PushEngage execution chain. This prevents broken campaigns from sending dead links to your active web audience.

Setup guide

Set up PushEngage MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All PushEngage tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "pushengage-mcp-client",
  servers: {
    "pushengage-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "PushEngage Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to PushEngage tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent PushEngage transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by PushEngage. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect PushEngage now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about PushEngage MCP in Mastra AI

Configure Mastra AI to watch the `send_pushengage_broadcast` tool output. If the API returns an error, the framework triggers an automatic retry loop before escalating to your admin channel.

Yes. You can build a workflow that calls `list_pushengage_subscribers` and `list_pushengage_segments`. Mastra AI evaluates the lists and groups users based on your custom criteria.

Use the `list_pushengage_sites` tool within your agent definition. Mastra AI reads the registered domains from the MCP Server and lets you switch context between different web properties dynamically.

Set `requireToolApproval` to true on your Mastra AI agent. When the agent tries to run `send_pushengage_broadcast`, the workflow pauses until a human signs off on the notification text.

Your API tokens and notification stats stay within Vinkius's zero-trust sandboxed runtime. No sensitive configuration data is exposed to the LLM or stored in local Mastra AI workflow state logs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript