suggest_slots

mcp:readread-only

Suggest the best times to publish on a platform (x, linkedin or tiktok) over the next week, ranked, each with a reason, e.g. "Tue 09:00: your top window, 1.4× your average engagement over 12 posts." Uses the workspace's audience, timezone, posting windows and past results, and avoids times already taken. Pass contentType "question" for posts that need the author around to reply.

Show the options to the user, then pass the chosen scheduledForUtc to approve_post_group or schedule_post_group.

Input

• platformstring

  one of x, linkedin, tiktok · default "x"

• contentTypestring

  min length 1 · max length 64

• daysinteger

  min 1 · max 14 · default 7

• countinteger

  min 1 · max 5 · default 3

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

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

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/scheduler/slots as the signed-in user, with the same validation, approval rules and limits. See it in the Scheduler API reference.