How to Use the Brandfolder MCP in Windsurf

Q: How does Windsurf Cascade run searches across my Brandfolder assets?

Cascade uses getbrandfolderassets to scan your library based on your natural language prompts. It reads the files, grabs the correct metadata, and presents them in your editor sidebar.

Q: Can I delete old assets from Brandfolder using Windsurf?

Yes, Cascade can call wipemediaasset to permanently remove files when you tell it to clean up old design drafts. It asks for your confirmation before executing this destructive action.

Q: How do I point Windsurf to a specific Brandfolder collection?

You run getcollectionassets through Cascade to isolate files in a single collection. The agent automatically handles the collection ID matching behind the scenes.

Q: Can my agent fetch organization-level details?

Absolutely. The listplatformorganizations tool lets your agent inspect all top-level tenant spaces associated with your API token.

Get Windsurf Cascade to hunt down, update, and organize your Brandfolder assets without you writing a line of code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brandfolder MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-discover assets with Windsurf and MCP

Use `list_global_brandfolders` to let Cascade map out your entire digital asset library the second you ask for an image. The tool instantly exposes your workspace layout so your agent knows exactly where your creative files live without you digging through browser tabs. Once Cascade finds the right bucket, it runs `get_brandfolder_assets` to pull matching files. You just tell the agent what you need for your frontend, and it handles the search, grabs the metadata, and drops the files right into your workspace.

Update creative metadata directly from Cascade

Run `patch_cms_asset` to change asset tags, names, or descriptions when your design specs shift. Cascade handles the heavy lifting by checking existing tags with `list_asset_tags` first, then applying the updates in one clean shot. This means you never open a web UI to fix a typo in your asset library. Your agent manages the API calls in the background using this MCP Server, keeping your production assets perfectly labeled while you focus on writing code.

Pull live CDN links straight into your code

Grab production-ready image URLs using `list_asset_attachments` to populate your React or Vue components instantly. Cascade reads the returned CDN links and writes them directly into your frontend code. Instead of copying and pasting links manually, you let this MCP Server feed the live URLs straight to your editor. You get working image elements on your screen in seconds, backed by your actual Brandfolder assets.

Setup guide

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

mcp_config.json

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

Cascade uses `get_brandfolder_assets` to scan your library based on your natural language prompts. It reads the files, grabs the correct metadata, and presents them in your editor sidebar.

Yes, Cascade can call `wipe_media_asset` to permanently remove files when you tell it to clean up old design drafts. It asks for your confirmation before executing this destructive action.

You run `get_collection_assets` through Cascade to isolate files in a single collection. The agent automatically handles the collection ID matching behind the scenes.

Absolutely. The `list_platform_organizations` tool lets your agent inspect all top-level tenant spaces associated with your API token.

Yes, your digital assets and metadata stay secure because Vinkius runs this server inside an isolated sandbox. Your API keys and file descriptions never touch external training sets.

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