remove_price_alert

Delete a price alert to stop monitoring a product's price. This action permanently removes the alert from your tracking list.

Instructions

Delete a price alert.

Stop monitoring a product's price. This permanently removes the alert.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`alertId`	Yes	ID of the price alert to delete

Implementation Reference

src/tools/removePriceAlert.ts:25-59 (handler)

The main handler function that executes the tool: deletes the price alert using the API client and returns a formatted text response indicating success or failure.

export async function executeRemovePriceAlert(
  client: SuperPrecioApiClient,
  args: { alertId: number }
) {
  const response = await client.deletePriceAlert(args.alertId);

  if (!response.success) {
    return {
      content: [
        {
          type: 'text',
          text: `Failed to delete price alert: ${response.message || 'Unknown error'}`,
        },
      ],
      isError: true,
    };
  }

  return {
    content: [
      {
        type: 'text',
        text: `
✅ Price alert deleted successfully!

Alert ID ${args.alertId} has been removed and you will no longer receive notifications for this product.

You can:
- View remaining alerts with get_my_alerts
- Create a new alert with set_price_alert
`,
      },
    ],
  };
}

src/tools/removePriceAlert.ts:7-23 (schema)

Tool metadata and input schema definition: requires a numeric alertId.

export const removePriceAlertTool = {
  name: 'remove_price_alert',
  description: `Delete a price alert.

Stop monitoring a product's price.
This permanently removes the alert.`,
  inputSchema: {
    type: 'object',
    properties: {
      alertId: {
        type: 'number',
        description: 'ID of the price alert to delete',
      },
    },
    required: ['alertId'],
  },
};

src/index.ts:89-116 (registration)

Registers the tool by including removePriceAlertTool in the tools list returned for ListTools requests.

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // V1 Tools
      searchProductsTool,
      searchByCodeTool,
      comparePriceTool,
      getBestDealsTool,
      sendNotificationTool,
      subscribeDeviceTool,

      // V2 Tools - Shopping Lists
      createShoppingListTool,
      addItemsToListTool,
      getShoppingListsTool,
      optimizeShoppingListTool,
      removeShoppingListTool,

      // V2 Tools - Price Alerts
      setPriceAlertTool,
      getMyAlertsTool,
      removePriceAlertTool,

      // V2 Tools - Location
      findNearbySupermarketsTool,
    ],
  };
});

src/index.ts:166-167 (registration)
Registers the handler by dispatching tool calls with name 'remove_price_alert' to executeRemovePriceAlert in the CallTool request handler.
```
case 'remove_price_alert':
  return await executeRemovePriceAlert(apiClient, args as any);
```

src/index.ts:46-46 (registration)

Imports the tool definition and handler function.

import { removePriceAlertTool, executeRemovePriceAlert } from './tools/removePriceAlert.js';

Superprecio MCP Server