saq-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_productsC | Search SAQ products by query, category, country, grape variety, price range, etc. |
| get_new_arrivalsC | Get the latest new arrivals on SAQ.com, sorted by arrival date (most recent first) |
| get_coming_soonC | Get products that are coming soon (not yet available / pre-release), including upcoming lottery products |
| get_productA | Get full details for a specific SAQ product by its SKU/code |
| check_store_availabilityB | Check which SAQ stores have a specific product in stock |
| 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. |
| clear_location_filterA | Remove the geographic filter — restock alerts will cover all SAQ stores in Quebec |
| 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. |
| unwatch_allA | Disable full-catalog restock monitoring (catalog snapshot is kept on disk) |
| watch_productB | Add a SAQ product to the restock watchlist. The watcher will alert when it becomes available at new stores. |
| unwatch_productA | Remove a product from the restock watchlist |
| list_watchedA | Show all products on the restock watchlist with their current snapshot status |
| check_restocksA | Check all watched products for restock events right now. Compares current SAQ availability against saved snapshots. |
| 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. |
| cellartracker_statusA | Show whether CellarTracker enrichment is configured for the daily email. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.