Schedule, publish, edit and cancel social media posts on your Sociro accounts from your AI assistant, and plan a week of posts with Sociro's AI Planner that waits for your approval.
Scored across 23 tools
The set mostly separates manual posts, AI Planner posts, drafts, scheduled posts, and account/media resources clearly. However, cancel_post vs remove_plan_post vs discard_plan and update_post vs update_plan_post require careful attention to post state and could be confused without reading descriptions.
All tool names use snake_case and generally follow a verb_noun pattern: create_post, list_posts, update_plan_post, approve_plan_posts. A few longer compound names exist, but the convention remains predictable throughout.
With 23 tools, the surface is heavy for a social scheduling server, spanning manual posts, AI Planner posts, media, accounts, and analytics. Each tool has a role, but the number increases selection burden and feels borderline for the domain.
Core workflows are well covered: manual post create/list/get/update/cancel/publish, AI Planner generation/review/approval/rewrite/discard, plus media, account insights, posting activity, and platform rules. Minor gaps remain around deleting media, importing videos, updating brand profiles, and retrying failed posts, but agents can usually work around them.
Approves posts waiting for review, so they are SCHEDULED and publish to real accounts at their time. Give task_ids (chosen posts) or plan_id (every post of that plan still waiting). Only call it when the user has said to approve these posts; before that, list what will go out and when. All or nothing: if one post does not fit a platform or its time has passed, none is approved and the answer names that post: fix it or ask the user, never leave it out by yourself.
Inputs: plan_id, task_ids.
Cancels a post that is still SCHEDULED, or a DRAFT, so it never publishes. It cannot remove a post that is already published. Safe to repeat.
Inputs: task_id (required).
Before inviting someone as a collaborator on an Instagram post (create_post instagram.collaborators): what Instagram says about that username, asked with the brand's own Instagram account. found = a Business or Creator account, with its name and followers. not_found = no Business or Creator account by that name; a personal account cannot be checked this way yet can still be invited, so ask the user to check the spelling, never refuse to post. unknown = the lookup failed. Nothing is sent to the person. Sociro allows a limited number of checks an hour. Read only.
Inputs: username (required), social_group_id.
Creates ONE post on the given accounts of ONE social group: scheduled for later (scheduled_at), published at once (publish_now: true), or saved as a draft that goes nowhere yet (save_as_draft: true). Exactly one of the three. A post is public and goes to real accounts, so only schedule or publish when the user has given the content, the accounts and the time; when unsure, save a draft and tell the user. Every account gets caption, unless captions_by_account gives it a text of its own (a short one for X, a longer one for LinkedIn). Call get_platform_rules first when you are not sure a caption or the media fits a platform. Platform options go in instagram (story, collaborators, trial reel), facebook (a link post), x (who can reply, reposts from other X accounts) and tiktok; each applies only to that platform's accounts in the post. Comments: first_comment, then more_comments, each with an optional wait. Safe to repeat: the same caption, accounts, time and media a second time returns the post already made instead of posting twice (set allow_duplicate to really send it again).
Inputs: caption (required), account_ids (required), x, cover, +18 more.
Removes every post of a plan that is still waiting for review (plan_id), or every waiting post of a social group (social_group_id). Approved posts are never touched. It cannot be undone: ask the user before discarding, and say how many posts will go.
Inputs: plan_id, social_group_id.
How one social account is doing, as its platform reports it: followers, the last 7 days as numbers with the change on the 7 days before, and its latest posts with likes, comments, shares and views. Facebook, Instagram, Threads and TikTok (TikTok has no daily account numbers: its numbers add up the videos posted in the period). A report belongs to ONE social group (brand): pass social_group_id from list_accounts when the connection covers several. Each post carries likes, comments, shares, views, reach, saves and, on a video or reel, its watch numbers: avg_watch_time_ms (average time one play lasted), watch_time_ms (every play added up), complete_views (plays to the end, Facebook videos only) and duration_ms (the video's length), all lifetime and in milliseconds except complete_views; null where the platform does not give them (Threads, TikTok watch time). Posts come 10 a page, newest first. posts_next in the answer is null when there are no more; otherwise pass it back as posts_cursor (same platform and social group) for the next 10. A cursor of another platform is refused; a cursor can expire, so start again without it. Numbers can be up to an hour old (fetched_at). A number the platform did not send is null, not zero: say "not available", never 0. Read only.
Inputs: platform (required), posts_cursor, social_group_id.
The brand profile of one social group as Sociro's AI Planner reads it (business, place, voice, call to action) and the brand's own ideas for what to plan. Read it before plan_posts, and offer the ideas when the user has no brief. profile null means the brand is not set up yet: plans still work from the brief alone. Pass social_group_id from list_accounts when the connection covers more than one brand. Read only.
Inputs: social_group_id.
What each social platform accepts: the longest caption, how many photos and videos, whether media is required, whether it takes a first comment. These are the rules Sociro checks a post against, so read them before writing for a platform you are not sure of, instead of finding out from a refused post. null means no limit; for first_comment it means the platform takes none. Read only.
Inputs: platform.
One post in full: its status, its media with their ids, and for each account the status, the caption that account gets, the public link once published, the error message if it failed, whether the first comment and the comments after it were posted, the post type (for example story) and the platform options it publishes with (options: Instagram story, collaborators, trial reel; Facebook link; X who can reply; TikTok settings) and, on X, how each repost went. Read it before update_post. Read only.
Inputs: task_id (required).
What Sociro sent out over the last days, from its own records: posts published and failed, per platform, per account and per day. Every platform. Without social_group_id it counts every social group the connection covers together; pass one to see a single brand. How far back you may look depends on the workspace: asking for too many days is refused with the most allowed. Days are UTC days. Read only.
Inputs: days, social_group_id.
Adds one image to the Sociro media library from an https link and returns its media_file_id (for create_post media_file_ids, or as a cover). Use it for an image that is online or that an image model has just made and given a link for. JPG, PNG, WebP or GIF. Sociro stores its own copy (at most 1080 px wide, metadata removed), so the link does not need to stay alive. The link must be public: a private, local or sign-in-only address is refused. Not safe to repeat: every call stores a new copy.
Inputs: image_url (required), filename.
Lists the social groups this Sociro key can use (a social group is one brand: its own set of social accounts) and the accounts in each. Call this first, before posting. To post to a particular brand, find its social group here by name, then use the id of the accounts listed under it in create_post. Give social_group to see just one group. A group marked locked cannot be posted to. Read only.
Inputs: social_group.
The images and videos already in the Sociro media library, newest first, whether they were added here or in the Sociro app. Use a file's media_file_id in create_post or update_post instead of adding the same file again. Filter by type, or search the file name. Read only.
Inputs: page, type, search, per_page.
The AI Planner posts still waiting for review, oldest time first, with their captions, image scenes, images and times. Give task_id for one post in full (read it again to see an image land). Filter by plan_id or social_group_id. Times are in each post's own timezone: show them as they are. Read only.
Inputs: plan_id, task_id, social_group_id.
The posts of the social groups this key can use, made here or in the Sociro app. Each post says its social_group_id. Filter by group, status and date. Drafts are left out unless you ask for status DRAFT. Read only.
Inputs: to, from, page, order, +3 more.
Makes the image for one post waiting for review, from the post's own image scene (or prompt), in the brand's look and the right shape for the post's platforms, and ATTACHES it to the post. The image is returned so you can show it to the user. It USES THE USER'S IMAGE CREDITS and takes up to a minute. To make one of the post's image ideas (rewrite_plan_post part scenes), pass that idea's image_prompt as prompt and its image_avoid as avoid; up to 3 can be made at the same time. Do not call it again if it times out or says the post has as many images in the making as it can: read the post with list_plan_posts (task_id) and wait for them.
Inputs: task_id (required), avoid, prompt.
Writes a run of posts for ONE social group with Sociro's AI Planner: each post gets a caption per platform, a theme and an image scene, in the brand's voice, at good times. Every post is SAVED WAITING FOR REVIEW: nothing is published until approve_plan_posts. It USES THE USER'S AI CREDITS for each post, so tell the user how many posts it will write and ask first. It waits for the whole plan (often half a minute to a few minutes). Do not call it again if it times out: the plan may have been written; look with list_plan_posts. Then show the posts, and offer rewrite_plan_post, make_plan_post_image and update_plan_post.
Inputs: prompt (required), timezone (required), start_date (required), days, +8 more.
Sends a DRAFT (saved with create_post save_as_draft, or in the Sociro app): scheduled for later (scheduled_at) or published at once (publish_now: true). Exactly one of the two. This puts a post on real accounts, so only call it when the user has said to send that draft and when. The draft is checked against each platform here; if it does not fit, it stays a draft and the reasons are returned. Find drafts with list_posts status DRAFT.
Inputs: task_id (required), timezone, publish_now, scheduled_at.
Removes ONE post that is still waiting for review from its plan. Its images stay in the media library. It cannot be undone, so only when the user asks. Approved posts are canceled with cancel_post instead.
Inputs: task_id (required).
Rewrites one post waiting for review with Sociro's AI Planner, which keeps the brand's voice and the plan's other posts in view. part: caption (the image scene stays), scene (a new image scene; the caption stays), post (all of it), or scenes (3 different image ideas to choose from or post together as a carousel; nothing else changes, make each with make_plan_post_image and its prompt and avoid). Put what the user wants changed in instruction, in their words. It USES THE USER'S AI CREDITS (one planned post). Images already on the post stay. For a small change you can make yourself, use update_plan_post instead.
Inputs: part (required), task_id (required), instruction.
Sets or replaces the library thumbnail of a video in the Sociro media library, from an https image link. JPG, PNG or WebP. This is also the image create_post uses as the cover when cover.use_video_thumbnail is true.
Inputs: media_file_id (required), image_url.
Changes an AI Planner post that is still waiting for review: caption, the caption of single platforms, theme, image scene, date and time, accounts, media, YouTube title. date and time are in the post's own timezone. media_file_ids and account_ids REPLACE the whole list: read the post first and send every one that should remain. Uses no credits. An approved post cannot be changed here (use update_post).
Inputs: task_id (required), date, time, theme, +6 more.
Changes a post that is still SCHEDULED, or a DRAFT: its caption, the caption of single accounts, its media, its accounts, or its time. Read the post with get_post first: media_file_ids and account_ids REPLACE the whole list, so send every one that should remain. A scheduled post must still fit every platform after the change, or nothing is changed. A draft takes no time (publish_draft gives it one). Platform options (YouTube title, TikTok settings, covers, the first comment) cannot be changed, and a TikTok account cannot be added: cancel and create again.
Inputs: task_id (required), caption, timezone, account_ids, +3 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Add one secure layer between your agents and this server.
