ShopSavvy Data API MCP Server

ShopSavvy Data API MCP Server

MCP server providing AI assistants with live product data, pricing, and price tracking from ShopSavvy.

View on GitHub
5
Stars
3
Forks
5
Watchers
1
Issues
ShopSavvy Data API MCP Server implements the Model Context Protocol to enable AI assistants to access and interact with ShopSavvy's extensive product database. It supports product lookup, retrieves current and historical pricing from multiple retailers, and allows scheduled monitoring of product prices. The server also manages API usage analytics and credit consumption, offering robust error handling and developer tools for integration.

Key Features

Product lookup by barcode, ASIN, URL, model number, or ShopSavvy ID
Batch product lookup
Current pricing retrieval from multiple retailers
Historical price tracking with date range selection
Scheduling for automatic price monitoring (hourly/daily/weekly)
API usage analytics and credit consumption tracking
Retailer-specific offer queries
Comprehensive error handling for invalid keys and rate limits
Installation via npm package
Integration with Claude Desktop and MCP Inspector tooling

Use Cases

Automated product lookup for AI shopping assistants
Comparing current pricing across retailers for a given product
Tracking price changes and trends over time
Setting up scheduled alerts for price drops
Batch monitoring products for inventory or price changes
Analyzing market or retailer-specific price history
Building AI-powered price comparison tools
Monitoring API credit usage and optimizing requests
Integrating real-time retail data into recommendation systems
Enabling smart product monitoring for e-commerce or research applications

README

ShopSavvy Data API 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 and credit consumption

Features

🔍 Product Lookup Tools

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

💰 Pricing 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 and credit consumption

Installation

bash
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 choose a subscription plan
  3. Create an API key in your dashboard
  4. 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

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:

bash
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

API Limits & Pricing

  • Starter Plan: 1,000 credits/month - $49/month
  • Professional Plan: 10,000 credits/month - $199/month
  • Enterprise Plan: 100,000 credits/month - $499/month

Credit Usage:

  • Product lookup: 1 credit per product found
  • Current offers (all retailers): 3 credits per product
  • Current offers (single retailer): 2 credits per product
  • Historical data: 3 credits + 1 credit per day of history
  • Scheduling: 1 credit per product scheduled

Development

Running Locally

bash
# 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

bash
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

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 tracking and credit consumption 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.

Star History

Star History Chart

Repository Owner

shopsavvy
shopsavvy

Organization

Repository Details

Language JavaScript
Default Branch main
Size 28 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
100%

Tags

API integration automation

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Shopify Storefront MCP Server

    Shopify Storefront MCP Server

    Seamless Shopify Storefront API access for AI assistants via Model Context Protocol

    Enables AI assistants to interact with Shopify store data through standardized MCP tools. Offers endpoints for product discovery, inventory management, GraphQL queries, cart operations, and comprehensive customer data manipulation. Designed for easy integration with MCP-compatible AI and automated token handling. Simplifies secure connection to Shopify's Storefront API with minimal configuration.

    • ⭐ 5
    • MCP
    • QuentinCody/shopify-storefront-mcp-server
  • Climatiq MCP Server

    Climatiq MCP Server

    MCP server providing AI assistants with real-time carbon emissions calculations via Climatiq API.

    Climatiq MCP Server implements the Model Context Protocol to bridge AI assistants with the Climatiq API for precise carbon emissions calculations. It exposes a set of tools for various emissions scenarios, including electricity use, travel, freight, and more. The server generates resource URIs for detailed emission reports and provides natural language explanations on climate impact. Configuration is streamlined via environment variables, CLI tools, or files, supporting easy integration with platforms like Claude Desktop.

    • ⭐ 6
    • MCP
    • jagan-shanmugam/climatiq-mcp-server
  • Oura MCP Server

    Oura MCP Server

    Enables language models to access Oura sleep, readiness, and resilience data via MCP.

    Oura MCP Server implements the Model Context Protocol to provide language models with access to Oura API data. It allows querying of sleep, readiness, and resilience metrics for specified date ranges or for the current day. The server supports integration with tools like Claude for Desktop and handles API authentication and error scenarios gracefully. Designed for seamless access to personal health metrics through standardized protocol endpoints.

    • ⭐ 34
    • MCP
    • tomekkorbak/oura-mcp-server
  • CVE-Search MCP Server

    CVE-Search MCP Server

    MCP server for querying and managing CVE-Search vulnerability data.

    CVE-Search MCP Server implements the Model Context Protocol to provide structured access to the CVE-Search API. It enables querying vendors, products, and vulnerabilities, as well as retrieving detailed information for specific CVEs. The server facilitates model context integration via MCP client tools, supporting seamless interactions for vulnerability data management.

    • ⭐ 67
    • MCP
    • roadwy/cve-search_mcp
  • AgentQL MCP Server

    AgentQL MCP Server

    MCP-compliant server for structured web data extraction using AgentQL.

    AgentQL MCP Server acts as a Model Context Protocol (MCP) server that leverages AgentQL's data extraction capabilities to fetch structured information from web pages. It allows integration with applications supporting MCP, such as Claude Desktop, VS Code, and Cursor, by providing an accessible interface for extracting structured data based on user-defined prompts. With configurable API key support and streamlined installation, it simplifies the process of connecting web data extraction workflows to AI tools.

    • ⭐ 120
    • MCP
    • tinyfish-io/agentql-mcp
  • mcp-national-rail

    mcp-national-rail

    Access live National Rail train data via MCP for AI agents.

    mcp-national-rail is a Model Context Protocol (MCP) server designed to enable AI agents to retrieve real-time and scheduled train information from National Rail using the Realtime Trains API. It facilitates live and historical lookups of departures and arrivals by exposing a set of tools through a standardized MCP interface. The server can be installed via Smithery or manually and configured for use with AI clients like Claude Desktop. Secure authentication with the Realtime Trains API is supported through user-provided credentials.

    • ⭐ 1
    • MCP
    • lucygoodchild/mcp-national-rail
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results