List reviews
Reviews from Manage Reviews with status, rating, product, reviewer, flags and days left before auto-publish.
MCP tool yotpo_read → list_reviews
read
Lists reviews as Manage Reviews shows them. Reviews scheduled to auto-publish come first unless you pass sort. status uses Yotpo's labels and rating, product and search filter the same way the screen does; product accepts a name, ID, UPC, MPN or SKU. days_to_auto_publish is the countdown Yotpo shows, and flags lists profanity and negative sentiment (sentiment analysis covers English reviews only). comments is the number of replies on the review. get_review returns the full text.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | pending, published, hidden, flagged_for_profanity, escalated or pending_media. Default: all. |
| rating integer | integer | Only reviews with this star rating. |
| product string | string | Product name, ID, UPC, MPN or SKU. |
| search string | string | Words in the review or the shopper's email address. |
| since date | date | Only reviews submitted on or after this date. |
| sort enum | enum | newest, oldest, highest_rating, lowest_rating or with_media. |
| limit integer | integer | Reviews per call. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yotpo_read",
"arguments": {
"operation": "list_reviews",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"reviews": [
{
"review_id": "412873702",
"status": "pending",
"rating": 5,
"title": "Fits true to size",
"product": {
"name": "Trail Runner Shoe",
"sku": "TR-100"
},
"reviewer_name": "Dana P.",
"submitted_at": "2026-10-21T09:12:00Z",
"days_to_auto_publish": 12,
"flags": [],
"escalated": false,
"has_media": false,
"comments": 0
},
{
"review_id": "412873655",
"status": "pending",
"rating": 2,
"title": "Arrived three weeks late",
"product": {
"name": "Trail Runner Shoe",
"sku": "TR-100"
},
"reviewer_name": "Sam O.",
"submitted_at": "2026-10-14T16:40:00Z",
"days_to_auto_publish": 5,
"flags": [
"negative_sentiment"
],
"escalated": false,
"has_media": false,
"comments": 0
}
],
"next_cursor": null
},
"isError": false
}