How to Use the HappyFox MCP in Windsurf

Q: How does Windsurf interact with HappyFox to update tickets?

Windsurf uses the addstaffupdate tool to post responses directly to specific ticket IDs. Cascade chains this with getticket to ensure it has the full conversation history before writing the update.

Q: Can I search for specific customer issues in HappyFox using Windsurf?

Yes, you can run text queries using searchtickets directly inside Cascade. The agent retrieves matching tickets and can immediately pull up-to-date statuses using liststatuses to show you what needs attention.

Q: How does this HappyFox MCP Server handle ticket categorization in Windsurf?

The integration exposes listcategories and listpriorities directly to your agent. When Cascade creates a ticket with createticket, it pulls those lists first to ensure the new issue matches your existing help desk structure.

Q: Can Windsurf pull a list of all my support agents?

Yes, the agent calls liststaff to retrieve your team directory. It can also use listcontacts to find customer profiles, making it easy to assign tickets or verify user details during a support session.

Let Windsurf's Cascade autonomously resolve, update, and manage your support queue without constant manual prompting.

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 Windsurf

Create your Vinkius account to connect HappyFox to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-triage queues with Windsurf Cascade

The `search_tickets` tool lets Cascade scan your help desk for open issues matching specific customer complaints. Once found, your agent pulls detailed context with `get_ticket` to analyze the issue. Cascade doesn't stop to ask you what to do next. It immediately triggers `add_staff_update` to post internal notes or customer replies, moving tickets through statuses without requiring you to write a single line of triage code. This HappyFox MCP Server integration keeps your queue moving.

Turn workspace context into HappyFox tickets

The `create_ticket` tool allows Cascade to generate structured help desk records directly from your active code session or chat logs. It extracts the subject, description, and contact info to file issues instantly. To make sure the record lands in the right place, Cascade calls `list_categories` and `list_priorities` to tag the ticket accurately. You get clean, categorized entries in HappyFox without leaving your IDE.

Keep your team and ticket states aligned

The `list_statuses` tool gives your AI agent the exact state map of your help desk. Cascade uses this to verify where a ticket sits before making changes, preventing state conflicts. By querying `list_staff` and `list_contacts`, Cascade matches tickets to the correct owners and customers. This MCP Server setup ensures your automated updates always reach the right people.

Setup guide

Set up HappyFox MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the HappyFox MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my HappyFox payment history." If connected, Cascade will call the HappyFox tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "happyfox-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Windsurf uses the `add_staff_update` tool to post responses directly to specific ticket IDs. Cascade chains this with `get_ticket` to ensure it has the full conversation history before writing the update.

Yes, you can run text queries using `search_tickets` directly inside Cascade. The agent retrieves matching tickets and can immediately pull up-to-date statuses using `list_statuses` to show you what needs attention.

The integration exposes `list_categories` and `list_priorities` directly to your agent. When Cascade creates a ticket with `create_ticket`, it pulls those lists first to ensure the new issue matches your existing help desk structure.

Yes, the agent calls `list_staff` to retrieve your team directory. It can also use `list_contacts` to find customer profiles, making it easy to assign tickets or verify user details during a support session.

This integration accesses your ticket details, staff lists, customer contacts, and help desk configuration metadata. Vinkius hosts this MCP Server in an isolated sandbox, meaning your API tokens and customer support conversations are never stored or exposed to external parties.

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