# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "plan_week",
    "arguments": {}
  }
}
```

## Related tools

- [`search_images`](/developers/mcp-tools/search_images): Search images
- [`get_tailored_slideshow`](/developers/mcp-tools/get_tailored_slideshow): Get a tailored slideshow
- [`list_tailored_versions`](/developers/mcp-tools/list_tailored_versions): List tailored versions
- [`get_brand_usage`](/developers/mcp-tools/get_brand_usage): Get a brand's usage
- [`list_accounts`](/developers/mcp-tools/list_accounts): List accounts and groups
- [`get_connect_link`](/developers/mcp-tools/get_connect_link): Get a link to connect an account
- [All 79 tools](/developers/mcp-tools)
