io.github.pricewatcha/pricewatcha is an MCP server published by io.github.pricewatcha, hosted at mcp.pricewatcha.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including get_api_status, track_product, get_job_status, get_product, get_price_history.
Track prices & price history on any online shop, with alerts and an API
1 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
{
"name": "get_api_status",
"title": "Get API status",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"base_url",
"health",
"api"
],
"properties": {
"api": {
"type": "object",
"required": [
"name",
"version",
"status"
],
"properties": {
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": "string"
},
"agent_ready": {
"type": "boolean"
},
"description": {
"type": "string"
}
},
"additionalProperties": {}
},
"health": {
"type": "object",
"required": [
"status",
"service",
"version"
],
"properties": {
"status": {
"type": "string"
},
"service": {
"type": "string"
},
"version": {
"type": "string"
}
},
"additionalProperties": {}
},
"base_url": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Public product page URL from a supported shop |
| watch | boolean | If true (API key required), enroll the product for continuous scheduler updates. |
| api_key | string | Optional API key (pwk_live_...). Required for watch/refresh. |
| refresh | boolean | If true (API key required), force a re-scrape even if the URL is already in the catalog. |
{
"name": "track_product",
"title": "Track product",
"description": "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.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Public product page URL from a supported shop"
},
"watch": {
"type": "boolean",
"description": "If true (API key required), enroll the product for continuous scheduler updates."
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Optional API key (pwk_live_...). Required for watch/refresh."
},
"refresh": {
"type": "boolean",
"description": "If true (API key required), force a re-scrape even if the URL is already in the catalog."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id",
"status"
],
"properties": {
"hint": {
"type": "string"
},
"error": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"message",
"retry_recommended"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"http_status": {
"type": [
"number",
"null"
]
},
"retry_recommended": {
"type": "boolean"
},
"retry_after_seconds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"job_id": {
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"completed",
"failed"
],
"type": "string"
},
"product": {
"anyOf": [
{
"type": "object",
"required": [
"product_id",
"name",
"shop",
"currency"
],
"properties": {
"name": {
"type": "string"
},
"shop": {
"type": "string"
},
"status": {
"type": "string"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
},
"current_price": {
"type": [
"number",
"null"
]
},
"last_checked_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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 error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | Job ID from track_product |
{
"name": "get_job_status",
"title": "Get job status",
"description": "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 error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"description": "Job ID from track_product"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id",
"status"
],
"properties": {
"hint": {
"type": "string"
},
"error": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"message",
"retry_recommended"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"http_status": {
"type": [
"number",
"null"
]
},
"retry_recommended": {
"type": "boolean"
},
"retry_after_seconds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"job_id": {
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"completed",
"failed"
],
"type": "string"
},
"product": {
"anyOf": [
{
"type": "object",
"required": [
"product_id",
"name",
"shop",
"currency"
],
"properties": {
"name": {
"type": "string"
},
"shop": {
"type": "string"
},
"status": {
"type": "string"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
},
"current_price": {
"type": [
"number",
"null"
]
},
"last_checked_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| product_id * | string | Public product ID |
{
"name": "get_product",
"title": "Get product",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"name",
"shop",
"currency"
],
"properties": {
"name": {
"type": "string"
},
"shop": {
"type": "string"
},
"status": {
"type": "string"
},
"preview": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
},
"current_price": {
"type": [
"number",
"null"
]
},
"last_checked_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| product_id * | string | Public product ID |
{
"name": "get_price_history",
"title": "Get price history",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"currency",
"data_points"
],
"properties": {
"trend": {
"enum": [
"upward",
"downward",
"stable",
"unknown"
],
"type": "string"
},
"preview": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"data_points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"price"
],
"properties": {
"date": {
"type": "string"
},
"price": {
"type": "number"
}
},
"additionalProperties": false
}
},
"average_price": {
"type": [
"number",
"null"
]
},
"current_price": {
"type": [
"number",
"null"
]
},
"historical_low": {
"type": [
"number",
"null"
]
},
"historical_high": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Search keywords (token AND). Supports minus-prefixed exclude terms: e.g. "iPhone 15 -cover -case" |
{
"name": "search_products",
"title": "Search products",
"description": "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 structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Search keywords (token AND). Supports minus-prefixed exclude terms: e.g. \"iPhone 15 -cover -case\""
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"count",
"results"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"name",
"shop"
],
"properties": {
"name": {
"type": "string"
},
"shop": {
"type": "string"
},
"status": {
"type": "string"
},
"preview": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": [
"string",
"null"
]
},
"current_price": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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_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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Optional alert name |
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| product_id * | string | Public product ID (prod_... or demo_...) |
| webhook_url | string | Optional HTTPS webhook URL |
| notify_email | boolean | Send email notifications (default true) |
| notify_on_drop | boolean | Notify on any price drop. No threshold required. |
| notify_on_rise | boolean | Notify on any price increase. No threshold required. |
| max_threshold_price | number | Notify when the price rises to or above this value. |
| min_threshold_price | number | Notify when the price drops to or below this value. |
{
"name": "create_price_alert",
"title": "Create price alert",
"description": "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_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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"product_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 128,
"description": "Optional alert name"
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID (prod_... or demo_...)"
},
"webhook_url": {
"type": "string",
"format": "uri",
"description": "Optional HTTPS webhook URL"
},
"notify_email": {
"type": "boolean",
"description": "Send email notifications (default true)"
},
"notify_on_drop": {
"type": "boolean",
"description": "Notify on any price drop. No threshold required."
},
"notify_on_rise": {
"type": "boolean",
"description": "Notify on any price increase. No threshold required."
},
"max_threshold_price": {
"type": "number",
"description": "Notify when the price rises to or above this value.",
"exclusiveMinimum": 0
},
"min_threshold_price": {
"type": "number",
"description": "Notify when the price drops to or below this value.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alert_id",
"product_id",
"notify_on_drop",
"notify_on_rise",
"currency",
"notify_email",
"is_active",
"created_at",
"updated_at"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"product_id": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"webhook_url": {
"type": [
"string",
"null"
]
},
"notify_email": {
"type": "boolean"
},
"notify_on_drop": {
"type": "boolean"
},
"notify_on_rise": {
"type": "boolean"
},
"last_triggered_at": {
"type": [
"string",
"null"
]
},
"max_threshold_price": {
"type": [
"number",
"null"
]
},
"min_threshold_price": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| product_id | string | Optional public product ID filter |
{
"name": "list_price_alerts",
"title": "List price alerts",
"description": "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, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "Optional public product ID filter"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"count",
"alerts"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"alerts": {
"type": "array",
"items": {
"type": "object",
"required": [
"alert_id",
"product_id",
"notify_on_drop",
"notify_on_rise",
"currency",
"notify_email",
"is_active",
"created_at",
"updated_at"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"product_id": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"webhook_url": {
"type": [
"string",
"null"
]
},
"notify_email": {
"type": "boolean"
},
"notify_on_drop": {
"type": "boolean"
},
"notify_on_rise": {
"type": "boolean"
},
"last_triggered_at": {
"type": [
"string",
"null"
]
},
"max_threshold_price": {
"type": [
"number",
"null"
]
},
"min_threshold_price": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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_seconds.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| alert_id * | integer | Alert ID from create_price_alert or list_price_alerts |
{
"name": "get_price_alert",
"title": "Get price alert",
"description": "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_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"alert_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Alert ID from create_price_alert or list_price_alerts",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alert_id",
"product_id",
"notify_on_drop",
"notify_on_rise",
"currency",
"notify_email",
"is_active",
"created_at",
"updated_at"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"product_id": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"webhook_url": {
"type": [
"string",
"null"
]
},
"notify_email": {
"type": "boolean"
},
"notify_on_drop": {
"type": "boolean"
},
"notify_on_rise": {
"type": "boolean"
},
"last_triggered_at": {
"type": [
"string",
"null"
]
},
"max_threshold_price": {
"type": [
"number",
"null"
]
},
"min_threshold_price": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| alert_id * | integer | Alert ID to update |
| is_active | boolean | |
| webhook_url | any | |
| notify_email | boolean | |
| notify_on_drop | boolean | Notify on any price drop. No threshold required. |
| notify_on_rise | boolean | Notify on any price increase. No threshold required. |
| max_threshold_price | any | Max threshold, or null to clear. |
| min_threshold_price | any | Min threshold, or null to clear. |
{
"name": "update_price_alert",
"title": "Update price alert",
"description": "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 structured error object with fields error.code, error.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"alert_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 128
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Alert ID to update",
"exclusiveMinimum": 0
},
"is_active": {
"type": "boolean"
},
"webhook_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"notify_email": {
"type": "boolean"
},
"notify_on_drop": {
"type": "boolean",
"description": "Notify on any price drop. No threshold required."
},
"notify_on_rise": {
"type": "boolean",
"description": "Notify on any price increase. No threshold required."
},
"max_threshold_price": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Max threshold, or null to clear."
},
"min_threshold_price": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Min threshold, or null to clear."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alert_id",
"product_id",
"notify_on_drop",
"notify_on_rise",
"currency",
"notify_email",
"is_active",
"created_at",
"updated_at"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"product_id": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"webhook_url": {
"type": [
"string",
"null"
]
},
"notify_email": {
"type": "boolean"
},
"notify_on_drop": {
"type": "boolean"
},
"notify_on_rise": {
"type": "boolean"
},
"last_triggered_at": {
"type": [
"string",
"null"
]
},
"max_threshold_price": {
"type": [
"number",
"null"
]
},
"min_threshold_price": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| alert_id * | integer | Alert ID to delete |
{
"name": "delete_price_alert",
"title": "Delete price alert",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"alert_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Alert ID to delete",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"deleted",
"alert_id"
],
"properties": {
"deleted": {
"type": "boolean",
"const": true
},
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| product_id * | string | Public product ID (prod_... or demo_...) |
{
"name": "watch_product",
"title": "Watch product",
"description": "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.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"product_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID (prod_... or demo_...)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"watching"
],
"properties": {
"watching": {
"type": "boolean"
},
"product_id": {
"type": "string"
},
"watched_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| product_id * | string | Public product ID (prod_... or demo_...) |
{
"name": "unwatch_product",
"title": "Unwatch product",
"description": "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.message, error.http_status, error.retry_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"product_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID (prod_... or demo_...)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"watching"
],
"properties": {
"watching": {
"type": "boolean"
},
"product_id": {
"type": "string"
},
"watched_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items (default 50) |
| offset | integer | Items to skip (default 0) |
| api_key * | string | Pricewatcha API key (pwk_live_...) |
{
"name": "list_watchlist",
"title": "List watchlist",
"description": "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_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max items (default 50)"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Items to skip (default 0)"
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items",
"total"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"watched_at",
"product"
],
"properties": {
"product": {
"type": "object",
"required": [
"product_id",
"name",
"shop",
"currency"
],
"properties": {
"name": {
"type": "string"
},
"shop": {
"type": "string"
},
"status": {
"type": "string"
},
"preview": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
},
"current_price": {
"type": [
"number",
"null"
]
},
"last_checked_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"product_id": {
"type": "string"
},
"watched_at": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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_recommended, and error.retry_after_seconds.
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Pricewatcha API key (pwk_live_...) |
| product_id * | string | Public product ID (prod_... or demo_...) |
{
"name": "get_watch_status",
"title": "Get watch status",
"description": "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_recommended, and error.retry_after_seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"product_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Pricewatcha API key (pwk_live_...)"
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "Public product ID (prod_... or demo_...)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"watching"
],
"properties": {
"watching": {
"type": "boolean"
},
"product_id": {
"type": "string"
},
"watched_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Pricewatcha turns public product URLs into structured price intelligence. Workflow: 1. Use get_api_status to verify the API is reachable. 2. track_product submits a URL and waits briefly (~25s). Fast shops return status "completed" with product. 3. If track_product returns status "running", poll get_job_status with the job_id until completed or failed. 4. get_product / get_price_history / search_products read product-level catalog data. 5. For continuous price updates (API key): watch_product / list_watchlist, or pass watch=true on track_product. Creating a price alert also watches the product. 6. Price alerts: create_price_alert / list_price_alerts / get_price_alert / update_price_alert / delete_price_alert. These require a Pricewatcha API key (pwk_live_...). You can notify on any drop or rise without a numeric threshold (notify_on_drop / notify_on_rise), and optionally add min/max thresholds. Rate limits (important): - Prefer one track at a time; avoid bursting many track_product calls. Limits are per client (~2 concurrent tracks, ~10/min, ~40/hour, ~80/day). - When polling get_job_status, use exponential backoff (start ~3–5s, then increase; do not poll every 1–2s). Job polls are limited (~40/min). - On error.code "rate_limited" or http_status 429: wait retry_after_seconds (or several seconds) before retrying; do not immediately retry in a tight loop. - Spread tracks over time rather than submitting many URLs back-to-back. Product IDs: demo_* (samples), prod_* (all catalog products). Demo: demo_iphone_15_pro, demo_galaxy_s24. Catalog reads need no API key. Alert and watchlist tools require api_key. Prices are informational; merchant sites are authoritative. Tool errors use structured objects: error.code, error.message, error.http_status, error.retry_recommended, error.retry_after_seconds.
Names, descriptions and schemas were written by the server and are shown as data.