How to Use the Backblaze B2 MCP in Windsurf

Q: Can I use Windsurf to clear out files from a Backblaze B2 bucket?

Yes, Windsurf Cascade handles this by calling listfilenames to locate Backblaze B2 files, applying hidefile for soft deletes, or running deletefileversion to permanently free up space. This automates the tedious loop of clearing files before Backblaze B2 bucket deletion.

Q: In what way does this MCP Server handle regional routing for Backblaze B2 inside Windsurf?

The MCP Server executes authorizeaccount to find the exact dynamically assigned API URL for your regional Backblaze B2 data ingress within Windsurf. Windsurf then routes all subsequent Backblaze B2 tool calls to that specific endpoint automatically.

Let Windsurf Cascade autonomously manage your Backblaze B2 buckets, clear stalled uploads, and prune file versions directly in your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Backblaze B2 MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade Automates Backblaze B2 Bucket Lifecycles

By calling `list_buckets`, Windsurf can map your Backblaze B2 storage layout and spin up new partitions without requiring manual setup steps. Cascade scans your active Backblaze B2 infrastructure, identifies missing storage targets, and provisions the correct buckets instantly.

Clean Up Broken Backblaze B2 Multi-Part Uploads

Running `list_unfinished_large_files` exposes stalled Backblaze B2 multi-part chunks that external S3 integrations left behind inside your Windsurf workspace. Failed API uploads waste money, so Cascade automatically flags these orphaned Backblaze B2 fragments across your storage accounts.

Windsurf MCP Server Handles Soft Deletes and Versioning

Invoking `hide_file` shadows active Backblaze B2 files with a null-marker to enforce safe soft deletion inside Windsurf. This native redundancy management runs smoothly, while the `delete_file_version` tool vaporizes specific absolute chunk data from Backblaze B2 disk arrays during Cascade cleanup runs.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "backblaze-b2-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 Backblaze B2. 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 Backblaze B2 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 Backblaze B2 MCP in Windsurf

After reading your prompt, Cascade checks your Backblaze B2 storage layout with `list_buckets` and automatically runs `create_bucket` if the target is missing. Each Backblaze B2 sequence runs headlessly until the goal is met.

Yes, Windsurf Cascade handles this by calling `list_file_names` to locate Backblaze B2 files, applying `hide_file` for soft deletes, or running `delete_file_version` to permanently free up space. This automates the tedious loop of clearing files before Backblaze B2 bucket deletion.

The MCP Server executes `authorize_account` to find the exact dynamically assigned API URL for your regional Backblaze B2 data ingress within Windsurf. Windsurf then routes all subsequent Backblaze B2 tool calls to that specific endpoint automatically.

Backblaze B2 returns a 400 error if files or hidden versions still exist, which Cascade catches instantly. Our integration then runs `list_file_names` to find the remaining Backblaze B2 data and prompts you to clear those files.

Your Backblaze B2 API credentials and file metadata stay entirely inside the local Windsurf environment. Vinkius runs this Backblaze B2 MCP Server in an isolated sandbox, meaning your storage keys are never exposed to Windsurf or logged externally.

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