How to Use the CHATFLY MCP in Mastra AI

Q: How do I register CHATFLY tools inside a Mastra AI agent?

Instantiate the client using new MCPClient with the Vinkius endpoint URL. Call mcpClient.listTools() to get the tools, then spread them directly into your Mastra agent's tool array so it can run actions like listchatflybots.

Q: How is my CHATFLY account info and document list secured in Mastra AI?

Your credentials and files retrieved via listuploadeddocuments are shielded by Vinkius's ephemeral V8 sandboxes. No support documents or account metadata are stored on our servers, ensuring your proprietary training data remains fully private.

Automate resilient customer support workflows with Mastra AI and CHATFLY.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CHATFLY MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build self-healing support workflows with Mastra AI

The `send_bot_message` tool integrates with Mastra workflows to send customer queries and handle API retries automatically. This MCP Server gives your agents the power to recover from rate limits without breaking the customer's experience. If a bot fails to respond, Mastra's engine branches the logic to notify a human agent while pulling the recent logs with `get_conversation_history`. You get a production-ready support system that handles API hiccups on its own.

Automate CHATFLY bot training pipelines in Mastra AI

The `trigger_bot_training` tool allows Mastra workflows to autonomously retrain your support bots when documentation updates. Mastra AI monitors your files, checks the current state through this MCP connection, and runs training updates only when changes are detected. The workflow runs autonomously in the background, deploying as a single command to your cloud. Your bots stay trained on the latest product specs without manual developer intervention.

Multi-bot routing based on account quotas

The `get_chatfly_account_info` tool enables Mastra agents to check active usage limits before routing chats. Once verified, the agent uses `list_chatfly_bots` to find the correct bot ID and passes the customer's query to it. This keeps your operational costs in check while maintaining a high-quality support experience.

Setup guide

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

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

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

Instantiate the client using `new MCPClient` with the Vinkius endpoint URL. Call `mcpClient.listTools()` to get the tools, then spread them directly into your Mastra agent's tool array so it can run actions like `list_chatfly_bots`.

Yes, you can enforce human-in-the-loop validation easily. Use Mastra's `requireToolApproval` config on the `trigger_bot_training` tool so an admin must approve the action before the training starts.

Mastra's workflow engine has built-in retry logic with exponential backoff. If a call to `send_bot_message` fails due to network issues, the workflow retries the step automatically before executing any failure branches.

Absolutely. Mastra agents compile down to standard TypeScript and deploy to any cloud provider with a single command, keeping your automated support infrastructure close to your main application.

Your credentials and files retrieved via `list_uploaded_documents` are shielded by Vinkius's ephemeral V8 sandboxes. No support documents or account metadata are stored on our servers, ensuring your proprietary training data remains fully 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