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.

MCP tool name
nexscope_amazon_reviews_list
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-reviews-list/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-reviews-list-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_reviews_list",
    "arguments": {
      "asin": "B072MQ5BRX",
      "star5Num": 1,
      "star1Num": 1,
      "star2Num": 1,
      "star3Num": 1,
      "star4Num": 1,
      "domainCode": "com"
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-reviews-list/run
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.

NameTypeRequiredMeaning
totalintegeroptional
Total review count
Example: 1
dataarrayoptional
Review list (see review object below)
Example: []
columnsarrayoptional
Rendered columns
Example: []
costTokenintegeroptional
Total token consumption
Example: 1
typestringoptional
Render style
Example: {}
columns[].reviewIdstringoptional
Review ID
Example: example-id
columns[].asinstringoptional
Product ASIN
Example: B072MQ5BRX
columns[].titlestringoptional
Review title
Example: {}
columns[].textstringoptional
Review content
Example: {}
columns[].ratingstringoptional
Rating
Example: {}
columns[].datestringoptional
Review date
Example: 2026-01-01
columns[].userNamestringoptional
Reviewer name
Example: {}
columns[].verifiedbooleanoptional
Whether verified purchase
Example: false
columns[].vinebooleanoptional
Whether Vine Voice review
Example: false
columns[].numberOfHelpfulintegeroptional
Helpful count
Example: 1
columns[].imageUrlListarrayoptional
Review image list
Example: []
columns[].videoUrlListarrayoptional
Review video list
Example: []
columns[].domainCodestringoptional
Country code
Example: {}
columns[].productTitlestringoptional
Product title
Example: {}
columns[].productRatingstringoptional
Product rating
Example: {}
columns[].countRatingsintegeroptional
Product rating count
Example: 1
columns[].countReviewsintegeroptional
Product review count
Example: 1
columns[].variationIdstringoptional
Variation ID
Example: example-id
columns[].variationListarrayoptional
Variation list
Example: []
columns[].profilePathstringoptional
Reviewer profile path
Example: {}
columns[].currentPageintegeroptional
Current page number
Example: 1
columns[].sortStrategystringoptional
Sort strategy
Example: {}
columns[].statusCodeintegeroptional
Status code
Example: 1
columns[].statusMessagestringoptional
Status message
Example: {}
columns[].localeobjectoptional
Locale information
Example: {}
columns[].reviewSummaryobjectoptional
Review summary data
Example: {}
columns[].filtersobjectoptional
Applied filter conditions
Example: {}
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: {}
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

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

Example structuredContent

{
  "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
}