How to Use the MagicBell MCP in Mastra AI

Q: Can a Mastra AI workflow automatically retry a failed MagicBell broadcast?

Yes. If createbroadcast fails due to a rate limit or API hiccup, Mastra AI uses its built-in workflow engine to retry the step automatically using exponential backoff.

Q: How does Mastra AI handle the JSON payloads returned by this MCP Server?

The framework automatically parses the JSON responses from listbroadcasts and getbroadcast, making the structured notification data immediately available for downstream workflow steps.

Build resilient, self-healing notification workflows with Mastra AI and MagicBell.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MagicBell MCP to Mastra AI

Create your Vinkius account to connect MagicBell to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup MagicBell with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate multi-channel alerts in workflows

The `create_broadcast` tool acts as the execution step for dispatching alerts inside your workflow pipelines. When a step in your Mastra AI agent fails or succeeds, it triggers this tool to notify the right team members immediately. Since the framework supports automatic retries with exponential backoff, temporary network blips won't stop your notifications. If the dispatch fails, the system automatically retries the call until it succeeds.

Audit notification pipelines programmatically

The `list_broadcasts` tool retrieves the complete run history of your notification campaigns. Mastra AI agents use this data to inspect previous runs and decide whether to trigger follow-up alerts. By integrating this MCP Server with your workflow engine, you can build conditional logic that checks if a specific alert was already sent. This prevents spamming users with duplicate messages.

Check delivery status inside Mastra AI agents

The `get_broadcast` tool pulls down the exact delivery status and recipient metrics for any specific notification ID. Your agent uses this tool to monitor critical system alerts and trigger escalations if a broadcast fails. This MCP Server integration allows your workflows to react to real-world delivery data. If a critical message remains undelivered, your agent can automatically route the alert to an alternative channel.

Setup guide

Set up MagicBell 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 MagicBell 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: "magicbell-mcp-client",
  servers: {
    "magicbell-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent MagicBell 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 MagicBell. 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 MagicBell 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 MagicBell MCP in Mastra AI

Install the Mastra MCP package and initialize the client with your Vinkius endpoint. You can then register the tools directly into your Mastra AI agent configuration in just a few lines of code.

Yes. If `create_broadcast` fails due to a rate limit or API hiccup, Mastra AI uses its built-in workflow engine to retry the step automatically using exponential backoff.

Yes. You can configure Mastra AI to pause the workflow and require manual approval before executing `create_broadcast`, keeping you in control of major announcements.

The framework automatically parses the JSON responses from `list_broadcasts` and `get_broadcast`, making the structured notification data immediately available for downstream workflow steps.

The server processes recipient email addresses and notification content entirely in memory within a zero-trust V8 isolate. No payload data is ever written to persistent disk during execution.

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