Superprecio MCP Server

Search for products by name or description across all Argentina supermarkets.

This tool searches multiple supermarkets simultaneously and returns price comparisons. It's perfect for finding the best deals and comparing prices across different stores.

The search is smart and handles:

• Spanish characters and accents (café, leche, etc.)

• Partial matches

• Common product names

• Brand names

Results include:

• Product images

• Prices

• Direct links to products

• Supermarket information

• Availability across stores

Search for a specific product by its EAN/barcode across all supermarkets.

This tool is perfect for:

• Finding exact product matches

• Scanning barcodes

• Price checking specific items

• Verifying product availability

The barcode/EAN search will find the exact same product across different stores, making it ideal for precise price comparisons.

Compare prices for a product across all supermarkets and find the best deal.

This tool analyzes prices and provides:

• Lowest price and which supermarket has it

• Highest price for comparison

• Average price across all stores

• Potential savings

• Price differences between stores

Perfect for making informed buying decisions and finding the best deals.

Find the best deals and discounts currently available in supermarkets.

This tool helps you discover:

• Products on sale

• Best price-to-value items

• Popular deals

• Discount opportunities

Great for budget shopping and finding savings across all stores.

Send a push notification to a specific device or broadcast to all subscribed devices.

This tool can:

• Send personalized notifications to specific devices

• Broadcast alerts to all users

• Include custom data (like product links, images, etc.)

• Notify about price drops, deals, or important updates

Note: Requires Firebase Cloud Messaging setup on the Superprecio server.

Subscribe a device to receive push notifications about deals and price alerts.

This tool registers a device token with the Superprecio notification system. Once subscribed, devices will receive:

• Price drop alerts

• Special deal notifications

• New product announcements

• Custom promotional messages

Note: Requires a valid Firebase Cloud Messaging device token.

Create a new shopping list to organize your purchases.

You can create an empty list and add items later, or create a list with items right away. This is useful for planning your shopping and then optimizing which supermarket to buy from.

Features:

• Create named lists (e.g., "Weekly groceries", "Party supplies")

• Add optional description

• Include initial items with quantities

• Link to user ID (optional)

Add products to an existing shopping list.

You can add multiple items at once, each with:

• Product name (required)

• Barcode for exact matching (optional)

• Quantity (default: 1)

• Notes for specifications (optional)

Perfect for building up your shopping list before optimizing.

Get all shopping lists, optionally filtered by user.

Returns a list of all active shopping lists with their items. Useful for:

• Viewing all your saved lists

• Finding a specific list to optimize

• Managing multiple shopping lists

🔥 OPTIMIZE YOUR SHOPPING - Find the best supermarket for your entire shopping list!

This is the most powerful feature. It:

1. Searches for every product in your list across ALL supermarkets

2. Calculates the total cost at each supermarket

3. Shows you exactly how much you'll save by choosing the cheapest option

4. Provides a complete breakdown with prices per item

Perfect for:

• Maximizing your savings

• Planning where to shop

• Comparing complete shopping costs

• Making informed decisions

The tool searches ALL active supermarkets in Argentina and tells you which one gives you the best total price for your entire basket.

Delete a shopping list.

This removes the list and all its items from the active lists. The list is soft-deleted (marked as inactive) so it can be recovered if needed.

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"

Get all your active price alerts with their current status.

View all products you're monitoring and see:

• Current prices vs. target prices

• Which alerts have been triggered

• How close you are to your target price

• Last time prices were checked

Perfect for:

• Reviewing all your alerts

• Finding triggered alerts (good deals!)

• Managing your watchlist

Delete a price alert.

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

Find supermarkets near your current location using GPS coordinates.

Discover which supermarkets are closest to you!

Features:

• Search by latitude and longitude

• Customizable search radius (default: 5km)

• Get distance in km and meters

• See full addresses and contact info

• Opening hours when available

Perfect for:

• Finding nearby stores after optimizing your shopping list

• Planning your shopping route

• Discovering new supermarkets in your area

• Getting directions to the best-priced store

Example coordinates for Buenos Aires city center:

• Latitude: -34.6037

• Longitude: -58.3816

The tool uses the Haversine formula to calculate accurate distances.