How to Use the Flodesk MCP in Windsurf

Q: How does the server handle Flodesk custom fields in Windsurf?

You can use the listcustomfields tool to pull your existing schema. Cascade will then use those specific field names when you run an update.

Use Windsurf to connect your Flodesk segments directly to your codebase and automate subscriber management without leaving the IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flodesk MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate subscriber updates in Windsurf

Cascade pulls subscriber data directly into your workflow using `upsert_subscriber`. You can map incoming user data to your email lists without manual entry. Windsurf reads your logic and executes the sync automatically. It ensures that every email address is correctly categorized as soon as the data hits your system.

Trigger workflows from your code

Use `add_subscriber_to_workflow` to launch custom email sequences directly from your application logic. This MCP Server lets your agent trigger specific marketing flows based on user actions in your app. Windsurf handles the API calls so you can focus on the trigger conditions. It maps your internal events to Flodesk workflows in a single pass.

Manage segments through your IDE

Visualize your marketing data by calling `list_segments` and `get_segment` within the Windsurf sidebar. You can audit your current subscriber groupings without switching tabs. Cascade uses these tools to plan complex audience filtering. You get a clear view of how your segments are structured before you push any changes to the production list.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "flodesk-alternative-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 Flodesk. 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 Flodesk 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 Flodesk MCP in Windsurf

Add this MCP Server to your configuration file, then ask Cascade to list or update records. It will identify the correct tools and execute the API calls for you.

Yes, once connected, you can instruct Cascade to trigger specific workflows. It uses your provided endpoint token to handle the communication securely.

Your data remains local to your session. The server acts as a bridge and does not store your subscriber information or email lists on our infrastructure.

You can use the `list_custom_fields` tool to pull your existing schema. Cascade will then use those specific field names when you run an update.

We treat email addresses as sensitive identifiers. This server only passes them through the encrypted API tunnel to perform the requested actions.

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