Discogs MCP Server

Instructions

Implementation Reference

• src/tools/userIdentity.ts:71-86 (handler)

  MCP tool definition for 'get_user_contributions', including the execute handler that calls UserContributionsService.get(args) and returns JSON.

  export const getUserContributionsTool: Tool<FastMCPSessionAuth, typeof ContributionsParamsSchema> =
    {
      name: 'get_user_contributions',
      description: `Retrieve a user's contributions by username`,
      parameters: ContributionsParamsSchema,
      execute: async (args) => {
        try {
          const userContributionsService = new UserContributionsService();
          const contributions = await userContributionsService.get(args);
  
          return JSON.stringify(contributions);
        } catch (error) {
          throw formatDiscogsError(error);
        }
      },
    };

• src/types/user/contribution.ts:18-29 (schema)

  Input parameters schema for the get_user_contributions tool, combining username input with query parameters for filtering contributions.

  export const ContributionsParamsSchema = UsernameInputSchema.merge(
    QueryParamsSchema([
      'label',
      'artist',
      'title',
      'catno',
      'format',
      'rating',
      'year',
      'added',
    ] as const),
  );

• src/tools/userIdentity.ts:112-112 (registration)

  Registers the get_user_contributions tool on the FastMCP server.

  server.addTool(getUserContributionsTool);

• src/services/user/contribution.ts:21-36 (helper)

  Core logic in UserContributionsService.get() that fetches contributions from Discogs API endpoint '/{username}/contributions', handles errors, and validates response.

  async get({ username, ...options }: ContributionsParams): Promise<ContributionsResponse> {
    try {
      const response = await this.request<ContributionsResponse>(`/${username}/contributions`, {
        params: options,
      });
  
      const validatedResponse = ContributionsResponseSchema.parse(response);
      return validatedResponse;
    } catch (error) {
      if (isDiscogsError(error)) {
        throw error;
      }
  
      throw new Error(`Failed to get user contributions: ${String(error)}`);
    }
  }