How to Use the Helpwise MCP in Windsurf

Q: How does Cascade know which Helpwise agent to assign a ticket to?

It calls the listteammembers endpoint to get the current roster. You can prompt Cascade with specific routing rules based on the issue type.

Q: Will Windsurf send emails through Helpwise automatically?

Cascade can execute the sendemail command if you give it permission to run autonomous actions. You can also configure it to draft the response and wait for your approval.

Connect Windsurf to your shared inboxes and let Cascade autonomously manage customer communication and ticket 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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Inbox Triage in Windsurf

The `list_mailboxes` and `list_conversations` tools let Cascade pull active customer threads directly into your IDE. You tell Windsurf to clear the morning queue, and Cascade reads the unassigned tickets across all your shared support channels. It doesn't ask for permission at every step. Cascade evaluates the context, checks who is available using `list_team_members`, and routes the urgent issues to the right engineers before you even open your browser.

Context-Aware Customer Replies

Calling `get_conversation_details` gives this MCP Server full access to the historical thread, including previous agent notes and customer replies. Cascade reads the entire back-and-forth to understand the actual problem. If it spots a bug report, it can cross-reference your local codebase, figure out the fix, and then use `send_email` to draft a technically accurate response to the customer. You just review the draft and let it send.

Automated Contact Management

Triggering `create_contact` allows Windsurf to log new leads or bug reporters into your database without breaking focus. When a new email hits the support address, Cascade checks if they exist via `list_contacts`. If the user is missing, the agent builds a new profile using their signature data. This keeps your CRM data accurate while you stay buried in your code editor.

Setup guide

Set up Helpwise 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 Helpwise 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 Helpwise payment history." If connected, Cascade will call the Helpwise tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "helpwise-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 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 Windsurf

Open your Windsurf settings and navigate to the Cascade MCP Servers UI. You can add the server to your mcp_config.json there and click refresh to load the tools.

Yes. Any channel connected to your shared inbox appears when Cascade runs the list_conversations tool. It processes SMS, WhatsApp, and email exactly the same way.

It calls the list_team_members endpoint to get the current roster. You can prompt Cascade with specific routing rules based on the issue type.

Cascade can execute the send_email command if you give it permission to run autonomous actions. You can also configure it to draft the response and wait for your approval.

This integration processes raw email addresses, phone numbers, and message bodies. Vinkius isolates the connection in a V8 sandbox, meaning your customer data passes directly to your local machine without being stored on intermediary servers.

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