[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List reviews

> Reviews of your shop with rating, product, status, sentiment and whether a reply exists. Input schema, a tools/call example and an example result.

Source: https://cotlet.dev/docs/mcp/judge-me/list_reviews

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Reviews of your shop with rating, product, status, sentiment and whether a reply exists.

Judge.me MCP tools: https://cotlet.dev/docs/mcp/judge-me.md

MCP tool: `judge_me_read → list_reviews`

Access: 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 | Required | Description |
|---|---|---|---|
| `status` | enum | no | published, to_curate (pending), hidden or archived. Default: all statuses. |
| `rating` | integer | no | Only reviews with this star rating, 1 to 5. |
| `sentiment` | enum | no | positive, neutral or negative, as the Reviews dashboard classifies them. |
| `has_reply` | boolean | no | true for reviews with a reply, false for reviews without one. |
| `product` | string | no | Product title or handle. |
| `since` | date | no | Only reviews created on or after this date. |
| `limit` | integer | no | Reviews per page. Default: 20. |
| `cursor` | string | no | Next page cursor from the previous call. |

## tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "judge_me_read",
    "arguments": {
      "operation": "list_reviews",
      "arguments": {}
    }
  }
}
```

## Example response

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

Next: [Get a review](https://cotlet.dev/docs/mcp/judge-me/get_review.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.