How to Use the Bandcamp MCP in Windsurf

Q: Can Windsurf Cascade search Bandcamp for specific indie labels?

Yes, the search tool accepts label names along with artists and tracks. Cascade will return the matching URLs and fan profiles, which you can then feed into other commands to build label-specific dashboards.

Let Windsurf Cascade autonomously pull independent music data and embed Bandcamp track metadata straight into your web app.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bandcamp MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build music discovery features with Windsurf

Cascade chains music discovery requests without asking permission. You tell it to build an indie music feed, and it hits `get_tags` to find genre IDs. Then it immediately calls `discover_music` and `get_new_releases` to populate your frontend components. You avoid writing complex fetch logic for the Bandcamp API. The MCP Server handles the routing while Windsurf writes the React code, pulling real artist names, artwork URLs, and album links straight into your codebase.

Parse raw album pages into structured data

Extracting tracklists from raw album pages usually takes hours of DOM inspection. Now you just paste an artist URL into the editor. Cascade runs `get_page_data` and extracts pricing, embedded metadata, and exact track names instantly. This MCP Server formats that raw JSON into whatever database schema you have open in your workspace. Build out full discography tables by looping `search` results through the page parser, letting the agent handle the heavy lifting.

Curate editorial picks automatically

Front page features change constantly on the platform. Tell your agent to grab the latest stories using `get_featured` and `get_best_selling`. It pulls the curated picks and formats them into your newsletter template. Want to narrow it down? Have Cascade run `get_recommended` for specific genres like ambient or metal. You get fresh, accurate editorial content embedded right where you need it.

Setup guide

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

mcp_config.json

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

Open your Settings and navigate to the Cascade MCP Servers UI. You can add it directly to the configuration file, or just use the built-in marketplace for a one-click install. Hit refresh in the panel to start pulling music data.

Yes, the `search` tool accepts label names along with artists and tracks. Cascade will return the matching URLs and fan profiles, which you can then feed into other commands to build label-specific dashboards.

No, this server only fetches metadata. You get artist info, artwork URLs, tracklists, and release dates. It does not pull audio files or bypass purchase requirements.

You probably used a genre string that does not exist in their system. Have Cascade run `get_tags` first to see the exact formatting required, then pass those specific tags into the release queries.

The Vinkius V8 Isolate Sandbox restricts all traffic strictly to public music metadata. Your local source code never leaves your machine. The connection only transmits search queries and returns public album or artist details.

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