How to Use the Discogs MCP in Windsurf

Q: Can I use Windsurf to buy records directly from the marketplace?

No, because this server only reads data. The getmarketplacelistings tool pulls seller details, pricing, and sleeve conditions, but you must complete the actual purchase on the web platform.

Q: How do I configure this Discogs MCP Server in Windsurf?

You open your /.codeium/windsurf/mcpconfig.json file and add the MCP server configuration under the mcpServers key. Alternatively, use the Cascade settings UI to paste the endpoint token, and Cascade will instantly discover all 13 tools.

Q: Can Cascade handle complex vinyl pressing variations?

Yes, by chaining getmasterreleaseversions and getrelease, Cascade compares release countries, catalog numbers, and runout groove details. It filters out the noise to find the exact pressing you are looking for.

Get Windsurf to hunt down rare vinyl pressings, compare marketplace prices, and manage your Discogs collection autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Discogs MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously map out artist discographies

The `get_artist_releases` tool lets Windsurf pull a musician's entire catalog without you prompting for every single album. Once Cascade has the initial list, it automatically triggers `get_master_release` and `get_master_release_versions` to sort the original pressings from the cheap modern reissues. Instead of babying the AI, you tell Windsurf to find a specific pressing, and it chains these calls in the background. It maps out the matrix numbers, labels, and release years before presenting you with the exact catalog match.

Windsurf MCP Server pricing analysis

The `get_release_stats` tool provides the raw price history of a record, which Cascade uses to spot underpriced listings. By combining this with `get_marketplace_listings`, your agent tracks down active sales that fall below the median historical price. You don't need to manually check the math. Windsurf handles the API rate limits of this MCP Server by caching static metadata and only hitting the marketplace endpoint for active listings when volatility spikes.

Sync and audit collection data

The `get_user_collection` tool fetches your digital crates so Windsurf can cross-reference what you own against what you want. Cascade scans your `get_user_wantlist` and matches it against live seller listings in real-time. It flags missing catalog numbers and updates your local files with current market values. You get a clean markdown file of your collection's worth without writing a line of code.

Setup guide

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

mcp_config.json

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

This MCP Server relies on Windsurf to handle rate limits by caching static artist and label data locally. When Cascade executes multiple steps, it prioritizes `get_release_stats` to verify demand before hitting the marketplace, keeping queries well under the 60 requests per minute ceiling.

No, because this server only reads data. The `get_marketplace_listings` tool pulls seller details, pricing, and sleeve conditions, but you must complete the actual purchase on the web platform.

You open your `~/.codeium/windsurf/mcp_config.json` file and add the MCP server configuration under the `mcpServers` key. Alternatively, use the Cascade settings UI to paste the endpoint token, and Cascade will instantly discover all 13 tools.

Yes, by chaining `get_master_release_versions` and `get_release`, Cascade compares release countries, catalog numbers, and runout groove details. It filters out the noise to find the exact pressing you are looking for.

Yes, your token remains isolated inside Windsurf's secure configuration file and is only used to sign requests to the API. The server only reads collection, wantlist, and profile data, never exposing your credentials to external parties.

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