MCPMCP Tools/Reviews/get_topic_trends

get_topic_trends

Readreviews:read

What customers talk about: topic leaderboard with mentions and sentiment, rising and declining themes, emerging topics. Use for customer feedback analysis, review themes, what's trending in reviews. Pass locationId for ONE location; omit it for the CLIENT-WIDE roll-up across all the client's locations (optionally only those carrying `tag`) — the same numbers the Reviews page shows, with the locations' reviews pooled, so a location with more reviews weighs proportionally more. The result says which (`scope`: location | client). For a client roll-up windowDays is 30, 90 or 180.

Parameters

clientIdstringrequired

The client's id (from list_clients). Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.

locationIdstringoptional

Optional: one location's id (from list_locations). Omit for the client-wide roll-up. Accepts the database ID or public loc- ID. IDs must belong to the authenticated agency and permitted client.

tagstringoptional

With no locationId only: roll up just the locations carrying this tag (a name from list_location_tags).

windowDaysnumberoptional

Lookback window in days (default 90)

section"topics" | "movers" | "narrative" | "all"optional

topics | movers | narrative | all (default all)

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_topic_trends",
    "arguments": {
      "clientId": "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.