Amazon Marketplace Intelligence

Amazon Product Price Series MCP Tool

Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces.

MCP tool name
nexscope_amazon_product_price_series
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-price-series/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-product-price-series-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_price_series",
    "arguments": {
      "domain": "1",
      "showPriceDeal": 1,
      "days": 30,
      "asin": "B072MQ5BRX",
      "showPrice": 1,
      "showPricePrime": 1,
      "showPriceList": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-price-series/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-product-price-series

Arguments

NameTypeRequiredMeaning
asinstringrequired
Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000
Example: B072MQ5BRX
domainstringrequired
Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)
Example: 1
daysintegeroptional
Limit historical data to this many days, default 90, max 365
Example: 30
showPriceintegeroptional
Set to 1 to return the lowest new price curve in the market
Example: 1
showPriceListintegeroptional
Set to 1 to return the list/strikethrough price curve
Example: 1
showPriceDealintegeroptional
Set to 1 to return the deal/flash sale price curve
Example: 1
showPricePrimeintegeroptional
Set to 1 to return the Prime-exclusive new price curve
Example: 1
showPriceFbaintegeroptional
Set to 1 to return the third-party FBA new price curve
Example: 1
showPriceFbmintegeroptional
Set to 1 to return the third-party FBM new price curve
Example: 1
showPriceCouponintegeroptional
Set to 1 to return the coupon-applied Buy Box price curve
Example: 1
showBsrMainintegeroptional
Set to 1 to return the main category BSR curve
Example: 1
showSellerCountintegeroptional
Set to 1 to return the seller count curve
Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
asinstringoptional
ASIN
Example: B072MQ5BRX
buyboxPricearrayoptional
Buy Box price (time=timestamp, value=Buy Box price)
Example: []
pricearrayoptional
Price (time=timestamp, value=price)
Example: []
priceListarrayoptional
List/strikethrough price (time=timestamp, value=list price)
Example: []
priceDealarrayoptional
Deal price (time=timestamp, value=deal price)
Example: []
pricePrimearrayoptional
Prime price (time=timestamp, value=Prime price)
Example: []
priceFbaarrayoptional
FBA price (time=timestamp, value=FBA price)
Example: []
priceFbmarrayoptional
FBM price (time=timestamp, value=FBM price)
Example: []
priceCouponarrayoptional
Coupon price (time=timestamp, value=coupon price)
Example: []
bsrMainarrayoptional
Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)
Example: []
bsrSubarrayoptional
Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)
Example: []
sellerCountarrayoptional
Seller count (time=timestamp, value=seller count)
Example: []
ratingarrayoptional
Rating (time=timestamp, value=rating)
Example: []
ratingCountarrayoptional
Rating count (time=timestamp, value=rating count)
Example: []
monthlySoldarrayoptional
Child ASIN sales (time=timestamp, value=sales units)
Example: []
costTokenintegeroptional
Token consumption
Example: 1
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
typestringoptional
Provider-specific render or payload type.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "domain": "1",
  "showPriceDeal": 1,
  "days": 30,
  "asin": "B072MQ5BRX",
  "showPrice": 1,
  "showPricePrime": 1,
  "showPriceList": 1
}

Example structuredContent

{
  "asin": "B072MQ5BRX",
  "buyboxPrice": [],
  "price": [],
  "priceList": [],
  "priceDeal": [],
  "pricePrime": [],
  "priceFba": [],
  "priceFbm": [],
  "priceCoupon": [],
  "bsrMain": [],
  "bsrSub": [],
  "sellerCount": [],
  "rating": [],
  "ratingCount": [],
  "monthlySold": [],
  "costToken": 1
}