How to Use the MessageFlow MCP in Mastra AI

Q: Is it possible to require human approval for MessageFlow actions in Mastra AI?

Absolutely. Use the requireToolApproval setting in your Mastra AI agent definition to force a human review before any outgoing message is actually sent.

Build resilient message workflows in Mastra AI with automatic retries and conditional logic powered by MessageFlow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MessageFlow MCP to Mastra AI

Create your Vinkius account to connect MessageFlow 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 MessageFlow with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated messaging workflows

Chain together `list_channels` and `send_whatsapp` within your agent workflows. If a message fails, the framework handles the retry logic automatically. Build complex sequences that check your `get_account_balance` before firing off high-volume notifications. You get a reliable pipeline that handles edge cases without manual intervention.

Conditional message routing

Use the output of `list_messages` to inform your agent's next move. If a message isn't delivered, the agent can switch to a different channel using `send_sms`. Define your logic in code and let the agent navigate the decision tree. It's a clean way to manage multi-step communication processes that require human-in-the-loop approval.

Stateful message management

Keep track of your entire communication history using `list_messages`. The agent can review past interactions to inform current responses. Query specific templates with `get_template` to ensure your automated replies stay on brand. Every action is logged and retrievable, giving you a full audit trail for your operations.

Setup guide

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

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

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

Add the server to your agent's configuration file using the endpoint provided. Mastra AI will auto-detect the tools and make them available to your agent's memory.

Yes, you can configure your Mastra AI workflow to catch errors from `send_email` or `send_whatsapp` and trigger a retry policy based on the error code.

Absolutely. Use the `requireToolApproval` setting in your Mastra AI agent definition to force a human review before any outgoing message is actually sent.

It does. You can write logic that branches based on the result of `get_delivery_status`, allowing your agent to take different paths if a message is blocked.

Your message logs and contact details are isolated within the Vinkius sandbox. Access is restricted to your authenticated agent, ensuring your messaging history remains private.

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