Superprecio MCP Server

Instructions

Implementation Reference

• src/tools/setPriceAlert.ts:56-113 (handler)

  The main handler function that executes the set_price_alert tool logic: calls the API to create a price alert, handles success/error, and formats a detailed response with alert info.

  export async function executeSetPriceAlert(
    client: SuperPrecioApiClient,
    args: {
      productName: string;
      targetPrice: number;
      barcode?: string;
      userId?: number;
      notifyEnabled?: boolean;
    }
  ) {
    const response = await client.createPriceAlert(args);
  
    if (!response.success) {
      return {
        content: [
          {
            type: 'text',
            text: `Failed to create price alert: ${response.message || 'Unknown error'}`,
          },
        ],
        isError: true,
      };
    }
  
    const alert = response.data;
  
    const summary = `
  🔔 Price Alert Created Successfully!
  
  📦 Product: ${alert.productName}
  ${alert.barcode ? `🏷️  Barcode: ${alert.barcode}` : ''}
  🎯 Target Price: $${alert.targetPrice.toLocaleString('es-AR')}
  🆔 Alert ID: ${alert.id}
  ${alert.notifyEnabled ? '✅ Notifications: Enabled' : '🔕 Notifications: Disabled'}
  📅 Created: ${new Date(alert.createdAt).toLocaleDateString('es-AR')}
  
  What happens now:
  1. We'll search for this product across all supermarkets
  2. When the price drops to $${alert.targetPrice} or below, you'll be notified
  3. Use get_my_alerts to check the status anytime
  4. Use remove_price_alert to cancel this alert
  
  💡 Tip: Run check_alert_status periodically to see current prices!
  `;
  
    return {
      content: [
        {
          type: 'text',
          text: summary,
        },
        {
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  }

• src/tools/setPriceAlert.ts:7-54 (schema)

  Defines the tool metadata including name 'set_price_alert', description, and inputSchema for parameter validation (productName, targetPrice required; barcode, userId, notifyEnabled optional).

  export const setPriceAlertTool = {
    name: 'set_price_alert',
    description: `Set a personalized price alert for a product.
  
  Get notified when a product reaches your target price!
  
  Features:
  - Monitor any product by name or barcode
  - Set your desired price target
  - Automatic price checking across all supermarkets
  - Get alerts when price drops below your target
  
  Perfect for:
  - Waiting for sales on expensive items
  - Tracking price drops
  - Budget-conscious shopping
  - Never missing a good deal
  
  Example: "Alert me when Coca Cola 2.25L drops below $800"`,
    inputSchema: {
      type: 'object',
      properties: {
        productName: {
          type: 'string',
          description: 'Product name to monitor (e.g., "Coca Cola 2.25L", "Arroz integral")',
        },
        targetPrice: {
          type: 'number',
          description: 'Target price in pesos - alert when product reaches or goes below this price',
          minimum: 0.01,
        },
        barcode: {
          type: 'string',
          description: 'Optional barcode/EAN for exact product matching',
        },
        userId: {
          type: 'number',
          description: 'Optional user ID to associate this alert with',
        },
        notifyEnabled: {
          type: 'boolean',
          description: 'Enable push notifications when alert triggers (default: true)',
          default: true,
        },
      },
      required: ['productName', 'targetPrice'],
    },
  };

• src/index.ts:160-161 (registration)

  Registers the tool handler in the MCP server's CallToolRequestSchema switch statement, dispatching calls to executeSetPriceAlert.

  case 'set_price_alert':
    return await executeSetPriceAlert(apiClient, args as any);

• src/index.ts:108-108 (registration)

  Includes setPriceAlertTool in the list of available tools returned by ListToolsRequestSchema.

  setPriceAlertTool,

• src/index.ts:44-44 (registration)

  Imports the tool definition and handler from the implementation file.

  import { setPriceAlertTool, executeSetPriceAlert } from './tools/setPriceAlert.js';