Pricewatcha

pricewatcha/pricewatcha-api

Connects Claude to the Pricewatcha platform for price tracking and product intelligence across online shops. Exposes search across the catalog, product detail retrieval, price history queries, and alert creation with webhook support. The underlying API uses a long-poll pattern for URL tracking that returns product data when scraping completes, with async job polling for slower shops. You can set price thresholds and get notified when products drop below target levels. Useful when you need price monitoring in an agent workflow, want to compare historical pricing data, or need automated alerts without managing scrapers yourself. Runs as a remote server over streamable HTTP at mcp.pricewatcha.com.

tools: 15
transport: HTTP
last updated: Sep 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.pricewatcha.com --name pricewatcha

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http pricewatcha https://mcp.pricewatcha.com

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 15 tools

Verified live against the running server on Nov 6, 2026.

get_api_statusCheck whether the Pricewatcha public API is available. Returns health and discovery metadata. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.

Check whether the Pricewatcha public API is available. Returns health and discovery metadata. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.

No parameters. Call it with no arguments.

track_productSubmit a public product URL for price tracking. Waits up to ~25s server-side; fast shops return status "completed" with product in one call. Slow jobs return status "running" with job_id — poll get_job_status. On failure, returns a structured error object with fields error.cod...4 params

Submit a public product URL for price tracking. Waits up to ~25s server-side; fast shops return status "completed" with product in one call. Slow jobs return status "running" with job_id — poll get_job_status. On failure, returns a structured error object with fields error.cod...

Parameters* required

api_keystring

Optional API key (pwk_live_...). Required for watch/refresh.

refreshboolean

If true (API key required), force a re-scrape even if the URL is already in the catalog.

url*string

Public product page URL from a supported shop

watchboolean

If true (API key required), enroll the product for continuous scheduler updates.

get_job_statusPoll an async tracking job by job_id. Returns status (queued, running, completed, or failed). On completion, product is populated; on scrape failure, error is populated (HTTP 200 job lookup — not a transport error). On failure, returns a structured error object with fields err...1 params

Poll an async tracking job by job_id. Returns status (queued, running, completed, or failed). On completion, product is populated; on scrape failure, error is populated (HTTP 200 job lookup — not a transport error). On failure, returns a structured error object with fields err...

Parameters* required

job_id*string

Job ID from track_product

get_productGet structured product price intelligence by product_id (e.g. demo_iphone_15_pro or prod_xxx from a completed job). On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.1 params

Get structured product price intelligence by product_id (e.g. demo_iphone_15_pro or prod_xxx from a completed job). On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.

Parameters* required

product_id*string

Public product ID

get_price_historyGet historical prices, aggregates (low/high/average), trend, and data points for a product. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.1 params

Get historical prices, aggregates (low/high/average), trend, and data points for a product. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.

Parameters* required

product_id*string

Public product ID

search_productsSearches the Pricewatcha product catalog by keyword (token AND; word order does not matter). Supports minus-prefixed exclude terms: e.g. "iPhone 15 -cover -case" returns devices only. Returns product-level data only — not user accounts or alert settings. On failure, returns a...1 params

Searches the Pricewatcha product catalog by keyword (token AND; word order does not matter). Supports minus-prefixed exclude terms: e.g. "iPhone 15 -cover -case" returns devices only. Returns product-level data only — not user accounts or alert settings. On failure, returns a...

Parameters* required

query*string

Search keywords (token AND). Supports minus-prefixed exclude terms: e.g. "iPhone 15 -cover -case"

