MCP Art Supply Store

Instructions

Implementation Reference

• src/index.ts:770-789 (handler)

  Handler function for 'get_best_sellers' tool. Filters inventory by optional category, sorts by price descending (as proxy for best sellers), returns top 5 with details.

  case 'get_best_sellers': {
    const category = args?.category ? String(args.category) : null;
    const period = String(args?.period || 'week');
    
    let items = storeData.inventory;
    if (category) {
      items = items.filter(i => i.category.toLowerCase() === category.toLowerCase());
    }
    
    const bestSellers = items.sort((a, b) => b.price - a.price).slice(0, 5);
    
    return {
      content: [{
        type: 'text',
        text: `🏆 Best Sellers${category ? ` in ${category}` : ''} (${period}):\n\n${bestSellers.map((item, i) =>
          `${i + 1}. ${item.name}\n   Price: $${item.price} | In stock: ${item.quantity}`
        ).join('\n\n')}`
      }]
    };
  }

• src/index.ts:187-198 (schema)

  Input schema definition for the 'get_best_sellers' tool, specifying parameters category (optional) and period (required).

  {
    name: 'get_best_sellers',
    description: 'Get top-selling products by category or overall, with quantity sold and revenue generated.',
    inputSchema: {
      type: 'object',
      properties: {
        category: { type: 'string', description: 'Optional: filter by category' },
        period: { type: 'string', description: 'Time period: week, month, quarter, year' },
      },
      required: ['period'],
    },
  },

• src/index.ts:516-518 (registration)

  Registration of all tools list handler, which includes 'get_best_sellers' in the tools array.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools };
  });

• src/dashboard.ts:49-49 (registration)

  Mock tool listing in dashboard server for UI display.

  { name: 'get_best_sellers', description: 'Top selling products', category: 'Sales & Analytics' },