Skip to main content
Glama
saq-mcp
by MonoPaul

saq-mcp

A Model Context Protocol server for SAQ.com (Société des alcools du Québec).

Search wines and spirits, track new arrivals, monitor restocks, and filter alerts by geographic area — all from Claude or any MCP-compatible client.

Features

Tool

Description

search_products

Full-text search with filters: category, country, region, grape, price, availability

get_product

Product details by SKU (country, region, grape, ABV, sugar, taste profile, rating, store count)

get_new_arrivals

Products sorted by arrival date, optionally filtered by category

get_coming_soon

Products with "Available shortly" or "Lottery soon" status

check_store_availability

Which stores currently carry a product

watch_product

Add a SKU to the restock watchlist

unwatch_product

Remove from watchlist

watch_all

Monitor the entire SAQ catalog (~35k products) for any restock

unwatch_all

Disable catalog-wide monitoring

check_restocks

Manually trigger a restock check for all watched products

list_watched

Show watchlist status and last snapshot

set_location_filter

Restrict restock alerts to stores within a radius of a city or coordinates

clear_location_filter

Remove geographic filter

Related MCP server: MCP SearXNG Enhanced

How it works

SAQ's website runs on Adobe Commerce with the Live Search catalog service. On first run, a headless Chromium browser intercepts an outgoing request to catalog-service.adobe.io to extract the public API key, which is then cached locally. All subsequent calls go directly to the GraphQL endpoint — no browser overhead.

Restock detection compares each product's store_availability_list (a full list of store IDs returned inline by the search API) against a saved snapshot. A restock fires when new store IDs appear or availability status improves (e.g. Sold out → In store).

Requirements

  • Node.js 20+

  • macOS (for the launchd agent; the MCP server itself is cross-platform)

Installation

git clone https://github.com/MonoPaul/saq-mcp.git
cd saq-mcp
npm install
npx playwright install chromium   # one-time: downloads headless browser
npm run build

Add to Claude Code

Add to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "saq": {
      "command": "node",
      "args": ["/path/to/saq-mcp/dist/index.js"]
    }
  }
}

Schedule daily restock checks (macOS)

bash install.sh

This fills in the com.saq-mcp.watcher.plist.template with your local paths, writes it to ~/Library/LaunchAgents/, and loads it with launchctl. The watcher runs daily at 05:30 and sends a macOS notification for any restock detected.

You can also run it manually at any time:

node dist/watcher.js --notify

Geographic filtering

Restock alerts can be scoped to stores within a configurable radius:

# In Claude:
set_location_filter city="Montréal" radius_km=30

The city is geocoded using SAQ's own store directory (no external geocoding API). The filter applies to both individually watched products and the full catalog scan.

Data stored locally

All runtime data lives in ~/.saq-mcp/:

File

Contents

credentials.json

Cached API key (extracted once from the SAQ website)

watchlist.json

Watched SKUs, store snapshots, location filter

catalog-snapshot.json

Full catalog snapshot for watch-all mode

stores.json

SAQ store directory with coordinates (refreshed weekly)

restock.log

Append-only log of every watcher run

None of these files are committed to git.

License

MIT

Available Tools

15 tools
cellartracker_statusA

Show whether CellarTracker enrichment is configured for the daily email.

Inputs: no named parameters.

check_restocksA

Check all watched products for restock events right now. Compares current SAQ availability against saved snapshots.

Inputs: notify.

check_store_availabilityB

Check which SAQ stores have a specific product in stock

Inputs: sku (required).

clear_location_filterA

Remove the geographic filter — restock alerts will cover all SAQ stores in Quebec

Inputs: no named parameters.

get_coming_soonC

Get products that are coming soon (not yet available / pre-release), including upcoming lottery products

Inputs: page, category, page_size.

get_new_arrivalsC

Get the latest new arrivals on SAQ.com, sorted by arrival date (most recent first)

Inputs: page, category, page_size.

get_productA

Get full details for a specific SAQ product by its SKU/code

Inputs: sku (required).

list_watchedA

Show all products on the restock watchlist with their current snapshot status

Inputs: no named parameters.

search_productsC

Search SAQ products by query, category, country, grape variety, price range, etc.

Inputs: page, grape, query, region, +8 more.

set_location_filterA

Restrict restock alerts to SAQ stores within a radius of a city or coordinates. Applies to both individual SKU watching and watch-all catalog scans.

Inputs: lat, lng, city, radius_km.

setup_cellartrackerA

Configure CellarTracker credentials so the daily email includes community scores and average prices. Credentials are saved to ~/.saq-mcp/cellartracker.json and used only by the watcher daemon.

Inputs: password (required), username (required).

unwatch_allA

Disable full-catalog restock monitoring (catalog snapshot is kept on disk)

Inputs: no named parameters.

unwatch_productA

Remove a product from the restock watchlist

Inputs: sku (required).

watch_allA

Enable full-catalog restock monitoring. The daily watcher will scan every SAQ product and alert on any store count increase or availability improvement.

Inputs: no named parameters.

watch_productB

Add a SAQ product to the restock watchlist. The watcher will alert when it becomes available at new stores.

Inputs: sku (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose. For example, watch_product vs watch_all are differentiated by scope, and check_restocks vs check_store_availability target different actions. All descriptions are explicit enough to avoid confusion.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., search_products, set_location_filter), but cellartracker_status breaks this pattern by starting with a noun instead of a verb. This is a minor deviation in an otherwise uniform set.

    Tool Count5/5

    15 tools is well-scoped for the domain of product search, restock monitoring, and CellarTracker integration. Each tool serves a specific function without unnecessary redundancy, and the count is within the ideal range for a focused MCP server.

    Completeness4/5

    The tool set covers the core workflows: product discovery, watchlist management, restock checking, location filtering, and CellarTracker setup. Minor gaps exist, such as the absence of store details retrieval or credential management, but these do not hinder the main use cases.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.
      2
      142 PyPI
      19
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.
      7
      255 npm
      44
      -