shopsavvy/shopsavvy-mcp-server

A Model Context Protocol (MCP) server that provides AI assistants with access to ShopSavvy's comprehensive product data, pricing information, and historical price tracking.

Overview

This MCP server enables AI assistants to:

• Look up products by barcode, ASIN, URL, model number, or ShopSavvy ID
• Get current pricing from multiple retailers
• Access historical pricing data with date ranges
• Schedule products for automatic price monitoring
• Track API usage

Features

🔍 Product Lookup Tools

• product_lookup - Find products by various identifiers (barcode, ASIN, URL, etc.)
• product_lookup_batch - Look up multiple products at once

💰 Offer Tools

• product_offers - Get current offers from all retailers
• product_offers_retailer - Get offers from a specific retailer
• product_price_history - Get historical pricing data with date ranges

📅 Scheduling Tools

• product_schedule - Schedule products for automatic refresh (hourly/daily/weekly)
• product_unschedule - Remove products from refresh schedule
• scheduled_products_list - View all scheduled products

📊 Analytics Tools

• api_usage - View current API usage

Installation

npm install @shopsavvy/mcp-server

Configuration

1. Get API Key

First, get your ShopSavvy Data API key:

1. Visit https://shopsavvy.com/data
2. Sign up and create an API key in your dashboard
3. Copy your API key (starts with ss_live_ or ss_test_)

2. Claude Desktop Setup

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": [
        "@shopsavvy/mcp-server"
      ],
      "env": {
        "SHOPSAVVY_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Environment Variables

Set your API key as an environment variable:

export SHOPSAVVY_API_KEY="ss_live_your_key_here"

Or create a .env file:

SHOPSAVVY_API_KEY=ss_live_your_key_here

Usage Examples

Product Lookup

Look up the product with barcode 012345678901

Current Pricing

Get current prices for ASIN B08N5WRWNW from all retailers

Price History

Get price history for product 012345678901 from January 1-15, 2024

Schedule Monitoring

Schedule daily price monitoring for products: 012345678901, B08N5WRWNW

Development

Running Locally

# Clone the repository
git clone https://github.com/shopsavvy/shopsavvy-mcp-server
cd shopsavvy-mcp-server

# Install dependencies
npm install

# Set your API key
export SHOPSAVVY_API_KEY="your_key_here"

# Test with MCP CLI
npm run dev

# Or inspect with MCP Inspector
npm run inspect

Building

npm run build

Error Handling

The server provides detailed error messages for:

• Invalid API keys
• Insufficient credits
• Rate limiting
• Invalid product identifiers
• API service issues

Support

• Documentation: https://shopsavvy.com/data/documentation
• Dashboard: https://shopsavvy.com/data/dashboard
• Issues: https://github.com/shopsavvy/shopsavvy-mcp-server/issues

Changelog

v1.0.0 (2025-07-28)

🎉 Initial Release

• Features: Complete ShopSavvy Data API integration with MCP support
• Product Tools: Lookup by barcode, ASIN, URL, model number, or ShopSavvy ID
• Pricing Tools: Current offers from all/specific retailers, historical pricing data
• Scheduling Tools: Automatic product monitoring (hourly/daily/weekly)
• Analytics Tools: API usage monitoring
• npm Package: Published as @shopsavvy/mcp-server under ShopSavvy organization
• TypeScript: Full TypeScript support with proper error handling
• Documentation: Comprehensive README with examples and configuration guides

License

MIT License - see LICENSE file for details.

---

Made with ❤️ by ShopSavvy - Empowering everyone to always get the best deal, every time.