How to Use the HappyFox MCP in Mastra AI

Q: Can I require human approval before Mastra AI updates a HappyFox ticket?

Yes, you can use the requireToolApproval option when executing addstaffupdate. This pauses the Mastra AI workflow and alerts a manager before any changes are written to the ticket. It keeps your support communications safe and accurate.

Q: How do I filter tickets by status using HappyFox and Mastra AI?

Call liststatuses to get the valid status IDs, then pass them as filters to listtickets. Mastra AI uses these parameters to fetch only the tickets that need immediate attention. This keeps your automated processes focused on open issues.

Q: Can I manage customer contacts directly?

Yes, you can use listcontacts to find existing users or verify their details. This helps you avoid creating duplicate contact records when processing new requests.

Build self-healing support workflows using Mastra AI and the HappyFox MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HappyFox MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Mastra AI manages support escalation paths

`list_priorities` lets your Mastra AI workflows evaluate incoming tickets and assign appropriate urgency levels automatically. If a high-priority ticket sits unanswered, the workflow triggers an automatic escalation. You define the rules, and the framework executes them. This ensures your critical SLAs are met without human agents manually checking the queue every five minutes.

Route tickets based on staff availability

`list_staff` retrieves your active support roster so Mastra AI can distribute incoming workloads evenly. The framework checks who is online and assigns new tickets based on current staff capacity. This prevents support bottlenecks during peak hours. Your team gets a balanced distribution of tickets without manual intervention from a queue manager.

Recover from failed ticket updates automatically

`add_staff_update` retries automatically if a network error occurs during a ticket update. Mastra AI uses exponential backoff to ensure your internal notes are saved even during temporary API hiccups. This built-in reliability keeps your support records accurate. You don't have to write custom error-handling code to protect your help desk data.

Setup guide

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

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

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

Instantiate the MCP client with your Vinkius server URL and register it in your Mastra configuration. From there, your agents can access tools like `list_tickets` and `create_ticket` instantly. The framework handles transport negotiation automatically.

Yes, you can use the `requireToolApproval` option when executing `add_staff_update`. This pauses the Mastra AI workflow and alerts a manager before any changes are written to the ticket. It keeps your support communications safe and accurate.

Call `list_statuses` to get the valid status IDs, then pass them as filters to `list_tickets`. Mastra AI uses these parameters to fetch only the tickets that need immediate attention. This keeps your automated processes focused on open issues.

Yes, you can use `list_contacts` to find existing users or verify their details. This helps you avoid creating duplicate contact records when processing new requests.

Your customer contact profiles and ticket histories are processed entirely in memory during workflow execution. The Vinkius MCP Server operates within a zero-trust sandbox, ensuring that no sensitive customer data is ever persisted on the hosting platform.

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