Discogs MCP server for AI agents
Let Claude, ChatGPT or your own agent read Discogs: 7 typed functions through one MCP server. No Discogs API key needed.
- Site
- discogs.com
- Functions
- 7
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Discogs alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/discogsOne MCP server for Discogs and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getArtistRead one Discogs artist's profile by id: name, real name, biography text, links, aliases, name variations and band members or groups.Arguments
Name Type Required artistIdnumber | stringA Discogs artist id, or a discogs.com/artist/<id>-<name> URL.Yes Returns
DiscogsArtistinterface DiscogsArtist { id: number | null; name: string | null; realName: string | null; profile: string | null; urls: string[]; nameVariations: string[]; aliases: { id: number | null; name: string | null }[]; members: { id: number | null; name: string | null; active: boolean | null }[]; groups: { id: number | null; name: string | null }[]; imageUrl: string | null; dataQuality: string | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/getArtistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.getArtist({ artistId: 125246 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.getArtist({"artistId": 125246}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/getArtist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"artistId":125246}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.getArtist({ artistId: 125246 });getLabelRead one Discogs record label by id: name, profile text, contact info, links, parent label and sublabels.Arguments
Name Type Required labelIdnumber | stringA Discogs label id, or a discogs.com/label/<id>-<name> URL.Yes Returns
DiscogsLabelinterface DiscogsLabel { id: number | null; name: string | null; profile: string | null; contactInfo: string | null; urls: string[]; parentLabel: { id: number | null; name: string | null } | null; sublabels: { id: number | null; name: string | null }[]; imageUrl: string | null; dataQuality: string | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/getLabelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.getLabel({ labelId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.getLabel({"labelId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/getLabel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"labelId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.getLabel({ labelId: 1 });getMasterRead one Discogs master release (an album across all its editions) by id: title, year, artists, genres, tracklist, its main and most recent release…Arguments
Name Type Required masterIdnumber | stringA Discogs master id, or a discogs.com/master/<id>-<name> URL.Yes Returns
DiscogsMasterinterface DiscogsTrack { position: string | null; title: string | null; duration: string | null; type: string | null; } interface DiscogsMaster { id: number | null; title: string | null; year: number | null; artists: { id: number | null; name: string | null }[]; genres: string[]; styles: string[]; tracklist: DiscogsTrack[]; mainRelease: number | null; mostRecentRelease: number | null; numForSale: number | null; lowestPrice: number | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/getMasterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.getMaster({ masterId: 1000 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.getMaster({"masterId": 1000}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/getMaster \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"masterId":1000}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.getMaster({ masterId: 1000 });getReleaseRead one Discogs release (a specific edition of an album, EP or single) by id: artists, labels and catalogue numbers, formats, genres, tracklist with…Arguments
Name Type Required releaseIdnumber | stringA Discogs release id, or a discogs.com/release/<id>-<name> URL.Yes Returns
DiscogsReleaseinterface DiscogsTrack { position: string | null; title: string | null; duration: string | null; type: string | null; } interface DiscogsRelease { id: number | null; title: string | null; year: number | null; released: string | null; country: string | null; artists: { id: number | null; name: string | null; join: string | null }[]; labels: { id: number | null; name: string | null; catno: string | null }[]; formats: { name: string | null; qty: string | null; descriptions: string[] }[]; genres: string[]; styles: string[]; tracklist: DiscogsTrack[]; credits: { id: number | null; name: string | null; role: string | null }[]; notes: string | null; masterId: number | null; have: number | null; want: number | null; rating: { average: number | null; count: number | null }; numForSale: number | null; lowestPrice: number | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/getReleaseCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.getRelease({ releaseId: 249504 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.getRelease({"releaseId": 249504}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/getRelease \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"releaseId":249504}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.getRelease({ releaseId: 249504 });listArtistReleasesList an artist's discography and credits on Discogs, paged and sortable by year, title or format: one row per master (an album across editions) or…Arguments
Name Type Required argsDiscogsArtistReleasesArgsYes interface DiscogsArtistArgs { /** a Discogs artist id, or a discogs.com/artist/<id>-<name> URL */ artistId: number | string; } interface DiscogsArtistReleasesArgs extends DiscogsArtistArgs { page?: number; perPage?: number; sort?: "year" | "title" | "format"; sortOrder?: "asc" | "desc"; }Returns
{ page: DiscogsPage; releases: DiscogsReleaseRow[] }interface DiscogsPage { page: number; pages: number; perPage: number; total: number; } interface DiscogsReleaseRow { id: number | null; /** "master" (an album across all editions) or "release" (one edition) */ type: string | null; title: string | null; artist: string | null; year: number | null; role: string | null; format: string | null; label: string | null; catno: string | null; mainRelease: number | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/listArtistReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.listArtistReleases({ artistId: 125246, perPage: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.listArtistReleases({"artistId": 125246, "perPage": 3}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/listArtistReleases \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"artistId":125246,"perPage":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.listArtistReleases({ artistId: 125246, perPage: 3 });listLabelReleasesList a record label's catalogue on Discogs, paged: one row per release with title, artist, catalogue number, format and year.Arguments
Name Type Required argsDiscogsLabelReleasesArgsYes interface DiscogsLabelArgs { /** a Discogs label id, or a discogs.com/label/<id>-<name> URL */ labelId: number | string; } interface DiscogsLabelReleasesArgs extends DiscogsLabelArgs { page?: number; perPage?: number; sort?: "year" | "title" | "format"; sortOrder?: "asc" | "desc"; }Returns
{ page: DiscogsPage; releases: DiscogsReleaseRow[] }interface DiscogsPage { page: number; pages: number; perPage: number; total: number; } interface DiscogsReleaseRow { id: number | null; /** "master" (an album across all editions) or "release" (one edition) */ type: string | null; title: string | null; artist: string | null; year: number | null; role: string | null; format: string | null; label: string | null; catno: string | null; mainRelease: number | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/listLabelReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.listLabelReleases({ labelId: 1, perPage: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.listLabelReleases({"labelId": 1, "perPage": 3}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/listLabelReleases \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"labelId":1,"perPage":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.listLabelReleases({ labelId: 1, perPage: 3 });searchDatabaseSearch the Discogs music database for artists, bands, labels, releases (albums, singles, EPs) and masters by name or title, optionally narrowed to…Arguments
Name Type Required argsstring | DiscogsSearchArgsYes interface DiscogsSearchArgs { query: string; /** narrow to one kind of result */ type?: "release" | "master" | "artist" | "label"; page?: number; /** 1-100, default 50 */ perPage?: number; }Returns
{ page: DiscogsPage; results: DiscogsSearchHit[] }interface DiscogsPage { page: number; pages: number; perPage: number; total: number; } interface DiscogsSearchHit { id: number | null; /** "artist" | "label" | "release" | "master" */ type: string | null; title: string | null; year: string | null; country: string | null; formats: string[]; labels: string[]; catno: string | null; genres: string[]; styles: string[]; masterId: number | null; url: string | null; apiUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discogs/searchDatabaseCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discogs.searchDatabase({ query: "nirvana", type: "artist", perPage: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discogs.searchDatabase({"query": "nirvana", "type": "artist", "perPage": 3}))curl -X POST https://api.bowmark.ai/v1/sites/discogs/searchDatabase \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"nirvana","type":"artist","perPage":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discogs.searchDatabase({ query: "nirvana", type: "artist", perPage: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/discogs/<function> - OpenAPI
/v1/sites/discogs/openapi.json