Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Show this month's Data API credit usage for the API key: credits used, monthly limit, credits remaining and request count. No credits used. Without a key there is no credit account; anonymous use is limited to 10 tool calls a minute and 100 an hour instead.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http shopsavvy-mcp-server https://api.shopsavvy.com/mcp
Show this month's Data API credit usage for the API key: credits used, monthly limit, credits remaining and request count. No credits used. Without a key there is no credit account; anonymous use is limited to 10 tool calls a minute and 100 an hour instead.
No arguments.
{
"type": "object",
"properties": {}
}Search ShopSavvy's published 'best of' buying guides (for example 'gaming laptop' or 'wireless earbuds') and return each guide's ranked picks with a short reason and a link to the full guide on shopsavvy.com. Use it for category research, then check current prices with product_offers. Free without an API key; with a key, 1 credit per guide returned (minimum 1). If no guide matches, say so; do not invent picks.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum articles to return (default: 5, max: 20) |
| query* | string | Search term or category (e.g., 'gaming laptop', 'wireless earbuds', 'smart tv', 'running shoes') |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum articles to return (default: 5, max: 20)"
},
"query": {
"type": "string",
"description": "Search term or category (e.g., 'gaming laptop', 'wireless earbuds', 'smart tv', 'running shoes')"
}
}
}When-to-buy guides for a product category or brand (for example 'Samsung TV', 'mattress' or 'Apple'): the months and sales events when prices usually drop, with a link to each guide on shopsavvy.com; set include_gift_guides for gift guides too. Pair it with product_price_history to answer 'buy now or wait?'. Free without an API key; with a key, 1 credit per guide returned (minimum 1). If no guide matches, say so; do not guess a sale date.
| Argument | Type | Description |
|---|---|---|
| query* | string | Product category or brand (e.g., 'Apple', 'Samsung TV', 'mattress', 'laptop') |
| include_gift_guides | boolean | Include gift guide articles in results (default: false) |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Product category or brand (e.g., 'Apple', 'Samsung TV', 'mattress', 'laptop')"
},
"include_gift_guides": {
"type": "boolean",
"description": "Include gift guide articles in results (default: false)"
}
}
}Published answers to common questions about one product, optionally filtered by a question phrase, each with a link to the full answer on shopsavvy.com. Pass an identifier (barcode, ASIN, URL, name or ShopSavvy ID). Free without an API key; with a key, 1 credit per 5 answers returned (minimum 1). If nothing matches, say there is no published answer; do not make one up.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum answers to return (default: 5, max: 20) |
| question | string | Optional: specific question to search for |
| identifier* | string | Product identifier (barcode, ASIN, URL, product name, or ShopSavvy ID) |
{
"type": "object",
"required": [
"identifier"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum answers to return (default: 5, max: 20)"
},
"question": {
"type": "string",
"description": "Optional: specific question to search for"
},
"identifier": {
"type": "string",
"description": "Product identifier (barcode, ASIN, URL, product name, or ShopSavvy ID)"
}
}
}Short review summary for one product from ShopSavvy's published TLDR reviews: an overall score out of 10 where available, pros, cons and a bottom-line verdict. Pass an identifier (barcode, ASIN, URL, name or ShopSavvy ID) or the product_path from an earlier result. Free without an API key; 1 credit with a key when a review exists. If no review exists for the product, say so; do not write one yourself.
| Argument | Type | Description |
|---|---|---|
| identifier | string | Product identifier (barcode, ASIN, URL, product name, or ShopSavvy ID) |
| product_path | string | Direct product path if known (e.g., 'products/abc123') |
{
"type": "object",
"anyOf": [
{
"required": [
"identifier"
]
},
{
"required": [
"product_path"
]
}
],
"properties": {
"identifier": {
"type": "string",
"description": "Product identifier (barcode, ASIN, URL, product name, or ShopSavvy ID)"
},
"product_path": {
"type": "string",
"description": "Direct product path if known (e.g., 'products/abc123')"
}
}
}Look up one product and return its ShopSavvy record: title, brand, model, MPN, barcode, Amazon ASIN and ShopSavvy ID (pass that ID to every follow-up tool), plus a link to its ShopSavvy page. Accepts a barcode (UPC/EAN/ISBN), ASIN, product URL, model number, ShopSavvy ID or a product name; barcodes, ASINs and URLs match most reliably, while a name can resolve to a different size or variant. Use product_search instead when you only have a keyword and want a list. Free without an API key; 1 credit with a key. If nothing is found, say that no data was found; do not guess.
| Argument | Type | Description |
|---|---|---|
| identifier* | string | Product identifier (barcode/UPC/EAN, ASIN, product URL, model number, product name, or ShopSavvy ID) |
{
"type": "object",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string",
"description": "Product identifier (barcode/UPC/EAN, ASIN, product URL, model number, product name, or ShopSavvy ID)"
}
}
}Look up several products in one call from a comma-separated list of identifiers (barcodes, ASINs, URLs, model numbers or ShopSavvy IDs) and return the product_lookup fields for each one found. Use it when comparing two or more specific products. Free without an API key; 1 credit per product found with a key. Identifiers that match nothing are left out of the result: report those as not found rather than guessing.
| Argument | Type | Description |
|---|---|---|
| identifiers* | string | Comma-separated list of product identifiers (barcodes, ASINs, URLs, etc.) |
{
"type": "object",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "string",
"description": "Comma-separated list of product identifiers (barcodes, ASINs, URLs, etc.)"
}
}
}Current prices for one product at every retailer ShopSavvy has an offer from, lowest price first: retailer, price, availability, condition, marketplace seller, when the offer was last checked, and a link; then any in-store shelf prices read from shoppers' receipts (store, address, receipt date; labeled user-collected, a price on that day, not current stock); followed by a source line naming ShopSavvy with the product page link (cite it when you quote prices). Online prices are in US dollars. Use product_offers_retailer for a single store and product_price_history for past prices; a barcode, ASIN or ShopSavvy ID gives the most reliable match. Free without an API key; 3 credits with a key, nothing when no offers or in-store prices are found. If no offers are returned, say no current prices were found; do not estimate a price.
| Argument | Type | Description |
|---|---|---|
| identifier* | string | Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID) |
{
"type": "object",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string",
"description": "Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID)"
}
}
}Current prices for one product at a single retailer, given as a domain such as amazon.com, bestbuy.com or target.com: each offer from that store (including marketplace sellers) with price, availability, condition, when it was last checked and a link, followed by a ShopSavvy source line. Prices are in US dollars. Use product_offers to compare every retailer at once. Free without an API key; 2 credits with a key, nothing when no offers are found. If that retailer has no offer, say so; do not substitute another store's price.
| Argument | Type | Description |
|---|---|---|
| retailer* | string | Retailer domain name (e.g., 'amazon.com', 'bestbuy.com', 'target.com') |
| identifier* | string | Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID) |
{
"type": "object",
"required": [
"identifier",
"retailer"
],
"properties": {
"retailer": {
"type": "string",
"description": "Retailer domain name (e.g., 'amazon.com', 'bestbuy.com', 'target.com')"
},
"identifier": {
"type": "string",
"description": "Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID)"
}
}
}Recorded prices for one product between start_date and end_date (YYYY-MM-DD, both today or earlier), grouped by retailer, each point with its date, price and availability, followed by a ShopSavvy source line. Optionally pass a retailer domain to limit it to one store. Use it to judge whether today's price is a good deal or when a product was cheapest; use product_offers for current prices. History goes back to 2011 for some products and is dense from 2019; the window is capped, so request long periods in narrower slices if the server says the range is too wide. Free without an API key; with a key, 1 credit per day in the window plus 3 (2 with a retailer filter), nothing when no history is found. If no history is returned, say there is no recorded history for that window; do not infer one.
| Argument | Type | Description |
|---|---|---|
| end | string | Alias for 'end_date' (the REST spelling). End date in YYYY-MM-DD format. |
| start | string | Alias for 'start_date' (the REST spelling). Start date in YYYY-MM-DD format. |
| end_date | string | End date in YYYY-MM-DD format (e.g., '2024-01-31'). Alias: 'end' (the REST spelling) is also accepted. |
| retailer | string | Optional: specific retailer domain name to filter results |
| identifier* | string | Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID) |
Schedule products (comma-separated identifiers) for automatic price re-checks hourly, daily or weekly, optionally at one retailer, so later product_offers and product_price_history calls return fresher prices. Requires a Data API key: schedules belong to the key's account (see scheduled_products_list). Scheduled re-checks run on that cadence for retailers ShopSavvy can re-check through an official retailer API; other retailers update as ShopSavvy sees them. 1 credit per product scheduled.
| Argument | Type | Description |
|---|---|---|
| retailer | string | Optional: specific retailer domain to monitor |
| schedule* | string | Monitoring frequency |
| identifiers* | string | Comma-separated list of product identifiers |
{
"type": "object",
"required": [
"identifiers",
"schedule"
],
"properties": {
"retailer": {
"type": "string",
"description": "Optional: specific retailer domain to monitor"
},
"schedule": {
"enum": [
"hourly",
"daily",
"weekly"
],
"type": "string",
"description": "Monitoring frequency"
},
"identifiers": {
"type": "string",
"description": "Comma-separated list of product identifiers"
}
}
}Keyword search over the ShopSavvy catalog. Returns ranked products (title, brand, identifiers and ShopSavvy ID), best match first, paginated with limit (default 20, max 100) and offset. Use it when the user names a product type or partial name; use product_lookup for an exact barcode, ASIN or URL, and universal_search for broad 'best X' category questions where reviews help. Free without an API key; 1 credit per product returned with a key. If no products match, say so; do not invent products.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of results to return (default: 20, max: 100) |
| query* | string | Search query or keyword (e.g., 'iphone 15 pro', 'samsung tv', 'nike shoes') |
| offset | number | Offset for pagination (default: 0) |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of results to return (default: 20, max: 100)"
},
"query": {
"type": "string",
"description": "Search query or keyword (e.g., 'iphone 15 pro', 'samsung tv', 'nike shoes')"
},
"offset": {
"type": "number",
"description": "Offset for pagination (default: 0)"
}
}
}Stop scheduled price re-checks for the given comma-separated identifiers on the API key's account. Requires a Data API key. No credits used.
| Argument | Type | Description |
|---|---|---|
| identifiers* | string | Comma-separated list of product identifiers to unschedule |
{
"type": "object",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "string",
"description": "Comma-separated list of product identifiers to unschedule"
}
}
}List the products scheduled for automatic price re-checks on the API key's account, grouped by frequency, with ShopSavvy ID, barcode, ASIN and retailer filter. Requires a Data API key. No credits used.
No arguments.
{
"type": "object",
"properties": {}
}Category search with pre-computed rankings for broad queries such as 'gaming laptop', '85 inch tv' or 'air fryer': returns the top-ranked products with short review summaries and matching best-picks guides. Use it for open-ended 'what should I buy' questions; use product_search for a specific product name and product_lookup for an exact identifier, then product_offers for prices. Free without an API key; with a key, 2 credits plus 1 per product review and 1 per guide included. If nothing ranks for the query, say so; do not invent products.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum products to return (default: 10, max: 50) |
| query* | string | Search query (e.g., 'gaming laptop', '85 inch tv', 'running shoes', 'air fryer') |
| include_reviews | boolean | Include TLDR review summaries in results (default: true) |
| include_best_picks | boolean | Include matching best picks articles (default: true) |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum products to return (default: 10, max: 50)"
},
"query": {
"type": "string",
"description": "Search query (e.g., 'gaming laptop', '85 inch tv', 'running shoes', 'air fryer')"
},
"include_reviews": {
"type": "boolean",
"description": "Include TLDR review summaries in results (default: true)"
},
"include_best_picks": {
"type": "boolean",
"description": "Include matching best picks articles (default: true)"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| start_date |
| string |
| Start date in YYYY-MM-DD format (e.g., '2024-01-01'). Alias: 'start' (the REST spelling) is also accepted. |
{
"type": "object",
"anyOf": [
{
"required": [
"start_date",
"end_date"
]
},
{
"required": [
"start_date",
"end"
]
},
{
"required": [
"start",
"end_date"
]
},
{
"required": [
"start",
"end"
]
}
],
"required": [
"identifier"
],
"properties": {
"end": {
"type": "string",
"description": "Alias for 'end_date' (the REST spelling). End date in YYYY-MM-DD format."
},
"start": {
"type": "string",
"description": "Alias for 'start_date' (the REST spelling). Start date in YYYY-MM-DD format."
},
"end_date": {
"type": "string",
"description": "End date in YYYY-MM-DD format (e.g., '2024-01-31'). Alias: 'end' (the REST spelling) is also accepted."
},
"retailer": {
"type": "string",
"description": "Optional: specific retailer domain name to filter results"
},
"identifier": {
"type": "string",
"description": "Product identifier (barcode, ASIN, URL, model number, product name, or ShopSavvy ID)"
},
"start_date": {
"type": "string",
"description": "Start date in YYYY-MM-DD format (e.g., '2024-01-01'). Alias: 'start' (the REST spelling) is also accepted."
}
}
}