saq-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@saq-mcp show me new arrivals in red wine"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Full-text search with filters: category, country, region, grape, price, availability |
| Product details by SKU (country, region, grape, ABV, sugar, taste profile, rating, store count) |
| Products sorted by arrival date, optionally filtered by category |
| Products with "Available shortly" or "Lottery soon" status |
| Which stores currently carry a product |
| Add a SKU to the restock watchlist |
| Remove from watchlist |
| Monitor the entire SAQ catalog (~35k products) for any restock |
| Disable catalog-wide monitoring |
| Manually trigger a restock check for all watched products |
| Show watchlist status and last snapshot |
| Restrict restock alerts to stores within a radius of a city or coordinates |
| 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 buildAdd 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.shThis 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 --notifyGeographic filtering
Restock alerts can be scoped to stores within a configurable radius:
# In Claude:
set_location_filter city="Montréal" radius_km=30The 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 |
| Cached API key (extracted once from the SAQ website) |
| Watched SKUs, store snapshots, location filter |
| Full catalog snapshot for watch-all mode |
| SAQ store directory with coordinates (refreshed weekly) |
| Append-only log of every watcher run |
None of these files are committed to git.
License
MIT
Available Tools
15 toolscellartracker_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
Scored across 15 tools
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.
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.
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.
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
MCP server for the Émile wine cellar — list, add, recommend, scan and search 100k+ wines.
Unofficial read-only MCP server for VeryChic hotel offers
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.2142 PyPI19MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables web search with category support, website content scraping with citation metadata, and timezone-aware date/time tools.55MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to search for alcohol products, manage shopping carts, and place orders on Drizly. It uses browser automation to check product availability, discover local stores, and track delivery status.12MIT
- FlicenseAqualityBmaintenanceA 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.7255 npm44-