How to Use the Flipt MCP in Windsurf

Q: Can Windsurf manage my Flipt tokens?

Yes. You can use the listtokens tool to verify your current authentication setup. This ensures your agent has the right access level before it attempts any changes.

Use the Flipt MCP Server inside Windsurf to manage your feature flags and rollout rules directly from 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 Flipt MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full visibility into your flag state

Cascade pulls your current architecture status by running `list_flags` and `list_namespaces` directly in your workspace. You stop context switching between your browser and your code. It maps your existing environment configuration to your active branch. You see exactly what's live without leaving your terminal.

Automated rollout management in Windsurf

Cascade sequences complex tasks by executing `list_rollouts` and `list_rules` to verify your current delivery logic. It detects stale segments before you commit new code. You avoid manual configuration errors by letting the agent inspect the system state. It identifies conflicts in your distribution logic before you deploy.

Atomic updates for flag variants

You can safely modify your feature set using `create_variant` and `create_constraint` under Cascade's supervision. The agent handles the API handshake so you focus on the logic. It logs every change back to your local environment for auditability. You get a clean history of every tweak made to your production segments.

Setup guide

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

mcp_config.json

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

Open your MCP settings in the Cascade panel and add the server configuration. Once saved, hit refresh to let the agent discover the available tools.

Yes. You can use the `list_tokens` tool to verify your current authentication setup. This ensures your agent has the right access level before it attempts any changes.

Your data remains isolated within the Vinkius sandbox. Only the tools you explicitly permit will interact with your Flipt instance during a session.

The agent reports the error directly in the chat window. You can then inspect the `list_rules` output to see where the logic diverged from your expected state.

The server only touches your flag definitions and segment rules. It does not store or process your user-level traffic data or PII.

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