List reviews
Reviews of your shop with rating, product, status, sentiment and whether a reply exists.
MCP tool judge_me_read → list_reviews
read
Lists reviews in the order the Reviews dashboard shows them, with next_cursor for the next page. It uses the dashboard filters, so has_reply and sentiment work here although the REST API cannot filter by them. review_id is the ID for get_review, reply_to_review, publish_review and hide_review. status is the dashboard status: to_curate reviews wait for a decision, and Judge.me publishes them after 14 days if nobody moderates them.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | published, to_curate (pending), hidden or archived. Default: all statuses. |
| rating integer | integer | Only reviews with this star rating, 1 to 5. |
| sentiment enum | enum | positive, neutral or negative, as the Reviews dashboard classifies them. |
| has_reply boolean | boolean | true for reviews with a reply, false for reviews without one. |
| product string | string | Product title or handle. |
| since date | date | Only reviews created on or after this date. |
| limit integer | integer | Reviews per page. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "judge_me_read",
"arguments": {
"operation": "list_reviews",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"reviews": [
{
"review_id": 48210934,
"rating": 4,
"title": "Fits well",
"body": "Warm and light. Runs slightly small.",
"product": "Trail Jacket",
"reviewer": "Dana K.",
"status": "published",
"verified": true,
"sentiment": "positive",
"has_reply": false,
"source": "email",
"created_at": "2026-10-21T09:12:00Z"
},
{
"review_id": 48199021,
"rating": 1,
"title": "Great deals at cheapwatch.example",
"body": "Visit cheapwatch.example for 70% off.",
"product": "Trail Jacket",
"reviewer": "Sam",
"status": "to_curate",
"verified": false,
"sentiment": "neutral",
"has_reply": false,
"source": "web",
"created_at": "2026-10-20T16:40:00Z"
}
],
"next_cursor": "2"
},
"isError": false
}