Discogs
live MediaMusicMusic release / artist / label database. Vinyl-friendly pressing-level detail.
5 tools
0ms auth
free tier 50 calls/day
Authentication
BYO personal access token. Generate at discogs.com/settings/developers.
Config with credentials
{
"mcpServers": {
"pipeworx-discogs": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://gateway.pipeworx.io/discogs/mcp?_apiKey=your_personal_access_token"
]
}
}
}Tools
search
required: query Full-text search across releases / masters / artists / labels.
Parameters
Name Type Description
query req string Free-text type opt string release | master | artist | label title opt string Title filter artist opt string Artist filter label opt string Label filter format opt string e.g. Vinyl, CD country opt string Country year opt string Year or range genre opt string Genre style opt string Style page opt number 1-based page per_page opt number 1-100 Try it
Response
get_release
required: release_id Release detail.
Parameters
Name Type Description
release_id req number Discogs release ID Try it
Response
get_master
required: master_id Master release detail.
Parameters
Name Type Description
master_id req number Discogs master ID Try it
Response
get_artist
required: artist_id Artist profile.
Parameters
Name Type Description
artist_id req number Discogs artist ID Try it
Response
get_label
required: label_id Label profile.
Parameters
Name Type Description
label_id req number Discogs label ID Try it
Response
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
List available tools
bash
curl -X POST https://gateway.pipeworx.io/discogs/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Call a tool
bash
curl -X POST https://gateway.pipeworx.io/discogs/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"query": "hello"}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search", {"query":"example"}); ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("music release / artist / label database");