What you are setting up
Two price-data services plug into your AI assistant as "connectors" (the technical name is MCP server). Once connected, you can just ask questions like "is $89 a good price for this?" and the assistant looks up the real numbers.
Prices at every store
Current prices for one product across tens of thousands of retailers (Amazon, Walmart, Target, Best Buy and many more), plus price history going back years. Works with a barcode number, a product link, a model number or just the product name.
Deep Amazon history
The most detailed Amazon price history available: Amazon's own price vs. other sellers vs. used, plus long-term charts. Worth adding if most of your gifts come from Amazon. Needs a paid Keepa subscription and the Claude Desktop app.
What it costs
Up to 10 lookups per minute and 100 per hour. Plenty for a holiday gift list.
Includes basic data access: roughly one Amazon lookup every few minutes. Check the current price on keepa.com.
Much faster Amazon lookups. Only needed if the basic access feels slow.
14-day free trial. Higher limits for heavy use. Most people will not need this.
Recommendation: start with free ShopSavvy (Step 1). Add Keepa (Step 2) only if most of your list is Amazon and you use the Claude Desktop app. If you pay for anything, set a calendar reminder to cancel in early January.
Pick your path
Tap the AI tool you use and follow only the steps listed for it.
Why no Keepa on the web or in ChatGPT? Web-based assistants can only reach connectors hosted on the internet. Keepa's connector runs as a small program on your own computer, which only the desktop app and the developer tools can start.
Add ShopSavvy to Claude
You only do this once, on the web or in the desktop app. It then shows up on your phone too.
- Open claude.ai (or the Claude Desktop app) and go to . On some accounts this is under .
- Click (it may be behind a + button).
- For Name, type
ShopSavvy. - For Remote MCP server URL, paste this address:
https://api.shopsavvy.com/mcp
- Leave everything else blank and click . No account or password is needed.
- Start a new chat, click the + button under the message box, open and make sure ShopSavvy is switched on.
Plan notes. The free Claude plan allows one custom connector. On a Team or Enterprise (work) account, only an organization owner can add it; ask them to add the URL above under , then you click .
Add ShopSavvy to ChatGPT
ChatGPT calls this "Developer mode". It needs a paid plan (Plus, Pro, Business, Enterprise or Edu) and is set up on the ChatGPT website. Menu names shift a little between updates; look for the closest match.
- On chatgpt.com, click your name, then (sometimes just ).
- Open and turn on Developer mode. Accept the warning about unverified apps.
- Back in , click .
- Fill in: Name
ShopSavvy, DescriptionProduct prices and price history across retailers, and Server URL:https://api.shopsavvy.com/mcp
- For Authentication, choose . Tick and click .
- In a new chat, click +, choose (or ) and select ShopSavvy.
Add Keepa for detailed Amazon prices
This step involves pasting a few lines into a settings file. Take it slowly and it works fine. Keepa's connector is a free community-built tool (not made by Keepa itself) that uses your Keepa account.
2a · Get your Keepa key
- Create an account at keepa.com and buy a subscription.
- Open the API page at keepa.com/#!api and copy your access key (a long string of letters and numbers).
- Treat this key like a password. Do not paste it into a chat with any AI assistant.
2b · Install Node.js (one time)
- Go to nodejs.org, download the version marked LTS and install it with the default options.
- Restart your computer afterwards so the desktop app can find it.
2c · Tell Claude Desktop about Keepa
- In Claude Desktop, open and click . A file called
claude_desktop_config.jsonopens in a text editor.
If the button is missing, the file lives here. Mac:~/Library/Application Support/Claude/claude_desktop_config.json. Windows:%APPDATA%\Claude\claude_desktop_config.json. - If the file is empty or only contains
{}, replace everything with this, then swapPASTE_YOUR_KEEPA_KEY_HEREfor your key (keep the quote marks):{ "mcpServers": { "keepa": { "command": "npx", "args": ["-y", "keepa-mcp"], "env": { "KEEPA_API_KEY": "PASTE_YOUR_KEEPA_KEY_HERE" } } } } - If the file already has an
"mcpServers"section, add only the Keepa block inside it, with a comma after the block before it:"keepa": { "command": "npx", "args": ["-y", "keepa-mcp"], "env": { "KEEPA_API_KEY": "PASTE_YOUR_KEEPA_KEY_HERE" } } - Save the file. Then fully quit Claude Desktop (Mac: ⌘ Q; Windows: right-click the tray icon and choose Quit) and open it again. Closing the window is not enough.
- In a new chat, click + and check that keepa appears in your list of connectors.
Speed. With the basic Keepa subscription, each Amazon lookup uses a few "tokens" and you earn about one token a minute, saved up for an hour. In practice: a handful of Amazon checks, then a short wait. If that gets in your way, Keepa's €49 data plan is about 20 times faster.
Test that it works
Start a new chat with the connectors switched on and try these. The assistant should show that it is using ShopSavvy (or Keepa) and come back with real prices.
Use ShopSavvy to look up the current prices for a LEGO Botanicals Bonsai Tree set at all retailers, lowest first.
Use ShopSavvy to show the price history for that same product over the last 90 days. What was the lowest price, and where?
If Keepa is connected: use Keepa to show the Amazon price history for that product over the last year, and compare Amazon's own price to other sellers.
Use it for holiday shopping
Paste the prompt below into a new chat, fill in the blanks, and add your gift list. Rough descriptions are fine, such as "art kit for a 10-year-old under $40". The assistant will suggest specific products for vague items before pricing them.
What the verdicts mean
I'm doing my holiday shopping. For each item on my list below: 1. Use ShopSavvy to find current prices at all retailers and the price history for the last 90 days. 2. If Keepa is connected, also check the Amazon price history for the last year. 3. Put everything in one table with these columns: Item, Best price and store, Amazon price, 90-day low, Verdict, Route. Use these rules: - BUY NOW if the price is within 5% of its 90-day low. - WAIT FOR BLACK FRIDAY if the price has gone up in the last few weeks (stores often raise prices before a sale so the discount looks bigger). - Route to a STORE only if it is at least 10% or $10 cheaper than Amazon. Otherwise route to AMAZON. - Only plan a store trip if the items at that store save $25 or more in total. If not, move them to Amazon. Then give me three lists: (a) my store trips, grouped by store, (b) my Amazon cart, (c) items to recheck on Black Friday. My ZIP code: ______ Stores I'm willing to visit: ______ Budget per person (optional): ______ Gifts that must arrive by a certain date: ______ My list: - - -
Change the rules to fit you
The 5%, 10%, $10 and $25 numbers are starting points. Tighter numbers mean fewer "buy now" calls and fewer store trips. Edit them in the prompt before you send it.
Recheck on sale days
On Black Friday and Cyber Monday, go back to the same chat and ask: "Recheck everything on my wait list and update the table."
About in-store prices. ShopSavvy shows the price each retailer lists online. Big chains usually charge the same in the store, but not always, and clearance prices are often set store by store. Before driving out, confirm the price and stock for your store in the retailer's own app. For Home Depot and Lowe's clearance, BrickSeek can show prices at nearby stores.
Claude Code, Codex, Cursor and similar
Run these in a terminal. Replace the placeholder keys with your own.
Claude Code
ShopSavvy, free (no key):
claude mcp add --transport http shopsavvy https://api.shopsavvy.com/mcp
ShopSavvy with a paid Data API key (higher limits):
claude mcp add --transport http shopsavvy https://api.shopsavvy.com/mcp \ --header "Authorization: Bearer ss_live_your_key_here"
Keepa:
claude mcp add keepa -e KEEPA_API_KEY=your_key -- npx -y keepa-mcp
Codex CLI
Add to ~/.codex/config.toml:
[mcp_servers.keepa] command = "npx" args = ["-y", "keepa-mcp"] [mcp_servers.keepa.env] KEEPA_API_KEY = "YOUR_KEEPA_KEY"
Cursor and other JSON-config apps
Most tools accept the same mcpServers format as Claude Desktop. This runs both services on your computer (the ShopSavvy local version needs a paid key; without one, use the hosted URL above if your tool supports remote servers):
{
"mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["-y", "@shopsavvy/mcp-server"],
"env": { "SHOPSAVVY_API_KEY": "ss_live_your_key_here" }
},
"keepa": {
"command": "npx",
"args": ["-y", "keepa-mcp"],
"env": { "KEEPA_API_KEY": "YOUR_KEEPA_KEY" }
}
}
}Use either the hosted ShopSavvy connector or the local one, not both, or your assistant will see every tool twice.
Troubleshooting
The connector does not appear in Claude Desktop
Fully quit the app and reopen it. Then check the config file for a missing comma or quote mark; pasting the file into a free online "JSON validator" will point to the exact line.
Error mentioning npx or "command not found"
Node.js is missing or the app cannot see it yet. Install the LTS version from nodejs.org and restart your computer.
The assistant answers from memory instead of looking prices up
Make sure the connector is switched on for that chat (the + menu), and start your request with "Use ShopSavvy to...".
ShopSavvy says you are rate limited
The free version allows 10 lookups a minute and 100 an hour. Wait a minute, or price your list in two batches.
Keepa says it is out of tokens
Tokens refill every minute. Wait a few minutes and ask again.
"Developer mode" is missing in ChatGPT
It requires a paid plan and the ChatGPT website. On a work account, your admin may need to enable it.
"Add custom connector" is greyed out in Claude
On a work account, an organization owner has to add it. On the free plan, you may already be using your one custom connector.
Keep your keys safe. API keys belong only in the settings file or setup screen, never in a chat message or a shared document. If a key leaks, generate a new one on the provider's site.