MCPOutils MCP/Avis/get_reviews_rollup

get_reviews_rollup

Readreviews:read

Reviews Overview / command center — across ALL of the agency's locations by default, or scoped to ONE client's locations by passing clientId (the Reviews → Overview page's "All locations" view for that client). Returns: summary tiles (total reviews, avg rating, total unreplied, positive %, new-in-period + Δ vs the prior window, stale count), the best & worst location by health, a per-location rows[] table (name/city, review count, avg rating, sentiment split, response rate, health score + Δ, %≤2★, %5★, 1–5★ distribution, new-in-window + velocity Δ, last-review date + staleness, a per-bucket sparkline, top positive/negative theme), and a portfolio trend (per-location monthly review volume + avg rating over the trailing 12 months, sorted by health). Window defaults to the last 30 days; pass period (7 | 30 | 90) or an explicit from+to ISO range.

Paramètres
clientIdstringfacultatif
Scope to one client's locations (from list_clients). Omit for agency-wide across every client.
period7 | 30 | 90facultatif
Quick window in days (default 30). Ignored when from+to are given.
fromstringfacultatif
Window start (ISO date). Requires `to`.
tostringfacultatif
Window end (ISO date). Requires `from`.
tagsstring[]facultatif
Internal location tags — narrow the rollup to locations carrying ANY of these (from list_location_tags). Each row also carries its location's tags.
Exemple de requête
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_reviews_rollup",
    "arguments": {}
  }
}
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.