Sydium

Account analytics time-series (optional from/to YYYY-MM-DD)

get_analytics

Store an image or video in Sydium and return the media URL that publish_post and update_post require. Media MUST be hosted by Sydium - an external URL passed straight to publish_post is rejected - so call this first. Pass EITHER `file` (a file the user attached to this conversation) OR `url` (a direct, publicly reachable link to the image or video itself, not a web page containing it). Supported: jpeg, png, gif, webp, mp4, mov, webm - up to 200MB. HEIC/AVIF photos (the iPhone default) are NOT supported; ask the user to convert to JPEG. A Google Drive or Dropbox SHARE link works, as long as the file is shared with anyone who has the link. 200MB is a hard limit on this tool only - if the file is larger, do NOT keep retrying or look for another link: tell the user to upload it in Sydium directly (Publish, or the media library), where there is no such limit, and then carry on with the caption and scheduling. Returns the media url plus its measured size, dimensions and duration, and `acceptedBy` / `rejectedBy`: which platforms will take this file. Pass `postType` when you already know it (reel, story, carousel...) - story and carousel limits are stricter than the platform default, and without it `acceptedBy` is optimistic. Check `rejectedBy` before scheduling. The media is REMOVED once its post publishes, so a url cannot be reused for a second post - call add_media again. If the user attached a file to this conversation but you cannot pass it to `file`, that is a limitation of the CLIENT you are running in, not of Sydium - say so plainly, in those terms, and ask for a public link, which works everywhere. Do not tell the user that Sydium cannot accept their image, and do not claim an upload happened. This is for real images and videos only. For a carousel, call draft_carousel instead: never create, render or upload placeholder or text-only images to stand in for carousel slides.

add_media

Cancel a scheduled post operation by id (only targets still scheduled are cancelled)

cancel_post

Draft a carousel in Sydium from slide text you write, and get a link that opens it in the Sydium composer. Sydium renders the slides in the brand's carousel style and colors; you cannot see or render them, so you do not publish them. Nothing is scheduled or published: give the user `openUrl` - they review the rendered slides in the Carousel Studio, adjust and schedule there. Write `slides` in reading order: the first is the cover (a scroll-stopping hook as the headline), the last is the close (what to do next), 3 to 20 in all. Keep headlines short and put the substance in `body`. Write in the brand's language; omit `language` unless the user names one. Never upload placeholder or text-only images with add_media to stand in for slides.

draft_carousel

Edit a scheduled post operation by id: change its caption, media, and/or scheduled time. Only targets still scheduled are updated; omitted fields are left unchanged; media:[] clears media. `media` entries must be Sydium-hosted URLs returned by add_media; any other URL is rejected. Cannot change which platforms it posts to - cancel and re-create for that. `options` changes per-platform settings (cover, privacy, first comment...) and MERGES with what is already set.

update_post

Generate a social caption with AI

generate_caption

Get a publish operation's per-target status AND its full, untruncated caption (list_scheduled_posts truncates captions at 280 chars - read the full text here before editing a post)

get_post_status

List the agency clients under this team (id/name/status). Pass a client id to other tools' clientId to act for that client.

list_clients

List connected social accounts for the team, or for a specific agency client via clientId. Also returns `team`, the workspace this connection is bound to - a connection reaches exactly one workspace, fixed when the user authorized it. If the user expected different accounts, they likely authorized a different workspace: say which one you are on and tell them to reconnect and pick the right one.

list_accounts

List the team's upcoming scheduled posts (optional from/to ISO dates to bound a window, e.g. this week)

list_scheduled_posts