get_user_contributions
Retrieve a user's contributions on Discogs by specifying their username, with options to sort by criteria like label, artist, or year, and control pagination for organized results.
Instructions
Retrieve a user's contributions by username
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| per_page | No | ||
| sort | No | ||
| sort_order | No | ||
| username | Yes |
Implementation Reference
- src/tools/userIdentity.ts:71-86 (handler)The MCP tool handler (execute function) for 'get_user_contributions', which uses UserContributionsService to fetch and return the user's contributions.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)Zod schema for input parameters of the get_user_contributions tool, combining username input with query filters.export const ContributionsParamsSchema = UsernameInputSchema.merge( QueryParamsSchema([ 'label', 'artist', 'title', 'catno', 'format', 'rating', 'year', 'added', ] as const), );
- src/tools/userIdentity.ts:107-113 (registration)Registration function that adds the getUserContributionsTool (among others) to the FastMCP server.export function registerUserIdentityTools(server: FastMCP): void { server.addTool(getUserIdentityTool); server.addTool(getUserProfileTool); server.addTool(editUserProfileTool); server.addTool(getUserSubmissionsTool); server.addTool(getUserContributionsTool); }
- src/tools/index.ts:15-24 (registration)Top-level tool registration function that calls registerUserIdentityTools, indirectly registering get_user_contributions.export function registerTools(server: FastMCP): void { registerDatabaseTools(server); registerMarketplaceTools(server); registerInventoryExportTool(server); registerUserIdentityTools(server); registerUserCollectionTools(server); registerUserWantlistTools(server); registerUserListsTools(server); registerMediaTools(server); }