How to Use the Fairing MCP in Windsurf

Q: How does Windsurf use the Fairing MCP Server to track customer attribution?

Windsurf uses Cascade to call listresponses and parse the raw attribution answers. Cascade then matches these responses against your marketing spend data to calculate your actual customer acquisition cost.

Q: Can Cascade automate survey schema updates in my codebase?

Yes. Cascade calls listquestions to pull your live survey configuration, compares it with your current database models, and writes the necessary migration files to keep them aligned.

Q: How do I configure the Fairing MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Windsurf also has a built-in MCP Marketplace where you can connect it with one click.

Q: Can I query specific customer profiles during a debugging session?

Yes, you can use getcustomerresponses to pull every survey answer submitted by a specific customer ID. This helps you debug profile sync issues without leaving your terminal.

Get raw post-purchase survey data directly inside Windsurf and let Cascade analyze zero-party insights without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fairing MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run instant cohort analysis using the Fairing MCP Server

The `list_responses` tool pulls raw post-purchase survey feedback directly into your Windsurf workspace. Cascade reads these raw answers, matches them against your customer profiles, and groups the sentiment into distinct buyer cohorts. You don't have to write custom parsing scripts or export CSVs. Once Cascade has the raw data, it uses `get_insights` to cross-reference these cohorts with your aggregated survey trends. This lets you spot sudden drops in attribution accuracy or shifts in customer acquisition channels directly within your active coding window.

Auto-map zero-party data to your database schema

The `get_question` tool retrieves the exact phrasing and structure of your active post-purchase questions. Cascade analyzes this structure to map incoming survey fields to your local Postgres or MySQL schemas. It generates the migration files and writes the validation logic in one autonomous pass. After setting up the schema, Cascade uses `get_survey_details` to verify that your application handles every active question type correctly. You get clean, database models that match your live customer touchpoints without manual mapping.

Audit survey integrations directly in Cascade

The `list_integrations` tool exposes all active data destinations connected to your Fairing account. Cascade scans these connections to verify that your customer data flows to your email platform and analytics tools without silent failures. If Cascade detects a missing connection, it uses `get_account_info` to verify your API permissions and account status. You fix integration gaps right inside Windsurf before writing a single line of API glue code.

Setup guide

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

mcp_config.json

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

Windsurf uses Cascade to call `list_responses` and parse the raw attribution answers. Cascade then matches these responses against your marketing spend data to calculate your actual customer acquisition cost.

Yes. Cascade calls `list_questions` to pull your live survey configuration, compares it with your current database models, and writes the necessary migration files to keep them aligned.

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Windsurf also has a built-in MCP Marketplace where you can connect it with one click.

Yes, you can use `get_customer_responses` to pull every survey answer submitted by a specific customer ID. This helps you debug profile sync issues without leaving your terminal.

Totally. Your survey responses and customer identifiers stay inside Vinkius's secure sandbox. Windsurf only receives the specific data payloads requested by Cascade, and your API keys never touch external logs.

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