MCPMCP Tools/Reviews/list_reviews

list_reviews

Readreviews:read

List a location's reviews across its marketplaces (Google, Yelp, TripAdvisor, …). Location-scoped — requires clientId AND locationId. Cursor-paginated with a total count. Filters: ratings (1–5), sentiment (positive/neutral/negative), sites (platforms), status (responded | unreplied), keyword, from/to (ISO dates), sort (newest | oldest | lowest | highest). Reviews removed from their source are always excluded. Each review includes rating, body, author, date, platform, sentiment, existing reply, and respondable (whether a reply can be pushed via the API).

Parameters

clientIdstringrequired

Client the location belongs to (from list_clients).

locationIdstringrequired

The location's id (from list_locations).

ratings(1 | 2 | 3 | 4 | 5)[]optional

Star ratings to include.

sentiment("positive" | "neutral" | "negative")[]optional

Sentiments to include.

sitesstring[]optional

Platforms/marketplaces to include (e.g. google, yelp)

status("responded" | "unreplied")[]optional

Response status to filter by.

keywordstringoptional

Match review body text (case-insensitive)

fromstringoptional

Only reviews on/after this ISO date

tostringoptional

Only reviews on/before this ISO date

sort"newest" | "oldest" | "lowest" | "highest"optional

newest | oldest | lowest | highest

cursorstringoptional

Pagination cursor from a prior nextCursor

limitnumberoptional

Page size (1–100, default 30)

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_reviews",
    "arguments": {
      "clientId": "string",
      "locationId": "string"
    }
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.