How to Use the Freshchat MCP in Mastra AI

Q: How do I add the Freshchat MCP Server to a Mastra AI agent workflow?

Instantiate the client using @mastra/mcp and pass the server URL. You can then register tools like sendchatmessage directly into your Mastra AI agent's toolset to automate responses.

Q: How do I verify account configurations inside my workflows?

Use the checkaccountstatus tool to verify your Freshchat setup inside Mastra AI. This allows your Mastra AI agent to run a quick diagnostic check before executing complex data-gathering routines.

Build resilient, self-healing Freshchat workflows and escalation loops with Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshchat MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated support loops with Mastra AI

Build multi-step support chains that do not break when an API hiccup occurs between Freshchat and Mastra AI. This MCP Server coordinates tools like `list_conversations` and `send_chat_message` inside structured Mastra AI workflows that automatically retry failed operations. If a network blip interrupts a Freshchat message delivery, the Mastra AI workflow engine catches the error. It uses exponential backoff to retry sending the text, ensuring your Freshchat customers are never left hanging in an unassigned queue.

Intent-based routing and agent escalation

Stop manually assigning incoming tickets in Freshchat when you can automate it with Mastra AI. Your Mastra AI workflow uses `list_agent_groups` to evaluate which teams are online and matches them against the complexity of the inbound issue. The Mastra AI agent queries team metadata using `get_agent_profile` and routes the Freshchat conversation. If a high-value customer needs help, the Mastra AI system bypasses standard queues to assign them to a specialized group immediately.

Proactive user verification and status checks

Ensure your Mastra AI support workflow has clean data before triggering actions in Freshchat. The MCP Server runs `check_account_status` to verify configurations before pulling any customer records. Once verified, the Mastra AI workflow uses `get_chat_user_details` to audit recent activity in Freshchat. This ensures your automated Mastra AI responses are grounded in actual user history rather than guesswork.

Setup guide

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

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

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

Instantiate the client using `@mastra/mcp` and pass the server URL. You can then register tools like `send_chat_message` directly into your Mastra AI agent's toolset to automate responses.

Yes, you can configure manual gates in Mastra AI for Freshchat tasks. For instance, you can require human validation before your workflow triggers `send_chat_message` to resolve sensitive customer disputes.

The Mastra AI workflow engine handles Freshchat rate limits gracefully. It pauses execution and retries tools like `list_conversations` once the rate limit window resets, preventing broken automation states.

Use the `check_account_status` tool to verify your Freshchat setup inside Mastra AI. This allows your Mastra AI agent to run a quick diagnostic check before executing complex data-gathering routines.

Absolutely, your Freshchat user metadata and active conversations remain completely secure. No customer records or support transcripts are ever cached on external platforms when processed by Mastra AI.

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