MCPMCP Tools/Clients/update_publisher_set

update_publisher_set

Writeclients:write

Rename a publisher set and/or replace the directories it covers. `siteIds` REPLACES the whole selection — it is not a delta, so send the full list you want (read the current one with get_publisher_set and add to or remove from it). You must pass the `revision` get_publisher_set returned: if someone else edited the set in the meantime the call is refused rather than overwriting them, and you re-read and re-apply. Editing an assigned set changes every client on it: a directory you remove disappears for those clients and stops syncing, a directory you add starts being worked on. That happens in the background — the response's `affectedClients` says how many clients were queued for it, and get_client_publisher_set reports where each one got to. Requires an identified agency user.

Parameters
publisherSetIdstringrequired
The publisher set's id (from list_publisher_sets).
revisionnumberrequired
The `revision` from get_publisher_set — the version your change was made against. A stale one is refused, not merged.
namestringoptional
A new name (optional). Must stay unique within the agency.
siteIdsnumber[]optional
The complete new list of site ids (optional). REPLACES the current selection; [] means exclude everything.
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_publisher_set",
    "arguments": {
      "publisherSetId": "string",
      "revision": 0
    }
  }
}
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.