MCPMCP Tools/Reviews/update_review_widget

update_review_widget

Writereviews:write

Edit an existing review widget in place: the same widget (same id, same embed URL) with new settings, so a site that already embeds it picks up the change. Pass widgetId (from list_review_widgets) and only the fields to change. Fields: name, minRating (1–5, or null for none), sources (marketplaces; empty = all), selectionMode (recent | highest | rotate | manual | ai), dateWindow (all | 6m | 12m), manualReviewIds, count (1–50), includeInternal, emojiPositiveRating (1–5), layout (carousel | marquee), marqueeSpeed (1–10), theme (brand | white | dark), themeOverrides, showFlags (avatar/date/rating/reply/sourceLogo/header/cta true|false), status (draft | published — draft stops it rendering publicly). At least one field is required; unknown or out-of-range values are rejected. Returns the updated widget. Use count_widget_matches to preview how many reviews a filter change matches.

Parameters
widgetIdstringrequired
Review widget id (from list_review_widgets). Accepts the database ID or public wgt- ID. IDs must belong to the authenticated agency and permitted client.
namestringoptional
Widget name (1–120 characters).
minRatingoptional
Minimum star rating (1–5). Pass null to remove the minimum.
sourcesstring[]optional
Marketplaces to pull from (empty list = all).
selectionMode"recent" | "highest" | "rotate" | "manual" | "ai"optional
recent | highest | rotate | manual | ai
dateWindow"all" | "6m" | "12m"optional
all | 6m | 12m — how far back to pull reviews
manualReviewIdsstring[]optional
Review ids to show when selectionMode is manual.
countnumberoptional
Max reviews to show (1–50).
includeInternalbooleanoptional
Include first-party feedback.
emojiPositiveRatingnumberoptional
Star rating (1–5) a positive emoji response counts as.
layout"carousel" | "marquee"optional
carousel | marquee
marqueeSpeednumberoptional
Marquee scroll speed (1–10).
theme"brand" | "white" | "dark"optional
brand | white | dark
themeOverridesoptional
Theme token overrides; pass null to clear.
showFlagsoptional
Which parts to show; each of avatar, date, rating, reply, sourceLogo, header, cta is true or false. Pass null to reset to defaults.
status"draft" | "published"optional
draft | published
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_review_widget",
    "arguments": {
      "widgetId": "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.