Superprecio

You transform Claude or any MCP-compatible AI into a trusted Argentina-focused price comparison assistant. This server exposes real-time supermarket prices, deals, and availability so you can help users save money and find the best offers across Argentina’s grocery landscape.

How to use

Install and run the MCP server, then connect it to your MCP client. You will access six tools that let you search products, find items by barcode, compare prices, discover current deals, and manage price alerts.

How to install

Prerequisites: install Node.js 18.0.0 or higher and ensure you can reach the Superprecio API (production) or a local instance.

Option 1: Use with npx (recommended) after publishing to npm. Run the MCP server with:

npx superprecio-mcp

Option 2: Install globally with npm:

npm install -g superprecio-mcp

Option 3: Local development flow. Clone the project, install dependencies, build, and run the server:

# Clone the repository
git clone https://github.com/bunkerapps/superprecio_mcp.git
cd superprecio_mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

Configuration and runtime

Create a configuration file and set your API endpoint and optional timeouts. The server uses an environment variable-based configuration. The key value pairs you’ll configure are shown here for reference.

# Superprecio API URL (required)
SUPERPRECIO_API_URL=https://superprecio.ar

# Request timeout in milliseconds (optional)
REQUEST_TIMEOUT=30000

# Enable debug logging (optional)
DEBUG=false

Usage with Claude Desktop

Connect the MCP server to Claude Desktop by configuring a local stdio or npm-based invocation. The example shows using npx to run the server, which keeps you aligned with a lightweight, drop-in workflow.

{
  "mcpServers": {
    "superprecio": {
      "command": "npx",
      "args": ["-y", "superprecio-mcp"]
    }
  }
}

Local development note

If you are running the server locally for development, override the API URL to point at your local instance.

{
  "mcpServers": {
    "superprecio": {
      "command": "node",
      "args": ["/absolute/path/to/superprecio_mcp/build/index.js"]
    }
  }
}

Available tools

search_products

Search for products by name across all supermarkets and return matching results with prices and store availability.

search_by_code

Find products by EAN or barcode to retrieve exact matches across supermarkets.

compare_prices

Compare prices for a given product across stores and identify the best deal.

get_best_deals

Discover current promotions and discounts by category to spot value offers.

send_notification

Send push notifications about deals to devices (requires Firebase setup).

subscribe_device

Subscribe a device to price alerts (requires Firebase).