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
| Input | Type | Required | Notes |
|---|---|---|---|
groupId | string | yes | An account group from list_accounts. up to 200 characters |
changes | object | yes | Only the fields to change: context (what its accounts post about) and avoid. Empty fields inherit the brand's. |
reason | string | yes | Why, 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
| Field | Type | Notes |
|---|---|---|
proposalId | string | The proposal id. |
brandId | string | The brand it would change. |
status | "pending" | Nothing changes until the owner accepts it. |
reviewUrl | string | Where the owner accepts or rejects it with one click. |
expiresAt | string | When the proposal lapses if not decided, ISO 8601. |
note | string | What 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.
Related tools
create_brand: Make a brand from a descriptionupdate_brand_settings: Change brand settingspropose_brand_change: Propose a brand changesave_format: Save a slideshow formatrename_slideshow: Rename a slideshowdelete_slideshow: Delete a slideshow- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.