MCPMCP Tools/Reviews/count_widget_matches

count_widget_matches

Readreviews:read

Count how many of a location's reviews match a widget configuration — the live '{N} reviews match this configuration' preview. Location-scoped — requires clientId AND locationId. Optional minRating, sources, includeInternal, dateWindow (30d | 90d | 1y | all).

Parameters

clientIdstringrequired

The client's id (from list_clients).

locationIdstringrequired

The location's id (from list_locations).

minRatingnumberoptional

Only reviews at/above this rating (1–5)

sourcesstring[]optional

Marketplaces to include (empty = all)

includeInternalbooleanoptional

Include first-party (invite-collected) feedback

dateWindow"30d" | "90d" | "1y" | "all"optional

30d | 90d | 1y | all

Example request

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