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

InputTypeRequiredNotes
brandIdstringnoDefault: the group's brand, else the active brand. up to 200 characters
groupIdstringnoThe account group to plan for. Default: the brand's default group. up to 200 characters
groupNamestringnoThe group by the name the user said; if two brands share it, ask which brand. up to 80 characters
timeZonestringnoAn IANA time zone. Default: the brand's. up to 64 characters
startDatestringnoThe first day to plan, in that zone. Default: tomorrow.
daysintegernoHow many days to plan, from startDate. 1 to 14, default 7
postsintegernoPosts in total. Default: one per account a day; more only when the user asks. 1 to 28
timesstring[]noLocal HH:MM times. Default: the group's saved times, else the brand's, else 18:00. up to 4 items
useobject[]noStyles 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

FieldTypeNotes
brandIdstringThe brand planned for.
brandNamestringIts name.
timeZonestringThe IANA zone of the local dates and times.
groupobject | nullThe group planned for; null when the brand has no groups.
groupsobject[]Every account group of the brand, to plan another one.
slotsobject[]The proposed free slots, earliest first.
skippedobject[]Times left out, and why.
tailoredCreditsnumberCredits the tailored slots would cost to make.
warningsstring[]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.
recentTopicsstring[]The brand's newest slideshow titles: do not repeat them.
notestringWhat 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": {}
  }
}

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