How to Use the Help Scout MCP in Windsurf

Q: How does Windsurf automate Help Scout ticket assignments?

Windsurf's Cascade agent uses the liststaffusers tool to see who is available and updateconvostatus to assign a conversation. You can set a goal like 'assign new tickets from the priority mailbox evenly' and Cascade handles it.

Q: Does this MCP server work with all my Help Scout mailboxes?

It does. The listmailboxes tool lets your agent see every mailbox you have configured. You can then use the mailbox ID to filter conversations or create reports.

Let Windsurf's Cascade agent manage your Help Scout tickets, from first contact to final resolution.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Help Scout MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Ticket Triage and Response

Cascade can watch for new tickets. It uses `list_conversations` to find them, then `get_conversation` to read the content and `get_customer` to see who it's from. No manual polling. Based on the goal you set, Cascade decides what's next. It might add a private note with `create_convo_note` to brief a teammate, apply a tag, or just close the ticket by calling `update_convo_status`. It handles the whole sequence.

Understand Customer History Instantly

Give Cascade a conversation ID. It will pull the full customer profile with `get_customer` and then check their history by running `list_customer_ratings`. You get the full picture without clicking around in the Help Scout UI. This MCP server connects the dots for your agent. It can see all past conversations for a customer, check which `list_tags` have been applied before, and figure out if they're a high-priority contact.

Run Support Ops with this MCP Server

You can build autonomous workflows for managing your team's workload. Cascade can use `list_mailboxes` to check ticket volume and `list_staff_users` to see who is available. From there, it can assign conversations or even run simple automations based on your existing Help Scout setup by checking `list_workflows`. It's like having an operations assistant that never sleeps.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "help-scout-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 Help Scout. 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 Help Scout 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 Help Scout MCP in Windsurf

Windsurf's Cascade agent uses the `list_staff_users` tool to see who is available and `update_convo_status` to assign a conversation. You can set a goal like 'assign new tickets from the priority mailbox evenly' and Cascade handles it.

Yes. You just tell Cascade what you're looking for. It uses the `search_conversations` tool with a query to find exactly what you need, then presents the results right in your IDE.

Just ask Windsurf to 'add a note to conversation 12345 saying we're looking into the bug'. Your agent will use the `create_convo_note` tool to post it privately for your team.

It does. The `list_mailboxes` tool lets your agent see every mailbox you have configured. You can then use the mailbox ID to filter conversations or create reports.

This server processes Help Scout conversation content, customer profiles, and staff user lists. Your data is handled in a zero-trust environment where each request runs in its own ephemeral sandbox on Vinkius. Nothing is stored.

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