MCPOutils MCP/Avis/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).
Paramètres
clientIdstringobligatoire
Client the location belongs to (from list_clients).
locationIdstringobligatoire
The location's id (from list_locations).
ratings(1 | 2 | 3 | 4 | 5)[]facultatif
Star ratings to include.
sentiment("positive" | "neutral" | "negative")[]facultatif
Sentiments to include.
sitesstring[]facultatif
Platforms/marketplaces to include (e.g. google, yelp)
status("responded" | "unreplied")[]facultatif
Response status to filter by.
keywordstringfacultatif
Match review body text (case-insensitive)
fromstringfacultatif
Only reviews on/after this ISO date
tostringfacultatif
Only reviews on/before this ISO date
sort"newest" | "oldest" | "lowest" | "highest"facultatif
newest | oldest | lowest | highest
cursorstringfacultatif
Pagination cursor from a prior nextCursor
limitnumberfacultatif
Page size (1–100, default 30)
Exemple de requête
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_reviews",
"arguments": {
"clientId": "string",
"locationId": "string"
}
}
}Exemple de réponse
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}La forme de la réponse est indicative — le contenu réel dépend de l'outil et de vos données.