AdaptlyPost
Server Details
Post + analytics: Instagram, TikTok, YouTube, X, Facebook, LinkedIn, Pinterest, Threads, Bluesky
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- AdaptlyPost - social media scheduler
TDQS
Scored across 89 tools
Most tools target a distinct resource and action, and the descriptions carefully explain boundaries such as create_post vs bulk_schedule_posts vs update_post vs publish_draft. A few clusters are less clean: upload_media, get_upload_urls, open_upload_widget, and get_upload_ticket all relate to media ingestion, and the five analytics tools overlap in scope even though their descriptions differentiate them.
All tool names use snake_case and follow a predictable verb_noun convention: list_*, get_*, create_*, update_*, delete_*, reply_to_*, and so on. Variations like remove_account versus delete_post and refresh_inbox versus trigger_analytics_sync are internally consistent with the resource semantics.
With 89 tools, the surface is far beyond what an agent can comfortably navigate, even for a broad social media management domain. Many niche operations could be consolidated or moved behind fewer resource-oriented tools; the count alone creates selection overhead and increases the chance of wrong-tool choices.
Coverage is broad and deep across posts, bulk publishing, validation, recurring posts, RSS, inbox management, analytics, webhooks, workspaces, members, invitations, media uploads, and AI helpers. There are minor gaps, such as no update_workspace and no update_recurring_post (editing series is app-only), but most core workflows have a complete lifecycle.
Available Tools
89 toolsbulk_schedule_postsBulk Schedule PostsADestructiveInspect
Schedule a batch of posts in one call to the same platforms and accounts. Each item supplies its own text, contentType, scheduledAt, and optional media; platforms, connection-id arrays, timezone, and platform configs are shared by every item, though an item may carry its own tiktokConfigs, youtubeConfigs, instagramConfigs, facebookConfigs, pinterestConfigs, googleBusinessConfigs, tumblrConfigs or wordpressConfigs to replace the shared ones, plus its own firstComments, threadReplies, platformThumbnails, platformMedia and platformAspectRatios. twitterKeepLinks, twitterConfigs and linkedinConfigs are not available in bulk. Call validate_bulk_posts with the same input first to see the problems of every item without creating anything. Items are processed independently: each is validated and created like create_post, so one bad item fails alone while the rest are scheduled. Returns { totalScheduled, totalFailed, results[] } with a postId or errorMessage per item, in input order; read every row. An item with a past scheduledAt publishes immediately rather than being rejected. Call list_accounts first; TikTok needs tiktokConfigs with privacyLevel, and Pinterest takes pinterestConfigs with a boardId from list_pinterest_boards or a boardName, not both; an item whose boardName matches no board or several fails alone. Use create_post for a single post or a draft; this tool has no draft mode. These posts publish publicly to the user's social accounts: show the user every item's text, media and time plus the accounts, and get their confirmation before calling. Each call creates new posts, so calling again after an error or timeout can publish duplicates; check list_posts first.
Inputs: posts (required), platforms (required), pageIds, timezone, +22 more. Returns: result
check_accountCheck AccountAIdempotentInspect
Re-check a Facebook page with Facebook now, using its stored token, and return its fresh status. A rejected token marks the page unauthorized (unauthorizedReason carries Facebook's message); a working token clears an earlier unauthorized mark. Facebook pages only: any other account fails with 400. Pages are also checked automatically twice a day. Use it after the user reconnects or fixes a page, or when a Facebook post failed with a token error. Needs the accounts.manage permission, which Admin holds. Nothing is posted.
Inputs: accountId (required), workspaceId. Returns: result
check_rss_feedCheck RSS Feed NowADestructiveIdempotentInspect
Move an RSS feed's next check to now; the feed is fetched within a minute and any new items are posted according to its post mode. Use it when the user just published an article and does not want to wait for the interval. Read list_rss_feed_items a minute later to see the result. Ids outside the workspace return 404. Needs the posts.draft permission.
Inputs: id (required), workspaceId. Returns: result
create_connect_linkCreate Connect LinkAInspect
Create a link someone else, such as a client, opens to connect their social accounts to this workspace without an AdaptlyPost login. With no options it is a quick link: it lasts 7 days, offers every platform, shows the client every account in the workspace and connects any number of accounts. visibility PRIVATE shows the client only the accounts they connected through the link; allowedPlatforms limits the platforms offered; maxAccounts makes the link stop working once that many accounts are connected through it; expiresAt or neverExpires changes when it stops working; returnUrl sends the client back to your app afterwards. Returns the url to send, plus startUrls, one per platform that connects through the network's own consent screen, for your own connect buttons. Connected accounts then show up in list_accounts. Revoke it with revoke_connect_link. Needs the accounts.manage permission, which Admin holds.
Inputs: name, expiresAt, returnUrl, visibility, +4 more. Returns: result
create_postCreate PostADestructiveInspect
Create one post on the user's own connected social accounts. saveAsDraft saves a DRAFT and publishes nothing; a scheduledAt sent with it becomes the draft's planned date, which publish_draft later schedules. Without saveAsDraft, a future scheduledAt schedules the post; otherwise it publishes now. Before publishing or scheduling, show the user the final text, media, accounts and time (or repeat schedule) and get their confirmation; a draft needs no confirmation. Account ids come from list_accounts (pass them as accountIds, or as platforms plus the per-platform arrays) and mediaUrls from upload_media. Platform-specific options (TikTok privacy, Pinterest board, LinkedIn document or reshare, Google Business event or offer, Tumblr tags, WordPress title, excerpt, categories, tags and whether the site gets a live post, a draft or a post pending review, YouTube audio language and scheduling on YouTube, Instagram user tags, Facebook link carousel, first comments, threads of replies, different media for one platform, recurrence) are described on each field. To find every problem before creating anything, call validate_post with the same input first. Publishing runs per platform in the background, so the response ({ postId, queuedPlatforms, isScheduled, scheduledAt }) is not the outcome; check list_post_results. Each call creates a separate post, so after an error or timeout check list_posts before trying again. Use update_post or publish_draft for an existing post and bulk_schedule_posts for many posts.
Inputs: contentType (required), text, pageIds, timezone, +40 more. Returns: result
create_rss_feedCreate RSS FeedADestructiveInspect
Connect an RSS or Atom feed so each new item becomes a post on the target accounts. The feed is fetched and every item already in it is recorded, so only items that appear later are posted; postLatestItem also posts the newest one on the first check. The feed is then checked every checkIntervalMinutes and posts as the member who saved it, as a draft, a scheduled post or straight away (postMode). With postMode SCHEDULE or PUBLISH, posts go out on the user's accounts without further confirmation, so confirm the feed, the accounts, the mode and the text with the user first. Try preview_rss_feed first to show what the posts will say. Fails with 400 for invalid settings, a URL that is not a feed, a feed already connected or the 20-feed workspace limit, and 503 when the feed cannot be reached. Needs posts.draft, plus the permission of the post mode.
Inputs: url (required), targets (required), postMode (required), contentMode (required), +12 more. Returns: result
create_webhookCreate WebhookAInspect
Register a URL that receives workspace events as HTTP POSTs. Without events it gets the default set: post.published, post.partially_failed, post.failed, post.scheduled, account.unauthorized, image.completed and image.failed. To also get inbox events (comment.created, comment.replied, mention.created, message.received, review.created), list every event wanted in events, since a non-empty list means only those. Each delivery carries the x-adaptly-signature, x-adaptly-timestamp, x-adaptly-event and x-adaptly-webhook-id headers; the signature is sha256=HMAC_SHA256(secret, "{timestamp}.{rawBody}"). Failed deliveries are retried up to 5 times with exponential backoff, and an endpoint is turned off after 20 failed deliveries in a row. Returns the new webhook (id, url, active, events, createdAt, updatedAt, lastSuccessAt, lastFailureAt, disabledAt). The signing secret never comes back to you: the result carries secretRevealUrl, a link the user opens in their browser to see the secret once within 30 minutes (on a local install, secretFile, a file only the user can read). Give the user that link or path and do not open, fetch or read it yourself. If the user loses the secret, delete the webhook and create it again. Fails with 400 for an invalid URL or the webhook limit, and 409 when the URL is already registered. Needs the webhooks.manage permission, which Admin and Editor hold.
Inputs: url (required), events, workspaceId. Returns: result
create_workspaceCreate WorkspaceAInspect
Create a workspace in the organization of the workspace the call acts in (the current one unless workspaceId names another). Every organization owner and admin becomes its admin. Returns the workspace with id, name, description, organizationId, isDefault, connectionLimit and createdAt; pass id as workspaceId to act in it, for example to send_invitation or create_connect_link there. Needs the workspace.manage permission, which Admin holds. The member who created the key, or the signed-in member, must also be an organization owner or admin (org-owner or org-admin); otherwise it fails with 403 permission_denied. Fails with 403 subscription_required when the plan has no room for another workspace (the error names the limit and current usage): tell the user to upgrade and do not retry. Fails with 400 when a workspace with this name already exists in the organization.
Inputs: name (required), description, workspaceId, connectionLimit. Returns: result
delete_inbox_commentDelete CommentADestructiveIdempotentInspect
Delete a comment on the platform and from the inbox, where capabilities.canDelete is true. Facebook and LinkedIn allow any comment on the Page's or organization's posts, Instagram any comment on the account's media, and YouTube, Threads, Bluesky and Mastodon only the account's own comments and replies. Anything else answers 400 inbox_action_unsupported; stop there. Returns { deleted: true }. It cannot be undone, so confirm with the user first, quoting the comment. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
delete_inbox_review_replyDelete Review ReplyADestructiveIdempotentInspect
Delete the location's reply to a Google review; the review itself stays. It cannot be undone, so confirm with the user first, quoting the reply. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
delete_postDelete PostADestructiveIdempotentInspect
Delete a post record from AdaptlyPost by id. Use it to cancel a DRAFT or SCHEDULED post before it goes out; a deleted scheduled post will not publish. Deleting never removes content already on a network: for a COMPLETED or PARTIAL_FAILURE post this only drops AdaptlyPost's record, and the live posts stay up until removed on each platform. Prefer update_post to change a post instead of deleting and recreating it. A post in PUBLISHING fails with 409; wait for list_post_results to settle. Deleting a post before scheduledAt also deletes a video it already uploaded to YouTube with scheduleOnYouTube; when YouTube refuses, the delete fails with 502 SCHEDULED_VIDEO_DELETE_FAILED and the post stays, so try again, after reconnecting the channel if it was disconnected. Only posts in the workspace (the current one unless workspaceId names another) can be deleted; others return "Post not found or access denied". Returns { deleted: true }. Irreversible.
Inputs: id (required), workspaceId. Returns: result
delete_recurring_postDelete Recurring PostADestructiveIdempotentInspect
Delete a recurring post: the series stops for good and its upcoming SCHEDULED post is deleted. Posts that already went out are kept. Prefer pause_recurring_post when the user may want the series back. To skip a single date, delete that occurrence with delete_post instead; the series continues. Ids outside the workspace (the current one unless workspaceId names another) return "Recurring post not found". Returns { deleted: true }. Irreversible.
Inputs: id (required), workspaceId. Returns: result
delete_rss_feedDelete RSS FeedADestructiveIdempotentInspect
Delete an RSS feed: it stops being checked for good. Posts it already created stay. Prefer pause_rss_feed when the user may want it back. Ids outside the workspace return 404. Needs the posts.draft permission. Returns { deleted: true }. Irreversible.
Inputs: id (required), workspaceId. Returns: result
delete_webhookDelete WebhookADestructiveIdempotentInspect
Delete a webhook endpoint; it receives nothing more. Use update_webhook with active: false to pause it instead. Needs the webhooks.manage permission. Returns { deleted: true }. Irreversible.
Inputs: id (required), workspaceId. Returns: result
delete_workspaceDelete WorkspaceADestructiveIdempotentInspect
Delete a workspace of the organization with everything it holds: posts, RSS feeds, inbox items, API keys and connect links. This cannot be undone. The default workspace, the organization's last workspace and a workspace that still has connected social accounts cannot be deleted (400); disconnect its accounts with remove_account first. Confirm with the user first, naming the workspace and saying what it holds. Needs the workspace.manage permission, which Admin holds. The member who created the key, or the signed-in member, must also be an organization owner or admin (org-owner or org-admin); otherwise it fails with 403 permission_denied. Fails with 404 when the workspace is not in this organization. Returns { success: true }.
Inputs: id (required), workspaceId. Returns: result
generate_captionGenerate CaptionAInspect
Write a new social media caption from a prompt with AdaptlyPost AI. Returns { caption }, text only; nothing is saved or posted, so pass the caption to create_post, update_post or bulk_schedule_posts yourself. Pass platform and generation targets that platform's character limit; check the returned text before posting. Needs the ai.generate permission, which Admin, Editor and Contributor hold and Viewer does not (403 permission_denied). Each call spends 2 of the member's AI credits (the member who signed in or created the key), refunded if generation fails, unless the member has their own AI provider key connected in AdaptlyPost. With no credits left the call fails: explain that generation is unavailable with the current credit balance and do not retry automatically. To rework a caption you already have, use refine_caption instead.
Inputs: prompt (required), platform, workspaceId. Returns: result
generate_imageGenerate ImageAInspect
Create an image from the user's prompt with AdaptlyPost AI and save it to the user's own AI image studio in AdaptlyPost. Nothing is posted. It returns { jobId, sessionId, status } right away with status queued; poll get_image_job with the jobId every few seconds until status is completed or failed (usually 10 to 40 seconds). A completed job carries imageUrl, which can go straight into mediaUrls of create_post. Reuse sessionId to keep related images together. Needs the ai.generate permission, which Admin, Editor and Contributor hold and Viewer does not (403 permission_denied). Uses the member's AdaptlyPost AI credits (2 for standard, 4 for premium, none when the member connected their own image provider key) and refunds them if the job fails. With no credits left the job fails with an error saying so; tell the user and do not retry.
Inputs: prompt (required), model, quality, sessionId, +3 more. Returns: result
get_analytics_overviewGet Analytics OverviewARead-onlyIdempotentInspect
Workspace-wide performance for a date window: views, likes, comments, shares, followers, posts published, average views per post and engagement rate, each as { value, previousValue, deltaPercent } against the window of the same length just before it. Use this for "how did we do this month" questions and for follower counts. Metrics are summed over the selected platforms; partialMetrics names metrics some selected platform cannot report, and a metric no platform reports is null. Analytics cover Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky, LinkedIn, YouTube, X and Google Business Profile (location impressions only, no per-post numbers); Mastodon, Telegram, Tumblr and WordPress have none. Connecting an account imports its posts from the last 180 days, and analytics are kept from then on while the account stays connected, so any date range in that history can be queried. Analytics refresh every few hours (lastSyncedAt says when); if the user just published, call trigger_analytics_sync first. Use get_analytics_timeseries for a trend, get_platform_breakdown to compare platforms, and list_post_analytics for individual posts.
Inputs: to (required), from (required), platforms, workspaceId, +1 more. Returns: result
get_analytics_sync_statusGet Analytics Sync StatusARead-onlyIdempotentInspect
How fresh the analytics are, per connected account. Returns syncInProgress, lastSyncedAt, historyHorizonAt (the earliest date any account has data for; earlier dates have no data rather than zero activity) and platforms: one row per account with status (IDLE, QUEUED, SYNCING, FAILED), lastSyncedAt, lastErrorMessage, historyHorizonAt and needsAnalyticsReconnect. When needsAnalyticsReconnect is true the account was connected before analytics permissions existed and returns nothing until the user reconnects it (a connect link works); tell them, do not keep querying. Call this when numbers look stale or empty, and after trigger_analytics_sync to see the run finish. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
get_analytics_timeseriesGet Analytics TimeseriesARead-onlyIdempotentInspect
Views, likes, comments, shares, followers, posts published and engagement rate bucketed by day (default), week or month across the window, for trend questions such as "how are views moving" or "when did followers jump". Returns { points } with one { date, ...metrics } per bucket; followers is the latest count at the end of the bucket, the other counters sum posts published inside it, and a metric no selected platform reports is null. Use get_analytics_overview for totals and list_post_analytics to see which posts drove a spike.
Inputs: to (required), from (required), platforms, granularity, +2 more. Returns: result
get_image_jobGet Image JobARead-onlyIdempotentInspect
Read the state of an image started with generate_image. Returns { jobId, sessionId, status, imageUrl, imageId, error }; status moves from queued through processing and generating to completed or failed. When completed, imageUrl is a public URL ready for mediaUrls in create_post. When failed, error says why, for example no credits left; a failed job is final, so do not poll it again. Poll every few seconds while status is queued, processing or generating, and stop after a couple of minutes. Only jobs started by the same member are visible. Needs the ai.generate permission, which Admin, Editor and Contributor hold and Viewer does not (403 permission_denied). Reading a job spends no credits.
Inputs: jobId (required), workspaceId. Returns: result
get_inbox_commentGet Inbox CommentARead-onlyIdempotentInspect
Get one inbox comment with its parent comment (when it is a reply) and the replies under it, to read a conversation before answering. 404 inbox_item_not_found when the id is unknown in this workspace. Needs the inbox.read permission, which every role holds.
Inputs: id (required), workspaceId. Returns: result
get_inbox_conversationGet Inbox ConversationARead-onlyIdempotentInspect
Get one direct message conversation with its messages, to read the thread before answering. 404 inbox_item_not_found when the id is unknown in this workspace. Needs the inbox.read permission, which every role holds.
Inputs: id (required), workspaceId. Returns: result
get_inbox_summaryGet Inbox SummaryARead-onlyIdempotentInspect
Unread counts for the workspace inbox and what each connected account can do in it. The inbox holds comments on the account's posts (Facebook, Instagram, Threads, YouTube, Bluesky, Mastodon and LinkedIn), mentions (Facebook, Instagram, Threads, Bluesky and Mastodon), direct messages (Facebook, Instagram, Bluesky and Mastodon) and Google Business Profile reviews; TikTok and X have no inbox. Each account lists comments, mentions, messages and reviews as AVAILABLE, RECONNECT_REQUIRED (the account lacks the platform permission, some of which still wait on platform review, or its token expired: tell the user to reconnect it in AdaptlyPost) or UNSUPPORTED. Returns { unread, accounts }: unread comment, mention, conversation and review counts, and one entry per account with each channel's access. Call it first when the user asks what is new or why a channel is empty. The inbox syncs every 10 minutes per account; refresh_inbox asks for a sync now. Needs the inbox.read permission, which every role holds. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
get_meGet My AccessARead-onlyIdempotentInspect
Describe this connection in the workspace (the current one unless workspaceId names another): whether it is an API key or a sign-in, its role, the permission keys it holds, can { draft, schedule, publish } and a one-sentence summary of what it may do. An API key never holds more than the member who created it (issuerRole). Call this before an action the role may not allow, instead of trying and reading a 403. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
get_platform_breakdownGet Platform BreakdownARead-onlyIdempotentInspect
The overview metrics split per platform for a date window, for "which platform performs best" comparisons. Returns { platforms }: one row per platform with analytics data, carrying followers, views, likes, comments, shares, postsCount, avgViewsPerPost and engagementRate (each { value, previousValue, deltaPercent }) plus supportedMetrics, the metrics that platform actually reports; compare only metrics both platforms list there. Google Business Profile reports location impressions only. Takes no platform filter; connectionIds narrows it to some accounts. Use get_analytics_overview for the combined total.
Inputs: to (required), from (required), workspaceId, connectionIds. Returns: result
get_postGet PostARead-onlyIdempotentInspect
Get one post's full record by id: text, contentType, status, scheduledAt, timezone, and a platforms array with each target's connection, status, errorMessage, and media. Visible only within the workspace (the current one unless workspaceId names another); any other id returns "Post not found or access denied". Use this to inspect content before update_post or publish_draft. Use list_post_results instead when you only need per-platform publishing outcomes and the platformIds for retry_failed_platforms, and list_posts to find ids by status, platform, or date. Post ids come from create_post, bulk_schedule_posts, or list_posts.
Inputs: id (required), workspaceId. Returns: result
get_recurring_postGet Recurring PostARead-onlyIdempotentInspect
Get one recurring post (series) by id: status, pauseReason and lastError when paused, the schedule (frequency, interval, weekdays, startsAt, timezone, endsOn, maxOccurrences), nextOccurrenceAt (the next slot not yet created as a post; absent once ENDED), occurrenceCount (posts created so far), and the content and platforms each occurrence copies. Ids outside the workspace (the current one unless workspaceId names another) return "Recurring post not found". Ids come from list_recurring_posts, the recurringPostId returned by create_post, or the recurringPostId on a post from get_post or list_posts.
Inputs: id (required), workspaceId. Returns: result
get_rss_feedGet RSS FeedARead-onlyIdempotentInspect
Get one RSS feed by id: its settings, targets, status, pauseReason and lastError, and when it was last checked and last posted. Use list_rss_feed_items to see what it did with each item. Ids outside the workspace return 404. Needs the posts.read permission.
Inputs: id (required), workspaceId. Returns: result
get_upload_ticketGet Upload TicketAIdempotentInspect
Called by the upload box that open_upload_widget shows, once per file, to authorize storing that file in AdaptlyPost media storage. Returns a ticket valid for 5 minutes. Do not call this yourself; call open_upload_widget instead.
Inputs: workspaceId. Returns: result
get_upload_urlsGet Media Upload URLsAInspect
Get presigned upload URLs for direct file uploads. Returns uploadUrl (PUT your file here) and publicUrl (use in create_post mediaUrls). This only mints a URL. You MUST PUT the file to uploadUrl and confirm a 2xx response before using publicUrl, otherwise create_post/bulk rejects it with "Media file(s) not found in storage". If the PUT cannot reach uploadUrl, for example a sandbox network proxy answers 403 or the storage host is not on its allowlist, do not retry it, do not stop, and never put the files in a public repo or file-sharing link: call open_upload_widget and have the user add the files through the upload box or upload link it returns. If the files are ones you made, hand them to the user as downloads first. Prefer upload_media for public URLs and for inline files under 30 MB; use this for larger files you hold yourself. For each file, provide fileName and the mimeType that matches it. GIFs post only to Facebook, X, Bluesky, Mastodon, LinkedIn, Tumblr and WordPress, and the document types are for LinkedIn DOCUMENT posts. Keep the extension in fileName, since the post reads the file type from it. A publicUrl may be reused across any number of posts; the file is kept until the last post referencing it has published.
Inputs: files (required), workspaceId. Returns: result
get_webhookGet WebhookARead-onlyIdempotentInspect
Get one webhook endpoint by id. Ids outside the workspace return 404. Needs the webhooks.read permission.
Inputs: id (required), workspaceId. Returns: result
hide_inbox_commentHide CommentADestructiveIdempotentInspect
Hide a comment on the platform so other people no longer see it, where capabilities.canHide is true. Confirm with the user first, naming the comment. A comment that cannot be hidden answers 400 inbox_action_unsupported; stop there. unhide_inbox_comment reverses it. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
like_inbox_commentLike CommentAIdempotentInspect
Like a comment from the account, on Facebook, Bluesky, Mastodon (a favourite) and LinkedIn. Instagram, YouTube and Threads do not allow it, and a comment whose capabilities.canLike is false answers 400 inbox_action_unsupported; stop there. The like is public. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
list_accountsList Connected AccountsARead-onlyIdempotentInspect
List the social accounts connected to the workspace (the current one unless workspaceId names another) across all fourteen platforms. Returns { accounts } with id, platform, displayName, username, avatarUrl, status, pageId for Facebook pages, and supportsInstagramAudio for Instagram (true when the account can add audio to Reels, see search_instagram_audio). For a Pinterest account, list_pinterest_boards returns the boards it can pin to; for a WordPress site, list_wordpress_categories returns its categories. For a Google Business Profile location displayName is the location title and username is empty; its id goes in googleBusinessConnectionIds. status is active or unauthorized; an unauthorized account (unauthorizedReason carries the platform's message) is refused with 400 by create_post until the user reconnects it in AdaptlyPost, so leave it out and tell the user. Call this before create_post, update_post, or bulk_schedule_posts: they take these ids, never usernames. Pass the ids as accountIds, or put each id in the array for its platform (linkedinConnectionIds, tumblrConnectionIds, telegramConnectionIds, wordpressConnectionIds, and so on); Facebook page accounts go in pageIds. check_account re-checks a Facebook page with Facebook, and remove_account disconnects an account. Not for post history or publishing status: use list_posts or list_post_results for those. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
list_discovered_postsList Discovered PostsARead-onlyIdempotentInspect
Posts found on the connected accounts that were not published through AdaptlyPost (published natively or with another tool), inside the window: text, thumbnail, permalink, account and publish time. They are read-only; their metrics are in list_post_analytics. Use it to show what an account posted outside AdaptlyPost or to fill in the calendar. Needs the analytics.read permission.
Inputs: to (required), from (required), limit, platforms, +2 more. Returns: result
list_inbox_commentsList Inbox CommentsARead-onlyIdempotentInspect
List comments on the account's posts, newest first, on Facebook, Instagram, Threads, YouTube, Bluesky, Mastodon and LinkedIn. Filter by account, platform, status, date, text, an AdaptlyPost post (postId from list_posts) or the platform's own post id. Page with cursor while hasMore is true. Each comment's capabilities say whether it can be replied to, hidden, deleted or liked. The inbox syncs every 10 minutes per account; refresh_inbox asks for a sync now. Needs the inbox.read permission, which every role holds.
Inputs: limit, since, cursor, postId, +6 more. Returns: result
list_inbox_conversationsList Inbox ConversationsARead-onlyIdempotentInspect
List direct message conversations, most recent message first, on Facebook (Messenger), Instagram, Bluesky and Mastodon. Returns { conversations, total, hasMore, nextCursor }; each conversation has the account, the other participant, the last message text and time, its inbox status, replyWindowEndsAt and capabilities.canReply, but not the messages themselves, which get_inbox_conversation returns. Page with cursor while hasMore is true. An account whose messages show RECONNECT_REQUIRED in get_inbox_summary returns none until the user reconnects it in AdaptlyPost. The inbox syncs every 10 minutes per account; refresh_inbox asks for a sync now. Needs the inbox.read permission, which every role holds.
Inputs: limit, since, cursor, search, +4 more. Returns: result
list_inbox_mentionsList Inbox MentionsARead-onlyIdempotentInspect
List posts and comments that mention the account, newest first, on Facebook, Instagram, Threads, Bluesky and Mastodon. Page with cursor while hasMore is true. An account whose mentions show RECONNECT_REQUIRED in get_inbox_summary returns none until the user reconnects it in AdaptlyPost. The inbox syncs every 10 minutes per account; refresh_inbox asks for a sync now. Needs the inbox.read permission, which every role holds.
Inputs: limit, since, cursor, search, +4 more. Returns: result
list_inbox_reviewsList Inbox ReviewsARead-onlyIdempotentInspect
List Google Business Profile reviews of the connected locations, newest first. Returns { reviews, total, hasMore, nextCursor }; each review has the location, reviewer name, star rating, text, the location's current reply (or null), its inbox status and capabilities.canReply. Filter by rating and by whether the review already has a reply, plus the usual inbox filters. Page with cursor while hasMore is true. The inbox syncs every 10 minutes per account; refresh_inbox asks for a sync now. Needs the inbox.read permission, which every role holds.
Inputs: limit, since, cursor, search, +6 more. Returns: result
list_invitationsList InvitationsARead-onlyIdempotentInspect
List the invitations that include the workspace (the current one unless workspaceId names another), newest first, whatever their status. Returns { invitations, total, hasMore }. Page with offset while hasMore is true. Needs the members.manage permission, which Admin holds.
Inputs: limit, offset, workspaceId. Returns: result
list_membersList MembersARead-onlyIdempotentInspect
List the members of the workspace (the current one unless workspaceId names another). Returns { members } with userId, email, firstName, lastName, role (admin, editor, contributor or viewer in this workspace), organizationRoles (such as org-owner, org-admin or org-member) and joinedAt. Pass userId to remove_member or remove_organization_member. Needs the members.read permission, which every role holds. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
list_pinterest_boardsList Pinterest BoardsARead-onlyIdempotentInspect
List the boards of a connected Pinterest account, secret boards included. Returns { boards } with id, name, description, privacy (PUBLIC, PROTECTED or SECRET) and pinCount. Call it before posting to Pinterest, ask the user which board to pin to unless they already named one, and pass that board's id as pinterestConfigs[].boardId in create_post, update_post or bulk_schedule_posts. When the user named a board you may pass that name as boardName instead, never both; a name that matches no board, or several, fails with 400 and nothing falls back. A board belongs to one Pinterest account, so call it once per Pinterest account. A post sent without boardId or boardName goes to a public board named AdaptlyPost, which is created on first use. Fails with 404 when accountId is not a Pinterest account in the workspace, and with 400 when Pinterest refuses the request, which usually means the user must reconnect the account in AdaptlyPost. Nothing is posted.
Inputs: accountId (required), workspaceId. Returns: result
list_post_analyticsList Post AnalyticsARead-onlyIdempotentInspect
Per-post metrics for posts published inside the window, sorted by a metric or by publish date, paginated. Use it for "top posts", "which post got the most comments" and "how did post X do". Covers posts published through AdaptlyPost and posts discovered on the connected accounts; Google Business Profile posts are listed with null metrics, since that platform reports only location impressions; discovered posts have postId and postPlatformId set to null, while AdaptlyPost posts carry the postId used by get_post. Returns { posts, total, page, limit, hasMore }; each post has platform, publishedAt, title, thumbnailUrl, permalink, connectionId, accountName and metrics { views, likes, comments, shares, saves, clicks, impressions, reach, engagementRate, plus engagedViews, averageViewDurationSeconds and averageViewPercentage on YouTube }, with null for metrics the platform does not report. Sort by a metric for a ranked list (list_top_posts returns the top few in one call); PUBLISHED_AT (default) for a chronological review. Not for publishing status: use list_post_results for that.
Inputs: to (required), from (required), page, limit, +4 more. Returns: result
list_post_resultsList Post ResultsARead-onlyIdempotentInspect
Get one post's per-platform publishing outcomes: { postId, status, results[] } where each result has platformId, platform, accountName, status (PENDING, PUBLISHING, PUBLISHED, or FAILED), platformPostId, errorMessage, publishedAt, and tiktokDraftFallback (true when TikTok's daily cap sent the content to the TikTok inbox as a draft instead of publishing it; tell the user to finish it in the TikTok app). Each platform reports separately, so read every row instead of treating the post as one pass or fail. Call this after create_post, publish_draft, or retry_failed_platforms, since publishing is asynchronous and their responses only confirm queueing; poll until no row is PENDING or PUBLISHING. Take platformId from FAILED rows for retry_failed_platforms. Use get_post when you also need the content and schedule.
Inputs: id (required), workspaceId. Returns: result
list_postsList PostsARead-onlyIdempotentInspect
List posts in the workspace (the current one unless workspaceId names another), any status, newest first by default. Returns { posts, total, hasMore }; each post carries its status and a platforms array with per-platform status. Filters: statuses, platforms (posts targeting any of them), and startDate/endDate, which bound scheduledAt, or createdAt for posts never scheduled. Page with offset while hasMore is true. Use this to find post ids or check what is already queued. Use get_post for one post's full record and list_post_results for one post's per-platform outcomes and retry ids.
Inputs: limit, offset, endDate, statuses, +4 more. Returns: result
list_recurring_postsList Recurring PostsARead-onlyIdempotentInspect
List the recurring posts (series) in the workspace (the current one unless workspaceId names another), created by passing recurrence to create_post. Returns { recurringPosts, total, hasMore }; each series has id, status (ACTIVE, PAUSED or ENDED), pauseReason when paused, frequency, interval, weekdays, startsAt, timezone, endsOn or maxOccurrences, nextOccurrenceAt, occurrenceCount, and the content and platforms every occurrence copies. Only the next occurrence of an ACTIVE series exists as a SCHEDULED post, created about 24 hours ahead; list_posts shows it with recurringPostId set. A series pauses itself after 3 failed posts in a row, when the subscription lapses, when its creator loses workspace access, when one of its accounts is disconnected, or when a platform rejects the content; pauseReason and lastError say which. Page with offset while hasMore is true. Editing a series or skipping one date is only possible in the AdaptlyPost app.
Inputs: limit, offset, statuses, workspaceId. Returns: result
list_rss_feed_itemsList RSS Feed ItemsARead-onlyIdempotentInspect
List the items an RSS feed has seen, newest first, leaving out the ones already in the feed when it was added. Each item has a status: PROCESSING, POSTED (postId links it to its post, for get_post), FILTERED (keyword rules), SKIPPED (published more than 14 days before the feed was added) or FAILED (error says why). Returns { items } with id, createdAt, title, link, publishedAt, status, postId and error per item. Use it to answer why an article was or was not posted. Needs the posts.read permission.
Inputs: id (required), limit, workspaceId. Returns: result
list_rss_feedsList RSS FeedsARead-onlyIdempotentInspect
List the RSS and Atom feeds connected to the workspace (the current one unless workspaceId names another), newest first; a workspace holds at most 20. Each new item of a feed becomes a post on its targets. A feed pauses itself after 5 failed fetches in a row (FETCH_FAILURES), 3 items in a row that failed to post (CONSECUTIVE_FAILURES), when its owner loses the permission its post mode needs (ACCESS_LOST), when the plan no longer covers publishing (SUBSCRIPTION_INACTIVE) or when every target account was disconnected (CONNECTION_REMOVED); pauseReason and lastError say which. Needs the posts.read permission. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
list_top_postsList Top PostsARead-onlyIdempotentInspect
The best-performing posts published inside the window, ranked by one metric (VIEWS by default), in one call: the same rows as list_post_analytics without pagination. Use it for "what were our top 5 posts this month". Covers posts published through AdaptlyPost and posts discovered on the connected accounts (postId null). connectionIds narrows it to some accounts. Needs the analytics.read permission.
Inputs: to (required), from (required), limit, sortBy, +3 more. Returns: result
list_webhooksList WebhooksARead-onlyIdempotentInspect
List the webhook endpoints registered for the workspace (the current one unless workspaceId names another), with whether each is active and when it last succeeded or failed. Needs the webhooks.read permission, which Admin, Editor and Viewer hold. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
list_wordpress_categoriesList WordPress CategoriesARead-onlyIdempotentInspect
List the categories of a connected WordPress site, sorted by name. Returns { categories } with id, name and parentId (null for a top-level category). Call it when the user names categories for a WordPress post, match the names to ids, and pass those ids as wordpressConfigs[].categoryIds in create_post, update_post or bulk_schedule_posts. Categories belong to one site, so call it once per WordPress account. A post sent without categoryIds goes to the site's default category. Fails with 404 when accountId is not a WordPress account in the workspace, and with an error carrying the reason when the site refuses the request or cannot be reached, which may mean the user must reconnect the site in AdaptlyPost. Nothing is posted.
Inputs: accountId (required), workspaceId. Returns: result
list_workspacesList WorkspacesARead-onlyIdempotentInspect
List the workspaces this sign-in can act in, across every organization the user belongs to. Returns { workspaces } with id, name, organization { id, name }, role { key, name }, permissions (the permission keys held there), isDefault, current and can { draft, schedule, publish }. Call this when the user names a workspace, brand, client or organization, or when accounts or posts they expect are missing: then pass the matching id as workspaceId to every other tool. Without workspaceId, tools act in the workspace marked current. An API key belongs to one workspace, so it lists only that one. Takes no arguments.
Inputs: no named parameters. Returns: result
open_upload_widgetUpload From DeviceAInspect
Let the user add photos, videos or documents from their phone or computer. Use it when the user wants to post a file that has no public URL, such as a photo on their phone, a file attached in the chat that upload_media cannot read (in ChatGPT, pass attached files to upload_media as attachments instead), or a file you built in a sandbox whose network blocks the get_upload_urls uploadUrl. Never suggest putting the files in a public GitHub repo or a file-sharing link instead. In apps that show MCP Apps widgets, such as ChatGPT and Claude chat, it shows an upload box in the chat, and when the upload finishes the box sends a message listing the public media URLs. In apps that cannot show the box, such as Claude Cowork and Claude Code, it returns status upload_link with uploadUrl, a page the user opens in their browser to upload, and uploadId: give the user the link, wait until they say they finished, then call this tool again with that uploadId to get the media URLs. Pass the media URLs as mediaUrls to create_post, update_post or bulk_schedule_posts. Nothing is uploaded until the user picks files. Accepts JPEG, PNG, WebP, GIF, MP4, QuickTime, PDF, PPT, PPTX, DOC and DOCX, up to 250 MB per file, 50 MB per image and 100 MB per document. Uploaded files are stored at public URLs.
Inputs: uploadId, workspaceId. Returns: result
pause_recurring_postPause Recurring PostADestructiveIdempotentInspect
Pause a recurring post: it stops creating occurrences and deletes its upcoming SCHEDULED post, preventing future scheduled occurrences until resume_recurring_post; an occurrence already publishing may still complete. Posts already published are kept. Slots that pass while paused are skipped, never published later. Use it when the user wants to hold the series; use delete_recurring_post to stop it for good. Deleting only the upcoming post with delete_post skips that one date and the series continues. Ids outside the workspace (the current one unless workspaceId names another) return "Recurring post not found". Returns the recurring post with status PAUSED and pauseReason USER.
Inputs: id (required), workspaceId. Returns: result
pause_rss_feedPause RSS FeedAIdempotentInspect
Pause an RSS feed: it stops being checked until resume_rss_feed. Posts it already created stay, scheduled ones included; cancel those with delete_post. Ids outside the workspace return 404. Needs the posts.draft permission. Returns the feed with status PAUSED and pauseReason USER.
Inputs: id (required), workspaceId. Returns: result
preview_rss_feedPreview RSS FeedARead-onlyIdempotentInspect
Fetch an RSS or Atom feed without saving it and return its 5 newest items, each with text rendered from template, so the user can see what the posts would say before create_rss_feed. Fails with 400 when the URL is not a feed and 503 when it cannot be reached. Nothing is saved or posted. Needs the posts.draft permission.
Inputs: url (required), template, workspaceId. Returns: result
publish_draftPublish DraftADestructiveInspect
Publish a DRAFT post now or schedule it; SCHEDULED posts are accepted too, to reschedule or push live. Other statuses fail with "Post is not a draft". A future scheduledAt sets SCHEDULED for that time and queues nothing yet; a past one publishes now. Without scheduledAt, a draft whose planned date (the scheduledAt it was saved with) is still in the future is SCHEDULED for that date, and any other post (an undated draft, a planned date already past, a SCHEDULED post) publishes now. publishNow: true publishes now even when the draft has a planned date; sending it with scheduledAt fails with 400. Read the draft with get_post first and tell the user which of these will happen. Publishing now clears the stored scheduledAt, moves the post to PENDING and queues a publishing job per platform: content reaches the networks within moments and cannot be recalled. Fails if an account was disconnected or a TikTok entry lacks privacyLevel; fix with update_post first. A post whose YouTube video already waits on YouTube (scheduleOnYouTube) fails with 409 SCHEDULED_ON_YOUTUBE, since YouTube publishes it at scheduledAt. Not for new content, use create_post. Returns { postId, queuedPlatforms, isScheduled, scheduledAt }: queuedPlatforms lists the platforms whose publishing job was queued and is empty when the post was scheduled for later, so it confirms queueing, not publishing. Check list_post_results afterwards for per-platform outcomes.
Inputs: id (required), timezone, publishNow, scheduledAt, +1 more. Returns: result
refine_captionRefine CaptionAInspect
Rewrite an existing caption following an instruction, such as "shorter", "more playful" or "add a question at the end". Returns { caption }, the rewritten text; nothing is saved or posted. Send partialText to continue from a partly written caption. Pass platform to target that platform's character limit; check the returned text before posting. Needs the ai.generate permission, which Admin, Editor and Contributor hold and Viewer does not (403 permission_denied). Each call spends 2 of the member's AI credits (the member who signed in or created the key), refunded if generation fails, unless the member has their own AI provider key connected in AdaptlyPost. With no credits left the call fails: explain that generation is unavailable with the current credit balance and do not retry automatically. Costs the same as generate_caption.
Inputs: prompt (required), originalText (required), platform, partialText, +1 more. Returns: result
refresh_inboxRefresh InboxAIdempotentInspect
Queue an inbox sync for every connected account now instead of waiting for the next 10-minute run. It returns at once with { queued: true }; new items show up in the list tools a minute or so later, so do not poll in a tight loop. Nothing is sent to anyone. Needs the inbox.read permission, which every role holds. Takes only the optional workspaceId.
Inputs: workspaceId. Returns: result
remove_accountRemove AccountADestructiveIdempotentInspect
Disconnect a social account from the workspace, the same way the Connectors page does: its stored tokens are deleted, it is taken off every pending and recurring post, and it stops counting toward the plan. Works for accounts in any status, so an unauthorized account can be cleaned up without reconnecting it. For Facebook only the named page goes; the other pages of the same login stay connected. Posts already published stay on the network. Confirm with the user first, naming the account. Bringing it back means connecting it again in AdaptlyPost (create_connect_link can send a link). Needs the accounts.manage permission, which Admin holds.
Inputs: accountId (required), workspaceId. Returns: result
remove_memberRemove MemberADestructiveIdempotentInspect
Remove a member from the workspace (the current one unless workspaceId names another) and revoke their API keys and connect links there. They stay in the organization and keep their other workspaces. You cannot remove yourself, and a member's last workspace cannot be removed (400): use remove_organization_member instead. Confirm with the user first, naming the member and the workspace. Needs the members.manage permission, which Admin holds. Fails with 404 when the user is not a member of this workspace. Returns { success: true }.
Inputs: userId (required), workspaceId. Returns: result
remove_organization_memberRemove Organization MemberADestructiveIdempotentInspect
Remove a member from the organization of the workspace the call acts in: they leave every workspace in it, and their API keys and connect links are revoked. The organization owner cannot be removed, only the owner can remove an organization admin, and you cannot remove yourself. Confirm with the user first, naming the member and the workspaces they will lose. Needs the members.manage permission, which Admin holds. The member who created the key, or the signed-in member, must also be an organization owner or admin (org-owner or org-admin); otherwise it fails with 403 permission_denied. Returns { success: true }.
Inputs: userId (required), workspaceId. Returns: result
reply_to_inbox_commentReply To CommentADestructiveInspect
Post a public reply to a comment, from the account the comment was left on. Works where the comment's capabilities.canReply is true, on Facebook, Instagram, Threads, YouTube, Bluesky, Mastodon and LinkedIn. This sends text to a real person from the account: show the user the exact text and the item it answers, and get their yes before calling. Each call posts a new reply, so after an error or timeout read get_inbox_comment before trying again. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), text (required), workspaceId. Returns: result
reply_to_inbox_mentionReply To MentionADestructiveInspect
Post a public reply to a mention, from the account that was mentioned, where capabilities.canReply is true. This sends text to a real person from the account: show the user the exact text and the item it answers, and get their yes before calling. Each call posts a new reply, so after an error or timeout check the mention's replies in list_inbox_mentions before trying again. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), text (required), workspaceId. Returns: result
reply_to_inbox_reviewReply To ReviewADestructiveIdempotentInspect
Post the location's public reply to a Google review. Google allows one reply per review, so this replaces any reply already there; show the user the old reply too when there is one. This sends text to a real person from the account: show the user the exact text and the item it answers, and get their yes before calling. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), text (required), workspaceId. Returns: result
resume_recurring_postResume Recurring PostADestructiveInspect
Resume a PAUSED recurring post. It continues from the next occurrence after now; slots missed while paused are not published. The next occurrence is created as a SCHEDULED post about 24 hours before it goes out and then publishes to the networks, so confirm with the user first. If the series has no slot left (endsOn passed or maxOccurrences reached) it comes back ENDED instead. When pauseReason is CONNECTION_REMOVED, ACCESS_LOST, SUBSCRIPTION_INACTIVE or INVALID_CONTENT, fix the cause first or the series pauses again. Ids outside the workspace (the current one unless workspaceId names another) return "Recurring post not found". Returns the recurring post with its new status and nextOccurrenceAt.
Inputs: id (required), workspaceId. Returns: result
resume_rss_feedResume RSS FeedADestructiveIdempotentInspect
Resume a paused RSS feed: the pause reason is cleared and the feed is checked within a minute, posting new items according to its post mode, so confirm with the user first. It then posts as the member resuming it, who needs the permission of its post mode. When pauseReason is ACCESS_LOST, SUBSCRIPTION_INACTIVE or CONNECTION_REMOVED, fix the cause first or the feed pauses again. Ids outside the workspace return 404. Needs the posts.draft permission.
Inputs: id (required), workspaceId. Returns: result
retry_failed_platformsRetry Failed PlatformsADestructiveInspect
Re-queue publishing for a post's FAILED platforms. platformIds takes platformId values from list_post_results, platform names such as "BLUESKY" (every failed row of that platform), or can be omitted to retry every failed row. Only rows with status FAILED are reset to PENDING and retried with the same content. A value matching neither a row id nor a platform of the post fails with "Unknown retry target"; with nothing failed among the matches the call fails with "No failed platforms to retry". The post moves to PUBLISHING and the retry is asynchronous, so check list_post_results for the outcome. Read each errorMessage first and retry once the cause is fixed (reconnected account, replaced media), not for a platform-side restriction, which will just fail again. Content cannot change on retry. Returns { postId, queuedPlatforms, isScheduled: false }.
Inputs: id (required), platformIds, workspaceId. Returns: result
revoke_connect_linkRevoke Connect LinkADestructiveIdempotentInspect
Revoke a connect link so it stops working at once. Accounts already connected through it stay connected; remove them with remove_account. Needs the accounts.manage permission, which Admin holds. Returns { success: true }.
Inputs: token (required), workspaceId. Returns: result
revoke_invitationRevoke InvitationADestructiveIdempotentInspect
Revoke a pending invitation that includes the workspace (the current one unless workspaceId names another), so its link stops working. Confirm with the user first, naming the email it was sent to. Only the owner may revoke an invitation for an organization admin. Needs the members.manage permission, which Admin holds. Fails with 404 when no such invitation includes this workspace, and with 400 when it is no longer pending. Returns the invitation with status revoked.
Inputs: id (required), workspaceId. Returns: result
search_instagram_audioSearch Instagram AudioARead-onlyIdempotentInspect
Search Instagram music and original sounds to add to a Reel. Returns { audio } with audioId, audioType, title, displayArtist (music), igUsername (original sounds), durationMs, coverArtworkUrl, profilePictureUrl, previewUrl (a temporary audio file, expires after about 1.5 days), instagramUrl and isAdsEligible. Leave out searchQuery to get what is trending. Only audio Meta has cleared for third-party publishing comes back, which can differ from what the Instagram app shows. Only works for Instagram accounts with supportsInstagramAudio: true in list_accounts; otherwise, or when Instagram rejects the search, it fails with 400. Pass the chosen audioId, with its title and artist, in instagramConfigs[].audio of create_post, update_post or bulk_schedule_posts. Nothing is posted.
Inputs: accountId (required), audioType (required), searchQuery, workspaceId. Returns: result
send_inbox_messageSend Direct MessageADestructiveInspect
Send a direct message in a conversation, from the account, where capabilities.canReply is true. Facebook and Instagram only allow a reply within 24 hours of the person's last message (replyWindowEndsAt); after that the call answers 400 inbox_messaging_window_closed, so stop and tell the user. This sends text to a real person from the account: show the user the exact text and the item it answers, and get their yes before calling. Each call sends a new message, so after an error or timeout read get_inbox_conversation before trying again. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), text (required), workspaceId. Returns: result
send_invitationSend InvitationAInspect
Invite someone by email to the organization and to one or more of its workspaces, each with a role. AdaptlyPost emails the invitation, which lasts 7 days; on accepting, the person joins with organizationRole and each listed workspace with its role. Confirm the email, workspaces and roles with the user first. Needs the members.manage permission, which Admin holds. A member who is not an organization owner or admin may only invite org-member, only to workspaces where they hold members.manage, and only with a role no higher than their own there; only the owner may invite an org-admin, and only an organization owner or admin may set creditAllowance. Otherwise it fails with 403 permission_denied. Fails with 403 subscription_required when the plan has no team seat left: tell the user to upgrade and do not retry. Fails with 400 when the person is already a member or already invited.
Inputs: email (required), workspaces (required), workspaceId, creditAllowance, +1 more. Returns: result
test_webhookTest WebhookAInspect
Send one signed webhook.test event to the endpoint now and report how it answered, to check the URL and the signature check work. Needs the webhooks.manage permission.
Inputs: id (required), workspaceId. Returns: result
trigger_analytics_syncTrigger Analytics SyncAIdempotentInspect
Ask AdaptlyPost to refresh analytics now instead of waiting for the scheduled sync: every connected account is queued and the last 7 days are re-read. Use it when the user just published and wants numbers, or when get_analytics_overview shows an old lastSyncedAt. Allowed once per workspace every 15 minutes, and a YouTube channel read in the last 12 hours is skipped; inside the cooldown, or when no connected account has analytics, it returns queued: false with cooldownSecondsRemaining rather than an error, so do not retry in a loop. The sync runs in the background: poll get_analytics_sync_status until syncInProgress is false, then read the metrics again. Takes only the optional workspaceId and changes no content.
Inputs: workspaceId. Returns: result
unhide_inbox_commentUnhide CommentAIdempotentInspect
Show a hidden comment on the platform again, where capabilities.canHide is true. A comment that cannot be unhidden answers 400 inbox_action_unsupported; stop there. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
unlike_inbox_commentUnlike CommentADestructiveIdempotentInspect
Take back the account's like on a comment, on Facebook, Bluesky, Mastodon and LinkedIn. A comment whose capabilities.canLike is false answers 400 inbox_action_unsupported; stop there. A 403 with code inbox_reconnect_required means the account lacks the platform permission for this channel or action (some channels still wait on platform review) or its token expired: tell the user to reconnect the account in AdaptlyPost and do not retry. 404 inbox_item_not_found means the id is unknown in this workspace. 429 inbox_rate_limited means the platform rate limited the call: wait a while before trying again. 503 inbox_platform_error means the platform failed: try again later. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: id (required), workspaceId. Returns: result
unschedule_postUnschedule PostADestructiveIdempotentInspect
Take a DRAFT or SCHEDULED post off the calendar without deleting it: the post becomes an undated DRAFT (status DRAFT, scheduledAt null) and nothing publishes. Use it when the user wants to hold a scheduled post back; schedule it again later with publish_draft and a scheduledAt, and use delete_post only to drop it entirely. Any other status (PENDING, PUBLISHING, COMPLETED, FAILED, PARTIAL_FAILURE) fails with 400 because the post is already going out or out. A post whose YouTube video already waits on YouTube (scheduleOnYouTube) fails with 409 SCHEDULED_ON_YOUTUBE; delete it instead. Ids outside the workspace (the current one unless workspaceId names another) return 404. Safe to repeat on a post that is already an undated draft. Returns the post record.
Inputs: id (required), workspaceId. Returns: result
update_inbox_comments_statusMark Inbox CommentsAIdempotentInspect
Mark a batch of comments as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to the platform. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: ids (required), status (required), workspaceId. Returns: result
update_inbox_conversations_statusMark Inbox ConversationsAIdempotentInspect
Mark a batch of conversations as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to the platform. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: ids (required), status (required), workspaceId. Returns: result
update_inbox_mentions_statusMark Inbox MentionsAIdempotentInspect
Mark a batch of mentions as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to the platform. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: ids (required), status (required), workspaceId. Returns: result
update_inbox_reviews_statusMark Inbox ReviewsAIdempotentInspect
Mark a batch of reviews as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to Google. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.
Inputs: ids (required), status (required), workspaceId. Returns: result
update_postUpdate PostADestructiveIdempotentInspect
Update a DRAFT, SCHEDULED or FAILED post in place. A post that failed on every platform becomes a DRAFT again with its platforms back to pending; publish or schedule it afterwards with publish_draft. Any other status, including a post that published on some platforms and failed on others, fails with "Cannot edit post in current state", so published posts cannot be changed. Updates are partial: text, contentType, scheduledAt, timezone, thumbnail fields, firstComments, platformThumbnails and platformMedia you omit keep their values; sending firstComments, platformThumbnails or platformMedia replaces every stored entry, and platformMedia [] clears every media override. The exception is platforms: sending it rebuilds the post's target set from this request alone, so include every connection-id array and platform config you want to keep (TikTok with privacyLevel, Pinterest with its boardId or boardName); omitting platforms leaves accounts, configs, and media untouched. mediaUrls only take effect together with platforms, while platformMedia takes effect without it; use publicUrl values from upload_media. On SCHEDULED posts new media is verified in storage. A post with a YouTube video already waiting on YouTube (youtubeScheduledVideoId set and not yet published) fails with 409 SCHEDULED_ON_YOUTUBE; delete it and schedule it again to change it. Returns the updated post record. Use publish_draft to change a draft's status, unschedule_post to take a scheduled post off the calendar, delete_post to cancel, and create_post for a new post.
Inputs: id (required), text, pageIds, timezone, +38 more. Returns: result
update_rss_feedUpdate RSS FeedADestructiveIdempotentInspect
Change an RSS feed's settings; only the fields sent change, and the URL cannot change. The feed then posts as the member making the change, so they need the permission of the resulting post mode, plus posts.others when someone else set the feed up. Switching postMode to SCHEDULE or PUBLISH means later items go out without further confirmation, so confirm with the user first. Ids outside the workspace return 404. Needs the posts.draft permission.
Inputs: id (required), name, targets, postMode, +11 more. Returns: result
update_webhookUpdate WebhookADestructiveIdempotentInspect
Change a webhook endpoint's URL or the events it receives, or turn it off or back on with active. Sending events replaces the list, and [] goes back to the default set. Turning on an endpoint that was turned off after failed deliveries starts sending again. Events that happen while an endpoint is off, or that a new events list leaves out, are never delivered later, and after a URL change the old URL receives nothing more, so confirm the change with the user first. Fails with 409 when the new URL is already registered. Needs the webhooks.manage permission.
Inputs: id (required), url, active, events, +1 more. Returns: result
upload_mediaUpload MediaADestructiveInspect
Upload images, videos or documents to AdaptlyPost storage and return public URLs for the mediaUrls of create_post, update_post, or bulk_schedule_posts. Three sources, combinable in one call: attachments (files the user attached in a ChatGPT conversation, which ChatGPT passes as file references; use this for every file attached in ChatGPT, whatever its size), urls (public https URLs the server streams straight into storage; private, internal and non-https addresses are refused) and files (base64 data, for small media attached in other apps; 30 MB decoded per call in total). Omitting all three returns an error. Accepts JPEG, PNG, WebP, GIF, MP4 and QuickTime, plus PDF, PPT, PPTX, DOC and DOCX for LinkedIn DOCUMENT posts, checked by file content (and, for Office files, the extension, so keep it in the name or URL); 50 MB per image, 100 MB per document, 250 MB per attachment or URL download. Stored files are public immediately, post or no post, so only upload media the user supplied or asked for. For base64 files over 30 MB use get_upload_urls and PUT the bytes yourself. Returns uploaded ({ publicUrl, key } per file) and mediaUrls; pass mediaUrls straight into the post. One publicUrl may be reused across any number of posts; the file is kept until the last post referencing it has published, so upload once and reuse rather than re-uploading per post.
Inputs: urls, files, attachments, workspaceId. Returns: result
validate_bulk_postsValidate Bulk PostsARead-onlyIdempotentInspect
Dry-run bulk_schedule_posts: takes exactly the same input and returns one validation report per item, in input order, without creating, uploading or writing anything. Nothing is published, so no confirmation is needed. Each report has valid, outcome, requiredPermissions, issues, accounts and notChecked, as in validate_post. Fix the items with ERROR issues, then call bulk_schedule_posts. Needs the posts.draft permission.
Inputs: posts (required), platforms (required), pageIds, timezone, +22 more. Returns: result
validate_postValidate PostARead-onlyIdempotentInspect
Dry-run create_post: takes exactly the same input and runs every check creating the post would run, plus the ones that usually fail only at publish time (TikTok creator limits, YouTube upload quota, expired tokens, Pinterest boards, X credits), without creating a post, uploading media or writing anything. Nothing is published, so no confirmation is needed. Always returns a report: valid is false when any issue has severity ERROR. Issues tied to one account are listed under that account in accounts (status READY, WARNING or BLOCKED); the rest are in issues, each with a stable code, severity and message. outcome says what creating the post would do (DRAFT, SCHEDULED or PUBLISH_NOW), and requiredPermissions names the permissions it would need; a missing one shows up as a PERMISSION_DENIED issue. notChecked lists what only the platform decides at publish time, so valid: true is not a guarantee. Fix every ERROR, then call create_post with the same input. Needs the posts.draft permission.
Inputs: contentType (required), text, pageIds, timezone, +40 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Publish, schedule and analyze posts on Instagram, Facebook, TikTok, Threads, LinkedIn and YouTube.
Publish and analyze posts on Instagram, Facebook, TikTok, YouTube, X, and Bluesky.
Post, schedule, reply and measure across X, LinkedIn, Instagram, TikTok, YouTube, Threads, Bluesky
Schedule posts to Instagram, TikTok, LinkedIn, X and 6 more. Track analytics and reply to comments.
Related MCP Servers
AlicenseBqualityBmaintenanceSchedule, publish, and measure social posts on Facebook, Instagram, TikTok, LinkedIn, Threads, Pinterest, and X for one brand or many.38MIT- AlicenseAqualityDmaintenanceAI-powered social media posting across 14 platforms. Post to Twitter, Instagram, TikTok, Facebook, LinkedIn, YouTube and more with one command. AI adapts content per platform, schedules posts, and generates 30-day content calendars.6MIT
- AlicenseAqualityBmaintenanceSchedule, manage, generate, and analyze social posts across 11 networks (Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Pinterest, Threads, Bluesky, Mastodon, Telegram) from any AI agent — 13 tools covering scheduling, media upload, AI caption generation, best-times, analytics, listening, and comments.23MIT

Blotato MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to create, schedule, and publish social posts across platforms like Facebook, Instagram, TikTok, YouTube, X, LinkedIn, Threads, Pinterest, Bluesky, Slack, and Discord. Also supports reviewing post analytics, managing the content calendar, replying to Instagram and Facebook comments and DMs, and running comment-to-DM automations.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.