Novu MCP Server for Mastra AIGive Mastra AI instant access to 39 tools to Bulk Update Subscriber Preferences, Cancel Trigger, Check Topic Subscriber, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Novu through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Novu MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 39 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"novu": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Novu Agent",
instructions:
"You help users interact with Novu " +
"using 39 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Novu?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Novu MCP Server
Connect your Novu account to any AI agent and take full control of your notification infrastructure through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Novu tool infrastructure. Connect 39 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Triggering & Events — Trigger single, bulk, or broadcast notifications across Email, SMS, Push, and Chat using workflow identifiers.
- Subscriber Management — Create, retrieve, update, and search for subscribers to maintain an up-to-date communication database.
- Preference Controls — Inspect and update subscriber-specific notification preferences to ensure compliance and user satisfaction.
- Workflow Cancellation — Cancel active or pending workflows, such as digests or delayed notifications, using transaction IDs.
- Tenant Context — Manage notifications within specific tenant contexts for multi-tenant applications.
The Novu MCP Server exposes 39 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 39 Novu tools available for Mastra AI
When Mastra AI connects to Novu through Vinkius, your AI agent gets direct access to every tool listed below — spanning notification-infrastructure, multi-channel, subscriber-management, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Bulk update subscriber preferences on Novu
Bulk update subscriber preferences
Cancel trigger on Novu
Cancel active or pending workflows (e.g., digests, delays)
Check topic subscriber on Novu
Check if a subscriber is subscribed to a topic
Create environment variable on Novu
Create an environment variable
Create integration on Novu
Create a new integration
Create layout on Novu
Create a new layout
Create subscriber on Novu
Create a new subscriber
Create topic on Novu
Create a new topic
Create topic subscriptions on Novu
Create subscriptions for a topic
Create workflow on Novu
Create a new workflow
Delete integration on Novu
Delete an integration
Delete message on Novu
Delete a message
Delete messages by transaction on Novu
Delete messages by transaction ID
Delete subscriber on Novu
Delete a subscriber
Delete subscriber credentials on Novu
Delete subscriber credentials
Delete topic on Novu
Delete a topic
Delete topic subscriptions on Novu
Delete subscriptions from a topic
Get environment variable usage on Novu
Retrieve usage of an environment variable
Get subscriber on Novu
Retrieve a subscriber by ID
Get subscriber preferences on Novu
Retrieve subscriber preferences
Get topic on Novu
Retrieve a topic by key
Get topic subscription on Novu
Retrieve a topic subscription
List active integrations on Novu
List active integrations
List environment variables on Novu
List all environment variables
List integrations on Novu
List all integrations
List messages on Novu
List messages
List topic subscriptions on Novu
List subscriptions for a topic
Search subscribers on Novu
Search for subscribers
Set primary integration on Novu
Set an integration as primary
Trigger broadcast on Novu
Send a notification to all existing subscribers
Trigger bulk event on Novu
Trigger multiple events in a single request
Trigger event on Novu
Trigger a notification to one or more subscribers
Update environment variable on Novu
Update an environment variable
Update integration on Novu
Update an integration
Update subscriber on Novu
Update an existing subscriber
Update subscriber credentials on Novu
Update subscriber credentials
Update subscriber preference on Novu
Update a subscriber preference
Update topic on Novu
Update a topic
Upsert subscriber credentials on Novu
Upsert subscriber credentials
Connect Novu to Mastra AI via MCP
Follow these steps to wire Novu into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Novu MCP Server
Mastra AI provides unique advantages when paired with Novu through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Novu without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Novu tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Novu + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Novu MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Novu, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Novu as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Novu on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Novu tools alongside other MCP servers
Example Prompts for Novu in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Novu immediately.
"Trigger the 'welcome-onboarding' workflow for subscriber 'user_99' with the payload { "name": "Alice" }."
"Search for a subscriber with the email 'support@example.com'."
"Cancel the notification trigger with transaction ID 'tx_abc123'."
Troubleshooting Novu MCP Server with Mastra AI
Common issues when connecting Novu to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpNovu + Mastra AI FAQ
Common questions about integrating Novu MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
CoinPaprika API
10 toolsAccess cryptocurrency data — audit coins, markets, and exchanges via AI.
Geekflare
7 toolsTest your website performance, security headers, and DNS configuration with a comprehensive suite of technical audit tools.
U.S. Treasury Full — Complete Fiscal & Debt Intelligence
13 toolsThe definitive U.S. Treasury Mega-Server: 13 tools covering national debt ($34T+), interest rates, auction results, federal budget accounting (revenue, spending, deficit), daily cash balances, and official exchange rates. Total access to the financial pulse of the U.S. government without API keys.
BreezoMeter Air Quality & Pollen
2 toolsUniversal air quality intelligence — get real-time AQI, pollutants, and pollen data via AI.