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.

Functions
7
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Discogs

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/discogs
Every site

One MCP server for Discogs and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 7
  • getArtistRead one Discogs artist's profile by id: name, real name, biography text, links, aliases, name variations and band members or groups.

    Arguments

    NameTypeRequired
    artistIdnumber | string
    A Discogs artist id, or a discogs.com/artist/<id>-<name> URL.
    Yes

    Returns DiscogsArtist

    interface 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/getArtist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    labelIdnumber | string
    A Discogs label id, or a discogs.com/label/<id>-<name> URL.
    Yes

    Returns DiscogsLabel

    interface 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/getLabel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    masterIdnumber | string
    A Discogs master id, or a discogs.com/master/<id>-<name> URL.
    Yes

    Returns DiscogsMaster

    interface 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/getMaster

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    releaseIdnumber | string
    A Discogs release id, or a discogs.com/release/<id>-<name> URL.
    Yes

    Returns DiscogsRelease

    interface 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/getRelease

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/listArtistReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/listLabelReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchDatabase

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discogs.searchDatabase({ query: "nirvana", type: "artist", perPage: 3 });

Use it from code