create_price_alertCreate a price alert for a product. Use notify_on_drop / notify_on_rise for any price change without a numeric threshold, and/or min_threshold_price / max_threshold_price for target prices. At least one of those four settings is required. Requires a Pricewatcha API key (pwk_li...9 params

Create a price alert for a product. Use notify_on_drop / notify_on_rise for any price change without a numeric threshold, and/or min_threshold_price / max_threshold_price for target prices. At least one of those four settings is required. Requires a Pricewatcha API key (pwk_li...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

max_threshold_pricenumber

Notify when the price rises to or above this value.

min_threshold_pricenumber

Notify when the price drops to or below this value.

namestring

Optional alert name

notify_emailboolean

Send email notifications (default true)

notify_on_dropboolean

Notify on any price drop. No threshold required.

notify_on_riseboolean

Notify on any price increase. No threshold required.

product_id*string

Public product ID (prod_... or demo_...)

webhook_urlstring

Optional HTTPS webhook URL

list_price_alertsList your price alerts. Optionally filter by product_id. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended...2 params

List your price alerts. Optionally filter by product_id. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

product_idstring

Optional public product ID filter

get_price_alertGet one price alert by alert_id. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_...2 params

Get one price alert by alert_id. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_...

Parameters* required

alert_id*integer

Alert ID from create_price_alert or list_price_alerts

api_key*string

Pricewatcha API key (pwk_live_...)

update_price_alertUpdate a price alert. You can switch to threshold-free notify_on_drop / notify_on_rise, change thresholds, or toggle is_active. At least one setting must remain. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a...10 params

Update a price alert. You can switch to threshold-free notify_on_drop / notify_on_rise, change thresholds, or toggle is_active. At least one setting must remain. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a...

Parameters* required

alert_id*integer

Alert ID to update

api_key*string

Pricewatcha API key (pwk_live_...)

is_activeboolean

max_threshold_pricevalue

Max threshold, or null to clear.

min_threshold_pricevalue

Min threshold, or null to clear.

namestring

notify_emailboolean

notify_on_dropboolean

Notify on any price drop. No threshold required.

notify_on_riseboolean

Notify on any price increase. No threshold required.

webhook_urlvalue

delete_price_alertDelete a price alert. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.2 params

Delete a price alert. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.

Parameters* required

alert_id*integer

Alert ID to delete

api_key*string

Pricewatcha API key (pwk_live_...)

watch_productAdd a catalog product to your account watchlist so the price scheduler keeps updating it. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.htt...2 params

Add a catalog product to your account watchlist so the price scheduler keeps updating it. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.htt...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

product_id*string

Public product ID (prod_... or demo_...)

unwatch_productRemove a product from your account watchlist. Fails while an active price alert exists for the product. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.mess...2 params

Remove a product from your account watchlist. Fails while an active price alert exists for the product. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.mess...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

product_id*string

Public product ID (prod_... or demo_...)

list_watchlistList products your account watches for continuous price updates. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_rec...3 params

List products your account watches for continuous price updates. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry_rec...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

limitinteger

Max items (default 50)

offsetinteger

Items to skip (default 0)

get_watch_statusCheck whether your account watches a product for continuous updates. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry...2 params

Check whether your account watches a product for continuous updates. Requires a Pricewatcha API key (pwk_live_...) from https://pricewatcha.com/profile#api-keys. On failure, returns a structured error object with fields error.code, error.message, error.http_status, error.retry...

Parameters* required

api_key*string

Pricewatcha API key (pwk_live_...)

product_id*string

Public product ID (prod_... or demo_...)

Readme

Pricewatcha API

The Pricewatcha API is the Structured Product Price Intelligence Platform for developers, automation and AI Agents.

The Pricewatcha API derives from the pricewatcha.com application. It provides price tracking, alerts and product intelligence beyond the Pricewatcha dashboard. This repository documents the public HTTP API, OpenAPI schema, official SDKs, MCP server and examples. It does not contain the production web application or scrapers.

Status: Available · Version: v1 · Base URL: https://pricewatcha.com/api/v1

Interactive API keys (browser): Profile & API Keys

Optional: verify connectivity with GET https://pricewatcha.com/api/v1/health. Then pick one of the three paths below.

Quickstart

Path 1: Browse prices (no auth)

Use demo product IDs from the demo catalog or search the catalog:

curl -s "https://pricewatcha.com/api/v1/products/demo_iphone_15_pro"
curl -s "https://pricewatcha.com/api/v1/search?q=iphone+15&limit=10"

View the full README on GitHub

Details

Repository: github.com/pricewatcha/pricewatcha-api
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026