get_posting_slots
The next count real posting slots for this workspace, computed from its
actual configured timezone/posting_days/posting_slots (Settings > Scheduling
in the web app) or from when its followers are actually online — not a guess.
basis:
"auto" (default): the workspace's saved posting_slots if it has any; otherwise the connected account's peak online-follower hours (Instagram's online_followers, last 30 days); otherwise 18:00.
"settings": always the saved posting_slots (18:00 if none).
"audience": the peak online-follower hours; falls back like "auto" when the account has no audience data (under 100 followers, or Instagram returned none). Use it when the user asks when their followers are online or wants "the best time" rather than their usual slot. posting_days is honoured in every mode.
sourcein the result says which one was actually used, andaudience_peak_hourslists the top hours whenever audience data exists — mention them if they differ from the saved slot.
Refuses to run when the workspace has no timezone configured (timezone="" in list_workspaces' output): there is no reliable default to fall back to from an MCP connection (no browser timezone to borrow, unlike the web app), so defaulting to UTC or inferring one from the account would just be a different wrong guess than hardcoding IST. Ask the connected user for their real IANA timezone (e.g. "Asia/Kolkata", "America/New_York") and call update_scheduling_settings to save it first — that's a one-time setup per workspace, not something to ask on every scheduling request.
Each returned slot's scheduled_at is UTC-aware and ready to pass straight to schedule_reel/schedule_reels_bulk. weekday_local/time_local are there so you can confirm the slot with the user in their own timezone rather than UTC.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "get_posting_slots"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| basis | No | auto | |
| count | No | ||
| workspace_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slots | Yes | ||
| source | No | settings | |
| timezone | Yes | ||
| audience_status | No | ||
| audience_peak_hours | No |