plan_week
Plan a week of posts with Wavegrain's MCP server: the plan_week tool needs the read permission. Inputs, outputs and an example call.
Plan a week of posts. Permission: read. Read-only: changes nothing.
Proposes free Calendar slots for one account group of a brand: by default one post per account a day, an hour from other planned posts and runs, rotating the brand's styles or formats. Makes, schedules and spends nothing.
Inputs
| Input | Type | Required | Notes |
|---|---|---|---|
brandId | string | no | Default: the group's brand, else the active brand. up to 200 characters |
groupId | string | no | The account group to plan for. Default: the brand's default group. up to 200 characters |
groupName | string | no | The group by the name the user said; if two brands share it, ask which brand. up to 80 characters |
timeZone | string | no | An IANA time zone. Default: the brand's. up to 64 characters |
startDate | string | no | The first day to plan, in that zone. Default: tomorrow. |
days | integer | no | How many days to plan, from startDate. 1 to 14, default 7 |
posts | integer | no | Posts in total. Default: one per account a day; more only when the user asks. 1 to 28 |
times | string[] | no | Local HH:MM times. Default: the group's saved times, else the brand's, else 18:00. up to 4 items |
use | object[] | no | Styles or formats to rotate. Default: the brand's pinned styles, then its formats. up to 4 items |
The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.
Returns
| Field | Type | Notes |
|---|---|---|
brandId | string | The brand planned for. |
brandName | string | Its name. |
timeZone | string | The IANA zone of the local dates and times. |
group | object | null | The group planned for; null when the brand has no groups. |
groups | object[] | Every account group of the brand, to plan another one. |
slots | object[] | The proposed free slots, earliest first. |
skipped | object[] | Times left out, and why. |
tailoredCredits | number | Credits the tailored slots would cost to make. |
warnings | string[] | What stops these posts going out by themselves (no account, an empty group, no group, an account that needs a reconnect) and what the user does next, with the Settings link. Tell the user before they agree to the plan. |
recentTopics | string[] | The brand's newest slideshow titles: do not repeat them. |
note | string | What to tell the user and do next. |
Example call
Send it to POST https://wavegrain.com/api/mcp with an access key that has the read permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "plan_week",
"arguments": {}
}
}
Related tools
search_images: Search imagesget_tailored_slideshow: Get a tailored slideshowlist_tailored_versions: List tailored versionsget_brand_usage: Get a brand's usagelist_accounts: List accounts and groupsget_connect_link: Get a link to connect an account- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.