How to Use the MusicBrainz MCP in Windsurf

Q: Can I search for record labels using MusicBrainz inside Windsurf?

Yes. Cascade uses searchlabels to find the target label, then calls getlabel to pull its founding date and location details directly into your project files.

Q: How do I configure the MusicBrainz MCP Server in my Windsurf setup?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to connect the Vinkius endpoint.

Q: Can I filter album releases by their release status?

Yes. The searchreleases tool supports filtering by official, promotion, or bootleg status, which your agent uses to clean up noisy search results.

Cascade chains MusicBrainz queries autonomously to fetch complete discographies and clean up your music application metadata in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MusicBrainz MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fast metadata resolution inside Windsurf

`search_artists` lets Windsurf pinpoint the exact music artist you need without leaving your active workspace via this MCP Server. Cascade uses this tool to find unique IDs first, then feeds them directly into other tools to pull deeper details. Instead of manually copy-pasting IDs, you let Cascade run the initial search and immediately trigger `get_artist` to extract origin countries and active years. This automated sequence cuts down the time you spend mapping messy audio files to their clean canonical records.

Automated discography builds via Windsurf MCP Server

`browse_releases_by_artist` allows Windsurf to collect every single album, EP, and single associated with a specific creator in one quick sweep. Cascade handles the pagination limits of 100 results per request behind the scenes, pulling complete catalogs without manual intervention. After collecting the release list, the agent runs `get_release_group` to categorize the items into studio albums or live bootlegs. You get structured JSON outputs directly in your workspace, ready to fuel your local music database or discovery app.

Deep track and composition mapping

`get_recording` fetches specific track lengths, International Standard Recording Codes, and the physical releases where those tracks exist. Cascade analyzes these payloads to resolve duplicate tracks across different compilation albums automatically. When you need to trace a song back to its original songwriters, the agent calls `get_work` to fetch composition details and languages. This step-by-step cross-referencing happens in seconds, saving you from navigating complex relational tables yourself.

Setup guide

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

mcp_config.json

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

The MusicBrainz MCP Server runs on Vinkius, which routes all requests through a managed infrastructure. Cascade can query multiple lookup tools without hitting blockages or throwing errors in your editor.

Yes. Cascade uses `search_labels` to find the target label, then calls `get_label` to pull its founding date and location details directly into your project files.

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings UI under Cascade to connect the Vinkius endpoint.

Yes. The `search_releases` tool supports filtering by official, promotion, or bootleg status, which your agent uses to clean up noisy search results.

Vinkius processes all your MusicBrainz MBIDs and text queries within ephemeral, zero-trust V8 isolates. No search history or metadata requests are ever cached or stored on the hosting infrastructure.

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