Nexscope

Amazon Marketplace Intelligence

Amazon Reviews List MCP Tool

Fetch and analyze Amazon product reviews by ASIN, supporting 15 marketplaces (including US) with star rating filtering. Triggered when users mention Amazon reviews, US reviews, product reviews, buyer complaints, negative reviews, positive reviews, star ratings, review analysis, review sentiment, product improvement suggestions, Vine reviews, verified purchase reviews, competitor review research, Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review analysis, positive review analysis, star rating filter, review sentiment analysis, product improvement insights, Vine reviews, competitor reviews, customer feedback.

MCP tool name
nexscope_amazon_reviews_list
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-reviews-list-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_reviews_list",
    "arguments": {
      "star5Num": 1,
      "asin": "B072MQ5BRX",
      "domainCode": "com",
      "star4Num": 1,
      "star3Num": 1,
      "star2Num": 1,
      "star1Num": 1
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-reviews-list

Arguments

NameTypeRequiredMeaning
asinstringrequired
Amazon product ASIN
Example: B072MQ5BRX
domainCodestringoptional
Amazon domain code, default com. Options: com, ca, co.uk, in, de, fr, it, es, co.jp, com.au, com.br, nl, se, com.mx, ae. Use com for the US site
Example: {}
star1Numintegeroptional
Number of 1-star reviews, default 10, max 100
Example: 1
star2Numintegeroptional
Number of 2-star reviews, default 10, max 100
Example: 1
star3Numintegeroptional
Number of 3-star reviews, default 10, max 100
Example: 1
star4Numintegeroptional
Number of 4-star reviews, default 10, max 100
Example: 1
star5Numintegeroptional
Number of 5-star reviews, default 10, max 100
Example: 1
filterByKeywordstringoptional
Filter reviews by keyword, max length 1000 characters
Example: phone case
sortBystringoptional
Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent
Example: {}
reviewerTypestringoptional
Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews
Example: {}
mediaTypestringoptional
Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents
Example: {}
formatTypestringoptional
Format type: all_formats (all formats) or current_format (current format), default all_formats
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.totalintegeroptional
Total review count
Example: 1
data.dataarrayoptional
Review list (see review object below)
Example: []
data.columnsarrayoptional
Rendered columns
Example: []
data.costTokenintegeroptional
Total token consumption
Example: 1
data.typestringoptional
Render style
Example: null
data.columns[].reviewIdstringoptional
Review ID
Example: example-id
data.columns[].asinstringoptional
Product ASIN
Example: B072MQ5BRX
data.columns[].titlestringoptional
Review title
Example: null
data.columns[].textstringoptional
Review content
Example: null
data.columns[].ratingstringoptional
Rating
Example: null
data.columns[].datestringoptional
Review date
Example: 2026-01-01
data.columns[].userNamestringoptional
Reviewer name
Example: null
data.columns[].verifiedbooleanoptional
Whether verified purchase
Example: false
data.columns[].vinebooleanoptional
Whether Vine Voice review
Example: false
data.columns[].numberOfHelpfulintegeroptional
Helpful count
Example: 1
data.columns[].imageUrlListarrayoptional
Review image list
Example: []
data.columns[].videoUrlListarrayoptional
Review video list
Example: []
data.columns[].domainCodestringoptional
Country code
Example: null
data.columns[].productTitlestringoptional
Product title
Example: null
data.columns[].productRatingstringoptional
Product rating
Example: null
data.columns[].countRatingsintegeroptional
Product rating count
Example: 1
data.columns[].countReviewsintegeroptional
Product review count
Example: 1
data.columns[].variationIdstringoptional
Variation ID
Example: example-id
data.columns[].variationListarrayoptional
Variation list
Example: []
data.columns[].profilePathstringoptional
Reviewer profile path
Example: null
data.columns[].currentPageintegeroptional
Current page number
Example: 1
data.columns[].sortStrategystringoptional
Sort strategy
Example: null
data.columns[].statusCodeintegeroptional
Status code
Example: 1
data.columns[].statusMessagestringoptional
Status message
Example: null
data.columns[].localeobjectoptional
Locale information
Example: {}
data.columns[].reviewSummaryobjectoptional
Review summary data
Example: {}
data.columns[].filtersobjectoptional
Applied filter conditions
Example: {}
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "star5Num": 1,
  "asin": "B072MQ5BRX",
  "domainCode": "com",
  "star4Num": 1,
  "star3Num": 1,
  "star2Num": 1,
  "star1Num": 1
}

Example structuredContent

{
  "data": {
    "total": 1,
    "data": [],
    "columns": [
      {
        "reviewId": "example-id",
        "asin": "B072MQ5BRX",
        "date": "2026-01-01",
        "verified": false,
        "vine": false,
        "numberOfHelpful": 1,
        "imageUrlList": [],
        "videoUrlList": [],
        "countRatings": 1,
        "countReviews": 1,
        "variationId": "example-id",
        "variationList": [],
        "currentPage": 1,
        "statusCode": 1,
        "locale": {},
        "reviewSummary": {},
        "filters": {}
      }
    ],
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}