List reviews
Company or product reviews from the Timeline with rating, text, reviewer, source, tags and replies.
MCP tool reviews_io_read → list_reviews
read
Returns reviews as the Timeline shows them; type picks company or product reviews. Each review carries its replies, so an empty replies list means nobody answered. source says where the review came from, for example reviews_io, google or trustpilot. search matches the reviewer name or email address. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| type enum | enum | company or product. Default: company. |
| search string | string | Reviewer name or email address. |
| rating_min integer | integer | Lowest star rating, 1 to 5. |
| rating_max integer | integer | Highest star rating, 1 to 5. |
| date_from date | date | Only reviews on or after this date. |
| date_to date | date | Only reviews on or before this date. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reviews_io_read",
"arguments": {
"operation": "list_reviews",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"reviews": [
{
"review_id": "4831902",
"type": "company",
"rating": 5,
"reviewer": "Hannah Weiss",
"source": "reviews_io",
"created_at": "2026-10-21",
"text": "Kettle arrived on time and boils fast.",
"tags": [
"kettle"
],
"replies": []
},
{
"review_id": "4829417",
"type": "company",
"rating": 1,
"reviewer": "Sam Cole",
"source": "reviews_io",
"created_at": "2026-10-20",
"text": "Visit my-shop-deals.example for coupons.",
"tags": [],
"replies": []
}
],
"next_cursor": "c2"
},
"isError": false
}