Discogs MCP Server

Instructions

Implementation Reference

• src/tools/inventoryExport.ts:69-82 (handler)

  The main handler implementation for the 'inventory_export' MCP tool. It creates an InventoryService instance and calls its export() method to request a CSV export of the user's inventory.

  export const inventoryExportTool: Tool<FastMCPSessionAuth, ToolParameters> = {
    name: 'inventory_export',
    description: 'Request an export of your inventory as a CSV',
    parameters: z.object({}),
    execute: async () => {
      try {
        const inventoryService = new InventoryService();
        await inventoryService.export();
  
        return 'Inventory export requested';
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },

• src/tools/inventoryExport.ts:85-90 (registration)

  Function that registers the 'inventory_export' tool (along with related export tools) with the FastMCP server instance.

  export function registerInventoryExportTool(server: FastMCP): void {
    server.addTool(inventoryExportTool);
    server.addTool(getInventoryExportsTool);
    server.addTool(getInventoryExportTool);
    server.addTool(downloadInventoryExportTool);
  }

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

  Call within the top-level registerTools function that invokes the registration of the inventory export tools, including 'inventory_export'.

  registerInventoryExportTool(server);

• src/services/inventory.ts:44-54 (helper)

  Helper method in InventoryService that performs the actual POST request to '/inventory/export' to trigger the inventory export.

  async export(): Promise<void> {
    try {
      await this.request<void>('/export', {
        method: 'POST',
      });
    } catch (error) {
      if (isDiscogsError(error)) {
        throw error;
      }
      throw new Error(`Failed to export inventory: ${String(error)}`);
    }