How to Use the Refiner MCP in Windsurf

Q: Can Cascade automatically update user segments in Refiner?

Yes. Windsurf chains identifyrefineruser and trackrefinerevent to update user profiles based on your local code context.

Q: How does Windsurf handle API failures from Refiner?

Cascade runs checkrefinerstatus to verify the connection. If the API is down, the agent halts the chain and reports the error in your chat panel.

Let Cascade pull live NPS scores and target SaaS user segments directly within your Windsurf workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Refiner MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build churn-risk dashboards in Windsurf

Cascade reads your workspace code and chains a sequence to map risk profiles. It uses `list_refiner_responses` to pull recent negative feedback and matches it against `list_refiner_segments` to find high-value accounts that are hurting. Instead of you writing the API calls, the agent builds a custom React table, populates it with live Refiner data, and writes the test suite. You just watch the code write itself.

Automate user targeting with this MCP Server

Update your user records without leaving Windsurf. When Cascade spots an active user event in your logs, it can trigger `track_refiner_event` and `identify_refiner_user` to update their profile instantly. This lets you flag power users for specific in-app micro-surveys. Cascade coordinates the entire flow, updating both your local backend logic and your active Refiner segments.

Audit active feedback surveys inside Windsurf

Cascade checks your survey configurations by running `list_refiner_surveys`. It parses the active questions, checks the status using `check_refiner_status`, and flags any outdated NPS campaigns. You get a clean markdown summary of what your users are seeing. Cascade can even draft code changes to update your frontend tracking scripts based on what it finds.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "refiner-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 Refiner. 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 Refiner 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 Refiner MCP in Windsurf

Open your Settings, go to Cascade, and find MCP Servers. Add the server under your `mcp_config.json` configuration or use the one-click installer in the built-in marketplace.

Yes. Windsurf chains `identify_refiner_user` and `track_refiner_event` to update user profiles based on your local code context.

Cascade runs `check_refiner_status` to verify the connection. If the API is down, the agent halts the chain and reports the error in your chat panel.

Yes. Run a prompt asking Cascade to show recent feedback. It will invoke `list_refiner_responses` and format the output as a clean table in your sidebar.

Your customer email addresses and survey responses stay inside Vinkius's zero-trust sandbox. Windsurf only receives the specific data returned by the tool calls, and no external parties ever see your raw database.

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