Novu MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 39 tools to Bulk Update Subscriber Preferences, Cancel Trigger, Check Topic Subscriber, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Novu through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Novu MCP Server for OpenAI Agents SDK 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
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Novu Assistant",
instructions=(
"You help users interact with Novu. "
"You have access to 39 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Novu"
)
print(result.final_output)
asyncio.run(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.
The OpenAI Agents SDK auto-discovers all 39 tools from Novu through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Novu, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
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 OpenAI Agents SDK 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 OpenAI Agents SDK
When OpenAI Agents SDK 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 OpenAI Agents SDK via MCP
Follow these steps to wire Novu into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Novu MCP Server
OpenAI Agents SDK provides unique advantages when paired with Novu through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Novu + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Novu MCP Server delivers measurable value.
Automated workflows: build agents that query Novu, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Novu, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Novu tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Novu to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Novu in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK
Common issues when connecting Novu to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Novu + OpenAI Agents SDK FAQ
Common questions about integrating Novu MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
United Airlines
12 toolsTrack United Airlines flights, schedules, routes, delays, and fleet data in real-time via AI agents.

WordPress SEO Metadata Updater
1 toolsThis MCP does exactly one thing: it rewrites the SEO title, meta description, and focus keyword of an existing WordPress post. Works with both Yoast SEO and RankMath automatically. Incredible for turning Claude into an SEO analyst that fixes your blog rankings while you sleep.

Vimeo
10 toolsManage your Vimeo account — audit videos, folders, and showcases via AI.

Amazon CloudWatch Log Group
1 toolsThis MCP does exactly one thing: it queries logs from a single CloudWatch Log Group. That's its only function, and nothing else. Incredible for giving your AI secure observability.
