inventory_export

Instructions

Implementation Reference

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

  The 'inventory_export' MCP tool handler. It creates an InventoryService instance, calls the export() method, and returns a confirmation string.

  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/services/inventory.ts:44-55 (helper)

  The service method that performs the actual API call for inventory export. Sends a POST request to /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)}`, { cause: error });
    }
  }

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

  Registers the inventory_export tool (and related export tools) with the FastMCP server.

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

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

  Import and invocation of registerInventoryExportTool from the main tools registration function.

  import { registerInventoryExportTool } from './inventoryExport.js';
  import { registerMarketplaceTools } from './marketplace.js';
  import { registerMediaTools } from './media.js';
  import { registerUserCollectionTools } from './userCollection.js';
  import { registerUserIdentityTools } from './userIdentity.js';
  import { registerUserListsTools } from './userLists.js';
  import { registerUserWantlistTools } from './userWantlist.js';
  
  /**
   * Registers all MCP tools with the server
   * @param server The FastMCP server instance
   */
  export function registerTools(server: FastMCP): void {
    registerDatabaseTools(server);
    registerMarketplaceTools(server);
    registerInventoryExportTool(server);
    registerUserIdentityTools(server);
    registerUserCollectionTools(server);
    registerUserWantlistTools(server);
    registerUserListsTools(server);
    registerMediaTools(server);
  }

• src/types/inventory.ts:1-7 (schema)

  Schema and type definitions for inventory exports. Includes InventoryIdParamSchema, InventoryExportItemSchema, and InventoryExportsResponseSchema.

  import { z } from 'zod';
  import { urlOrEmptySchema } from '../utils.js';
  import { PaginatedResponseSchema } from './common.js';
  
  export const InventoryIdParamSchema = z.object({
    id: z.number(),
  });