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

Legacy MCP endpoint

/api/skill-api/v1/mcp

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": {
      "showPrice": 1,
      "asin": "B072MQ5BRX",
      "days": 30,
      "showPriceDeal": 1,
      "domain": "1",
      "showPriceList": 1,
      "showPricePrime": 1
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-product-price-series

Arguments

Name	Type	Required	Meaning
`asin`	`string`	required	Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000 Example: B072MQ5BRX
`domain`	`string`	required	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
`days`	`integer`	optional	Limit historical data to this many days, default 90, max 365 Example: 30
`showPrice`	`integer`	optional	Set to 1 to return the lowest new price curve in the market Example: 1
`showPriceList`	`integer`	optional	Set to 1 to return the list/strikethrough price curve Example: 1
`showPriceDeal`	`integer`	optional	Set to 1 to return the deal/flash sale price curve Example: 1
`showPricePrime`	`integer`	optional	Set to 1 to return the Prime-exclusive new price curve Example: 1
`showPriceFba`	`integer`	optional	Set to 1 to return the third-party FBA new price curve Example: 1
`showPriceFbm`	`integer`	optional	Set to 1 to return the third-party FBM new price curve Example: 1
`showPriceCoupon`	`integer`	optional	Set to 1 to return the coupon-applied Buy Box price curve Example: 1
`showBsrMain`	`integer`	optional	Set to 1 to return the main category BSR curve Example: 1
`showSellerCount`	`integer`	optional	Set to 1 to return the seller count curve Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.asin`	`string`	optional	ASIN Example: B072MQ5BRX
`data.buyboxPrice`	`array`	optional	Buy Box price (time=timestamp, value=Buy Box price) Example: []
`data.price`	`array`	optional	Price (time=timestamp, value=price) Example: []
`data.priceList`	`array`	optional	List/strikethrough price (time=timestamp, value=list price) Example: []
`data.priceDeal`	`array`	optional	Deal price (time=timestamp, value=deal price) Example: []
`data.pricePrime`	`array`	optional	Prime price (time=timestamp, value=Prime price) Example: []
`data.priceFba`	`array`	optional	FBA price (time=timestamp, value=FBA price) Example: []
`data.priceFbm`	`array`	optional	FBM price (time=timestamp, value=FBM price) Example: []
`data.priceCoupon`	`array`	optional	Coupon price (time=timestamp, value=coupon price) Example: []
`data.bsrMain`	`array`	optional	Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) Example: []
`data.bsrSub`	`array`	optional	Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) Example: []
`data.sellerCount`	`array`	optional	Seller count (time=timestamp, value=seller count) Example: []
`data.rating`	`array`	optional	Rating (time=timestamp, value=rating) Example: []
`data.ratingCount`	`array`	optional	Rating count (time=timestamp, value=rating count) Example: []
`data.monthlySold`	`array`	optional	Child ASIN sales (time=timestamp, value=sales units) Example: []
`data.costToken`	`integer`	optional	Token consumption Example: 1
`data.type`	`string`	optional	Provider-specific render or payload type. Example: null
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceType`	`string`	optional	Provider-specific source platform type. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "asin": "B072MQ5BRX",
    "buyboxPrice": [],
    "price": [],
    "priceList": [],
    "priceDeal": [],
    "pricePrime": [],
    "priceFba": [],
    "priceFbm": [],
    "priceCoupon": [],
    "bsrMain": [],
    "bsrSub": [],
    "sellerCount": [],
    "rating": [],
    "ratingCount": [],
    "monthlySold": [],
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}