Developer Feature

Model Context Protocol (MCP) Server

Connect Price Spider directly to your AI assistants and LLMs to query live Amazon price history, scan records, regional comparison data, and watchlists.

SSE

SSE Connection URL

Use this URL to connect your AI assistant to our Server-Sent Events stream:

https://price-spider.com/mcp/sse
Message

Message Endpoint

Client-to-server HTTP POST messages are processed at this endpoint:

https://price-spider.com/mcp/message

What is Model Context Protocol?

The Model Context Protocol (MCP) is an open-standard communication protocol developed by Anthropic that allows LLMs and AI clients to securely access external tools, APIs, and databases.

Instead of building custom integrations for every AI model, the Price Spider MCP server exposes our database query capabilities dynamically. Once connected, your AI assistant can retrieve product details, compare regional storefront prices, query drops, and manage target price watchlists on your behalf using natural language.

Available MCP Tools

Your AI assistant will have access to the following 8 tools after connecting to the SSE server:

Read

get_product_details

Retrieves full item details from our database, including the current price, review rating, review count, and historic highs/lows.

Parameters:
  • asin (String, Required): 10-digit Amazon ASIN
  • region (String, Optional): US, GB, DE, etc. (Defaults to US)
Read

get_price_history

Retrieves all historical price data points recorded for a given item, enabling the AI to plot trends or assess current discount value.

Parameters:
  • asin (String, Required): 10-digit Amazon ASIN
  • region (String, Optional): US, GB, DE, etc. (Defaults to US)
Read

compare_regional_prices

Fetches the current price, lowest price, highest price, and absolute link across multiple Amazon storefronts for quick cross-border analysis.

Parameters:
  • asin (String, Required): 10-digit Amazon ASIN
  • regions (String, Required): Comma-separated list of country codes (e.g. US,GB,DE)
Search

search_deals

Queries the database for products matching active deal or price drop criteria, sorted by drop percentage, followers, or rank.

Parameters:
  • query (String, Optional): Search keywords
  • category (String, Optional): Category slug
  • sort (String, Optional): drop-pct, drop-abs, latest, followers
  • days (Number, Optional): Price drops within X days (default 30)
  • region (String, Optional): Region code
Read

get_popular_items

Retrieves a list of the most watched items on Price Spider sorted by the number of followers/price alerts.

Parameters:
  • region (String, Optional): US, GB, DE, etc. (Defaults to US)
  • limit (Number, Optional): Max items to return (default 10)
Write

add_to_watchlist

Creates or updates a price alert watch for a user, setting a custom target price in cents.

Parameters:
  • user_id (Number, Required): Your numeric User ID
  • asin (String, Required): 10-digit Amazon ASIN
  • price_wanted (Number, Required): Target price in cents (e.g., 2999 for $29.99)
  • region (String, Optional): US, GB, DE, etc.
Read

get_user_watchlist

Retrieves all watched products, user-defined target prices, and alert statuses for a specific user ID.

Parameters:
  • user_id (Number, Required): Your numeric User ID
Write

trigger_immediate_scan

Force-queues an ASIN to be scraped immediately by creating a scan placeholder for the price-spider crawler.

Parameters:
  • asin (String, Required): 10-digit Amazon ASIN
  • region (String, Optional): US, GB, DE, etc. (Defaults to US)

Claude Desktop Configuration Guide

To configure the official Claude Desktop client on your machine to use this MCP server, add the following configuration to your claude_desktop_config.json:

claude_desktop_config.json 
{
  "mcpServers": {
    "price-spider": {
      "url": "https://price-spider.com/mcp/sse"
    }
  }
}

macOS Config Path

Open terminal and edit:
~/Library/Application Support/Claude/claude_desktop_config.json

Windows Config Path

Open File Explorer and edit:
%APPDATA%\Claude\claude_desktop_config.json