propose_group_change

Propose a group change with Wavegrain's MCP server: the propose_group_change tool needs the write permission. Inputs, outputs and an example call.

Propose a group change. Permission: write. Changes saved work.

Propose an account group's context or words to avoid, for the owner to accept in Wavegrain; nothing changes until then. Answers the proposal's reviewUrl and expiry. If the user tells you how a group should post, use update_group_settings.

Inputs

InputTypeRequiredNotes
groupIdstringyesAn account group from list_accounts. up to 200 characters
changesobjectyesOnly the fields to change: context (what its accounts post about) and avoid. Empty fields inherit the brand's.
reasonstringyesWhy, in one or two sentences the owner reads next to the change. up to 500 characters

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
proposalIdstringThe proposal id.
brandIdstringThe brand it would change.
status"pending"Nothing changes until the owner accepts it.
reviewUrlstringWhere the owner accepts or rejects it with one click.
expiresAtstringWhen the proposal lapses if not decided, ISO 8601.
notestringWhat to tell the user.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the write permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "propose_group_change",
    "arguments": {
      "groupId": "<groupId>",
      "changes": {
        "context": "<context>"
      },
      "reason": "<reason>"
    }
  }
}

The call shows only the required inputs, with placeholder values: put your own in.

Something wrong or missing? Write to support@wavegrain.com.