Discogs MCP Server

Instructions

Implementation Reference

• src/tools/database.ts:62-76 (handler)

  Defines the MCP 'get_artist' tool, including its handler (execute function) that fetches artist data using ArtistService.get(args) and returns JSON.

  export const getArtistTool: Tool<FastMCPSessionAuth, typeof ArtistIdParamSchema> = {
    name: 'get_artist',
    description: 'Get an artist',
    parameters: ArtistIdParamSchema,
    execute: async (args) => {
      try {
        const artistService = new ArtistService();
        const artist = await artistService.get(args);
  
        return JSON.stringify(artist);
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },
  };

• src/types/artist.ts:8-10 (schema)

  Input schema (Zod) for the 'get_artist' tool, requiring an artist_id number.

  export const ArtistIdParamSchema = z.object({
    artist_id: z.number(),
  });

• src/tools/database.ts:261-261 (registration)

  Registers the 'get_artist' tool on the MCP server within registerDatabaseTools.

  server.addTool(getArtistTool);

• src/tools/index.ts:15-24 (registration)

  Top-level tool registration function that invokes registerDatabaseTools, indirectly registering 'get_artist'.

  export function registerTools(server: FastMCP): void {
    registerDatabaseTools(server);
    registerMarketplaceTools(server);
    registerInventoryExportTool(server);
    registerUserIdentityTools(server);
    registerUserCollectionTools(server);
    registerUserWantlistTools(server);
    registerUserListsTools(server);
    registerMediaTools(server);
  }