get_marketplace_orders

Retrieve and filter marketplace orders from Discogs by status, date, and other criteria to manage sales and track transactions.

Instructions

Get a list of marketplace orders

Input Schema

TableJSON Schema

Name	Required	Description	Default
`status`	No
`created_after`	No
`created_before`	No
`archived`	No
`page`	No
`per_page`	No
`sort`	No
`sort_order`	No

Implementation Reference

src/tools/marketplace.ts:122-136 (handler)

The MCP tool handler (execute function) for 'get_marketplace_orders'. It creates a MarketplaceService instance and calls getOrders with the input args, returning the JSON stringified result or formatted error.

export const getMarketplaceOrdersTool: Tool<FastMCPSessionAuth, typeof OrdersParamsSchema> = {
  name: 'get_marketplace_orders',
  description: 'Get a list of marketplace orders',
  parameters: OrdersParamsSchema,
  execute: async (args) => {
    try {
      const marketplaceService = new MarketplaceService();
      const orders = await marketplaceService.getOrders(args);

      return JSON.stringify(orders);
    } catch (error) {
      throw formatDiscogsError(error);
    }
  },
};

src/types/marketplace.ts:210-217 (schema)

Zod schema defining the input parameters for the get_marketplace_orders tool, including optional status, date filters, archived flag, and query params.

export const OrdersParamsSchema = z
  .object({
    status: OrderStatusSchema.optional(),
    created_after: z.string().optional(),
    created_before: z.string().optional(),
    archived: z.boolean().optional(),
  })
  .merge(QueryParamsSchema(['id', 'buyer', 'created', 'status', 'last_activity'] as const));

src/tools/marketplace.ts:240-252 (registration)

Function that registers all marketplace tools, including getMarketplaceOrdersTool, to the FastMCP server. This function is called from src/tools/index.ts.

export function registerMarketplaceTools(server: FastMCP): void {
  server.addTool(getUserInventoryTool);
  server.addTool(getMarketplaceListingTool);
  server.addTool(createMarketplaceListingTool);
  server.addTool(updateMarketplaceListingTool);
  server.addTool(deleteMarketplaceListingTool);
  server.addTool(getMarketplaceOrderTool);
  server.addTool(editMarketplaceOrderTool);
  server.addTool(getMarketplaceOrdersTool);
  server.addTool(getMarketplaceOrderMessagesTool);
  server.addTool(createMarketplaceOrderMessageTool);
  server.addTool(getMarketplaceReleaseStatsTool);
}

src/services/marketplace.ts:205-220 (helper)

The MarketplaceService.getOrders method, which performs the actual API request to Discogs /marketplace/orders endpoint with params, validates response with OrdersResponseSchema, and handles errors.

async getOrders(params: OrdersParams): Promise<OrdersResponse> {
  try {
    const response = await this.request<OrdersResponse>(`/orders`, {
      params,
    });

    const validatedResponse = OrdersResponseSchema.parse(response);
    return validatedResponse;
  } catch (error) {
    if (isDiscogsError(error)) {
      throw error;
    }

    throw new Error(`Failed to get orders: ${String(error)}`);
  }
}

src/tools/index.ts:17-17 (registration)
Invocation of registerMarketplaceTools in the main registerTools function, which adds the get_marketplace_orders tool to the MCP server.
```
registerMarketplaceTools(server);
```

Discogs MCP Server