MCPFerramentas MCP/Avaliações/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).

Parâmetros
clientIdstringobrigatório
Client the location belongs to (from list_clients).
locationIdstringobrigatório
The location's id (from list_locations).
ratings(1 | 2 | 3 | 4 | 5)[]opcional
Star ratings to include.
sentiment("positive" | "neutral" | "negative")[]opcional
Sentiments to include.
sitesstring[]opcional
Platforms/marketplaces to include (e.g. google, yelp)
status("responded" | "unreplied")[]opcional
Response status to filter by.
keywordstringopcional
Match review body text (case-insensitive)
fromstringopcional
Only reviews on/after this ISO date
tostringopcional
Only reviews on/before this ISO date
sort"newest" | "oldest" | "lowest" | "highest"opcional
newest | oldest | lowest | highest
cursorstringopcional
Pagination cursor from a prior nextCursor
limitnumberopcional
Page size (1–100, default 30)
Exemplo de solicitação
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_reviews",
    "arguments": {
      "clientId": "string",
      "locationId": "string"
    }
  }
}
Exemplo de resposta
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

O formato da resposta é ilustrativo — o conteúdo real depende da ferramenta e dos seus dados.