How to add Discogs MCP Server to Windsurf

Search and manage your Discogs music catalog, collection, wantlist, and marketplace from your AI client. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 112★ · stdio · apikey

Windsurf config for Discogs MCP Server

npx -y discogs-mcp-server

{
  "mcpServers": {
    "discogs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "discogs-mcp-server"
      ],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Discogs MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Discogs MCP Server's tools become available to Cascade.

Before you start

Node.js (tested with 20.x.x; 18.x.x should also work)
A Discogs personal access token (from Discogs Settings > Developers)
Docker (optional, for running via the prebuilt image)

What Discogs MCP Server can do in Windsurf

get_user_identity

Retrieve basic information about the authenticated user.

get_user_profile

Retrieve a user by username.

edit_user_profile

Edit a user's profile data (name, profile text, location, homepage, currency).

get_user_submissions

Retrieve a user's submissions (artists, labels, releases) by username.

get_user_contributions

Retrieve a user's contributions by username, with paging and sorting.

get_user_collection_folders

Retrieve a list of folders in a user's collection.

create_user_collection_folder

Create a new folder in a user's collection.

get_user_collection_folder

Retrieve metadata about a folder in a user's collection.

Security

Requires a Discogs personal access token (set via the DISCOGS_PERSONAL_ACCESS_TOKEN environment variable) — do not share your token. The server can edit data in your Discogs collection (add/remove/move releases, ratings, marketplace listings and orders, wantlist), so verify actions before executing them. OAuth is not yet supported.

Discogs MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Discogs MCP Server config there under the "mcpServers" key and restart the client.

Is Discogs MCP Server safe to use with Windsurf?

How do I authenticate?

Set the DISCOGS_PERSONAL_ACCESS_TOKEN environment variable to your Discogs personal access token, obtained from Discogs Settings > Developers. OAuth support is planned for a future release.

What is the fastest way to get started?

Install Node.js, get your Discogs personal access token, and use the NPX configuration in your MCP client (e.g. Claude Desktop) — `npx -y discogs-mcp-server` with the token set in env.

Can it modify my Discogs data?

Yes. The server can edit your collection, ratings, wantlist, marketplace listings, and orders. Verify actions before executing them.

View repo Full Discogs MCP Server page