How to Use the Helpwise MCP in Mastra AI

Q: How do I register Helpwise MCP Server tools in a Mastra AI agent?

Install @mastra/mcp@latest and initialize the MCPClient with your Vinkius server URL. Use mcpClient.listTools() and spread the returned tools directly into your Mastra agent definition.

Q: Can I require human approval before Mastra AI sends a Helpwise email?

Yes, you can configure requireToolApproval on the sendemail tool. This forces the workflow to pause and wait for a human operator to review the draft before it goes out.

Q: Can I branch my workflow based on mailbox names?

Yes, run listmailboxes to get the list of active inboxes. Your Mastra workflow can then use conditional logic to route incoming SMS, WhatsApp, or email messages to different queues.

Build reliable support workflows using Mastra AI to automate Helpwise inbox routing and agent assignments.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Helpwise MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-assign threads with Mastra AI and Helpwise

The `list_conversations` tool retrieves unassigned threads from your shared inbox so your workflow can process them. Mastra AI evaluates the content of these messages and determines which team member is best suited to handle the issue. After identifying the right agent, the workflow uses `list_team_members` to check their availability. The system then assigns the ticket, preventing customer inquiries from sitting unaddressed in a generic queue.

Send emails with built-in retry logic

The `send_email` tool sends messages to customers, and Mastra AI wraps this action in a resilient workflow. If the API rate limit is reached, this MCP Server automatically retries the send operation with exponential backoff. If the email repeatedly fails, the workflow uses conditional branching to notify your team. This ensures no critical customer communication is lost due to temporary network blips or API downtime.

Sync CRM data with the Helpwise MCP Server

The `create_contact` tool updates your support directory whenever a new lead interacts with your system. Mastra AI triggers this tool automatically as part of your post-purchase or onboarding workflows. Before creating a profile, the agent runs `list_contacts` to check for existing records. This prevents duplicate entries and keeps your contact database clean across all your support channels.

Setup guide

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

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

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

Install `@mastra/mcp@latest` and initialize the `MCPClient` with your Vinkius server URL. Use `mcpClient.listTools()` and spread the returned tools directly into your Mastra agent definition.

Yes, you can configure `requireToolApproval` on the `send_email` tool. This forces the workflow to pause and wait for a human operator to review the draft before it goes out.

You can configure the built-in workflow engine to queue calls to the MCP Server. This prevents your agents from hitting the Helpwise API rate limit during peak support hours.

Yes, run `list_mailboxes` to get the list of active inboxes. Your Mastra workflow can then use conditional logic to route incoming SMS, WhatsApp, or email messages to different queues.

Your contact names, email addresses, and phone numbers are processed entirely in memory within an ephemeral, zero-trust MCP Server sandbox. Vinkius does not store your customer profiles or message 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