posterly
Server Details
Validate, schedule, publish, and analyze social content across 18 platforms with posterly. Supports OAuth 2.1 and Bearer API-key authentication. Requires a paid posterly plan with API access; Starter + API is available from $10/month.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 72 tools
The set covers many distinct families (posts, accounts, media, analytics, inbox, billing, Google Business), and descriptions carefully explain boundaries. Still, several clusters overlap enough to risk misselection: manage_plan vs upgrade/downgrade_subscription, create_connect_session vs connect_account vs list_platforms view=connect_link, and upload_media vs create_signed_upload vs create_media_drop. Feedback/support tools are also adjacent enough to require careful reading.
Most names follow a predictable verb_noun convention: create_post, list_posts, get_post, update_post, delete_post, manage_brand, list_google_business_reviews. The manage_* action-based tools are consistent with each other. Minor deviations such as whoami and posterly_status keep this from being perfect.
72 tools is far beyond a reasonable surface for an agent to navigate confidently, even for a broad social publishing platform. The set spans posts, media, analytics, inbox, Google Business, billing, team management, webhooks, and AI generation, but could be split into smaller scoped servers or consolidated. This is an extreme count mismatch rather than a well-scoped toolset.
The surface covers the domain comprehensively: create/update/delete posts, batch creation, validation, scheduling slots, media upload flows, accounts, analytics, comments, DMs, Google Business profiles/reviews/media, billing, team management, API keys, OAuth clients, webhooks, and support/feedback. I do not see an obvious missing lifecycle operation that would block an agent.
Available Tools
72 toolsask_supportAInspect
Ask posterly Support AI an authenticated question using posterly docs plus read-only account/post diagnostics for the caller workspace. Requires API auth and accounts:read + posts:read scopes. Human tickets are never opened on the first answer; ticket creation requires a follow-up in a continued conversation with an assistant answer plus request_human=true and confirm_escalation=true after explicit user confirmation.
Inputs: question (required), post_id, page_url, workspace_id, +4 more.
audit_google_business_profileARead-onlyIdempotentInspect
Run a live local-profile audit for a connected Google Business Profile location. Returns the 0-100 completeness score, letter grade, a score for each section (profile basics, hours, categories, description, photos, attributes, review health, and service areas when the listing travels to customers), and recommendations. A service listing with no areas, or an area more than 80 miles from the business in a straight line, cannot keep a top score.
Inputs: account_id, location_id, workspace_id.
cancel_subscriptionADestructiveIdempotentInspect
Cancel the authenticated user's posterly subscription. DESTRUCTIVE; requires billing:write. ALWAYS ask the user why they are cancelling FIRST and pass their answer as reason (one of the allowed values). By default an active or trialing plan is set to cancel at the end of the current period. A past_due or unpaid plan always ends now, even when immediate is false: the unpaid renewal is dropped and payment retries stop. Pass immediate=true only when the user explicitly wants an active plan cancelled right now. Only call after the user explicitly confirms.
Inputs: reason (required), confirm (required), feedback, immediate.
complete_onboardingAIdempotentInspect
Save onboarding About you from the chat (display name, IANA timezone) and mark onboarding complete. Only when whoami says onboarding.completed is false; never re-ask once true. Then offer create_connect_session.
Inputs: name, complete, timezone.
connect_accountAIdempotentInspect
Connect a credential-based social account (telegram, bluesky, discord, wordpress, devto, hashnode, lemmy) directly, without a browser session. Call list_platforms with view=connect_link first to discover the exact credential fields the platform needs. Prefer scoped secrets: app passwords (Bluesky, WordPress), bot tokens (Telegram), webhook URLs (Discord), and API tokens (Dev.to, Hashnode) over primary passwords. Warn the user that any credential they share passes through this conversation. For OAuth platforms (Instagram, X, LinkedIn, ...) use create_connect_session instead.
Inputs: platform (required), pat, handle, api_key, +10 more.
create_api_keyAInspect
Create a new posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys. Team management (members:read, members:write) and client portal sign-in link permissions are never copied or granted here: a person turns them on in /dashboard/api. Optional workspace_client_id limits the new key to one brand in the workspace. Omit it for a workspace-wide key. A key that is already limited to one brand cannot create keys.
Inputs: confirm (required), name, scopes, workspace_id, +2 more.
create_connect_sessionAInspect
Create a short-lived dashboard handoff session for connecting a social account. Open connect_session.connect_url for the user, then poll list_accounts with view=connect_session so you can narrate progress.
Inputs: platform (required), auto_start, workspace_id.
create_media_dropAInspect
Create a human drop page so ChatGPT or Claude users can upload laptop files (up to 20 per link) without dashboard login. Returns drop_url (https://www.poster.ly/drop/). Send that URL to the user, wait, then call list_media. Accepts JPEG, PNG, GIF, WebP, MP4, MOV, WebM, and PDF up to 50MB (a PDF is for LinkedIn document posts); HEIC is not accepted. This is not the chat paperclip and not create_signed_upload.
Inputs: filename, max_files, workspace_id.
create_postAInspect
Schedule or immediately publish one social media post. DESTRUCTIVE WRITE that creates content on the user's connected social account. An immediate post (no scheduled_at, or a time within a minute) comes back with status publishing. A future time comes back as scheduled. If it is saved but cannot be queued, the call errors and says whether it will still be sent when it is due. Always confirm caption + scheduled_at + account_id/workspace with the user before calling. For Instagram, distinguish caption @mentions from native instagram_settings.user_tags and co-author instagram_settings.collaborators; call list_platforms with view=schema and account_id before either native feature. Native media tags work with eligible direct or Meta-linked accounts; collaborators require an eligible Meta-linked account. Instagram caption add-ons (caption_addon poll or comment prompt) need a Facebook Login account, a caption, and a feed photo, Reel, or carousel. Stories are rejected, and a poll cannot be combined with a comment prompt. Third-party media URLs are copied into posterly storage before the post is saved; short-lived signed URLs must still be live when this tool runs. For multiple posts, prefer create_posts_batch after confirming every item. On an error or lost reply, retry with the same idempotency_key; a repeat within 10 minutes returns the original post (deduplicated: true). TikTok: with no privacy_level it posts directly using the saved default or public (tiktok_audience_defaulted); post_mode inbox sends it to the app.
Inputs: confirm (required), caption, metadata, platform, +12 more.
create_posts_batchAInspect
Create 1-25 scheduled or immediate social posts in one API request. DESTRUCTIVE WRITE: show the user every post's account/platform, caption or thread text, scheduled time, media, settings, and workspace, then get explicit confirmation for the whole batch before calling. Third-party media URLs are copied into posterly storage before each post is saved. Partial success is possible; failed items return their array index. On an error or lost reply, retry with the same keys; a repeat within 10 minutes returns the original posts (deduplicated: true). TikTok items without privacy_level post directly using the saved default or public (tiktok_audience_defaulted); post_mode inbox sends to the app.
Inputs: posts (required), confirm (required), idempotency_key.
create_signed_uploadAInspect
Create signed upload URLs for larger images, videos or PDFs, 1 to 20 files per call. Accepts JPEG, PNG, GIF, WebP, MP4, MOV, WebM, and PDF up to 50MB (a PDF is for LinkedIn document posts); HEIC is not accepted. For one file pass filename, content_type and size. For several pass files: [{filename, content_type, size}] and get one slot per file, with any file that fails reported in place. PUT the raw bytes of each file to its upload_url (object storage) with the returned headers, then pass public_url to create_post / create_posts_batch. For a PDF, create the post with post_type document, media_url set to that public_url and a document_title in settings (LinkedIn only). pin_content_type: true locks each slot to the declared content_type. Always send the Content-Type header returned with the slot. Slots expire in 15 minutes.
Inputs: size, files, filename, content_type, +2 more.
create_webhookAInspect
Create a webhook subscription for post/account/analytics events. WRITE WITH OUTBOUND SIDE EFFECTS: show the user the target URL, workspace, events, and active state, then get explicit confirmation before calling. The response includes the signing secret once.
Inputs: url (required), confirm (required), events, is_active, +2 more.
delete_api_keyADestructiveIdempotentInspect
Revoke a posterly API key owned by the authenticated user. DESTRUCTIVE: show the user the exact key ID/prefix/name if available and get explicit confirmation before calling. Cannot revoke the key currently authenticating this request, OAuth-issued keys, or managed assistant keys.
Inputs: key_id (required), confirm (required).
delete_postADestructiveIdempotentInspect
Delete posts. DESTRUCTIVE and IRREVERSIBLE. post_id: delete one post; fetch it with get_post first, confirm what will be deleted, then pass confirm=true. A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal: delete_mode=platform with confirm_published=true takes the live post down too; delete_mode=posterly removes only the posterly record and leaves it up. Live deletion supports eligible connected platforms with saved post IDs and deletion permissions; refusals keep the record. Threads requires threads_delete. YouTube requires youtube.force-ssl or equivalent, upload alone is insufficient. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id.
Inputs: confirm, post_id, group_id, preview_id, +2 more.
disconnect_accountADestructiveIdempotentInspect
Disconnect a connected social account from posterly. DESTRUCTIVE and IRREVERSIBLE: this removes the account connection, emits account.disconnected webhooks, and may transfer Instagram scheduled posts to a replacement account. Always call list_accounts first, show the user the exact account/platform/workspace, and get explicit confirmation before calling.
Inputs: confirm (required), account_id (required).
dismiss_suggestionADestructiveIdempotentInspect
Dismiss a proactive post suggestion so it stops appearing, or pass save_as_draft true to turn it into an unpublished draft instead. A draft is not scheduled and nothing is published. WRITE: confirm the exact suggestion with the user first. Never dismisses, and does not overwrite, a suggestion that was already turned into a post.
Inputs: suggestion_id (required), save_as_draft.
downgrade_subscriptionADestructiveIdempotentInspect
Move the subscription down one tier (or to an explicit lower tier) now: the lower limits and credits apply right away, the lower price starts at the next renewal, and the rest of the current period is not refunded. Strictly downward only. Requires billing:write. Only call after the user explicitly confirms.
Inputs: confirm (required), tier.
find_available_slotARead-onlyIdempotentInspect
Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours. Without timezone it uses the saved user timezone (in a shared workspace, the timezone of that workspace first), then UTC; the result names the timezone used and where it came from, and says so when it fell back to UTC. Each slot includes the UTC instant to pass as scheduled_at. strategy "best_engagement" (needs account_ids) ranks the next 7 days by when these accounts get the most engagement, with a 1-5 star rating and a reason per slot.
Inputs: count, strategy, timezone, account_ids, +1 more.
generate_captionsAInspect
Generate or adapt AI caption suggestions for one or more social platforms. Uses AI Caption Assist quota and returns options only; it does not create, draft, schedule, or publish posts.
Inputs: platforms (required), mode, tone, brief, +11 more.
generate_imageAInspect
Queue an AI image job via posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll list_jobs with type=image for urls. COSTS CREDITS - confirm subject + style + aspect_ratio + quality + provider with the user before calling.
Inputs: prompt (required), confirm (required), model, style, +8 more.
generate_videoAInspect
Queue an AI video job with Google Veo 3.1 or xAI Grok Imagine Video 1.5. COSTS CREDITS - confirm provider, prompt, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Poll list_jobs with type=video for status and final video_url.
Inputs: prompt (required), confirm (required), model, provider, +10 more.
get_creditsARead-onlyIdempotentInspect
Get the posterly AI credit balance: available to spend now, monthly included allowance left, purchased pack balance, plan tier, and the next reset. Credits are a shared WORKSPACE wallet, so this is the balance the caller can actually spend. Read-only. Requires the billing:read scope.
Inputs: no named parameters.
get_postARead-onlyIdempotentInspect
One post by ID. view=post (default): caption, status, platform, account, scheduled time, when it was created and by whom (account and channel, such as dashboard, API, or MCP), media, a link back to the post in posterly, and the failure reason when a publish failed. view=missing: each missing field (content, media, account, platform settings, or metadata) and how to fix it before the post can publish.
Inputs: post_id (required), view.
get_subscriptionARead-onlyIdempotentInspect
Get the posterly subscription: status, tier, cancel-at-period-end, period end, trial end, pause state, connected accounts in use and the account limit for this workspace (tier plus extra slots). Call FIRST for "upgrade", "change plan", "add accounts" or "how many accounts": it returns the plans above this one with prices, limits and credits, the Agency extra-accounts state (owners) and next steps. On a trial, limits stay until the paid plan starts: see manage_plan. Read-only. Requires the billing:read scope.
Inputs: no named parameters.
get_updatesARead-onlyIdempotentInspect
Get the latest posterly product updates and news from the updates feed: new features, improvements, and fixes, newest first. The output says whether more updates exist; page with offset or narrow with since. Requires an active posterly subscription.
Inputs: limit, since, offset, include_content.
get_video_optionsARead-onlyIdempotentInspect
List read-only Google Veo and xAI Grok video generation options, input modes, durations, resolutions, aspect ratios, and credit-cost estimates. Does not generate video or spend credits.
Inputs: no named parameters.
get_x_posting_quotaARead-onlyIdempotentInspect
Get managed X posting quota, usage, remaining posts, URL-blocking status, and add-on plan info for a workspace.
Inputs: workspace_id.
list_accountsARead-onlyIdempotentInspect
Connected social accounts and what posterly has learned about them. view=accounts (default): connected accounts, optionally one workspace_id or one account_id. Each row has connection_status ok or needs_reconnect (reason and date, never a token). Pass connection=needs_reconnect to list only accounts that need a reconnect. Instagram rows show direct-login vs Meta-linked and whether native media tags/collaborators are available, so check this before Instagram user_tags or collaborators. view=learned_voice (account_id): the voice learned from the account's real published captions (summary, traits, style guidelines, habits); read-only, never overwrites the brand profile. view=performance_profile (account_id): 90-day coaching stats, engagement-rate trend, and summary, or null with a reason (Pro plan or higher). view=connect_session (session_id): poll a session from create_connect_session and narrate status_message; stop at connected, failed, cancelled, or expired.
Inputs: view, account_id, connection, session_id, +1 more.
list_activityARead-onlyIdempotentInspect
List recent activity and publish events for posts, including status changes, publish attempts, failures, and retries, newest first. Use this as the agent notifications feed. The output says whether more events exist; page with offset (offset + limit up to 1000) or narrow with since or post_id before concluding nothing else happened.
Inputs: type, limit, since, offset, +2 more.
list_analyticsARead-onlyIdempotentInspect
Analytics for connected accounts (Instagram, X, Facebook Pages, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile adds Calls, Website clicks, and Directions to its profile, search, and maps views. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, and plays, most recent first, with limit/offset. Google Business has no per-post rows; its totals are on view=accounts. view=insights: per-post feedback insights with a performance tier, diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for chart renderers. include_extras reads saved extras only and never starts a sync.
Inputs: view (required), to, from, limit, +6 more.
list_brandsARead-onlyIdempotentInspect
Brands (clients) and their saved context. view=brands (default): brands the caller can access with brand ID, name, workspace ID, source, and account count (optional workspace_id). view=brand (brand_id): one brand with its workspace, source, and linked legacy brand group. view=accounts (brand_id): the social accounts assigned to the brand; use when the user names a brand, not a handle. view=profile (brand_id): voice and tone, audience, keywords, dos and don’ts, and other saved brand context, plus Visual identity (hex colours, fonts, logo URLs).
Inputs: view, brand_id, workspace_id.
list_commentsARead-onlyIdempotentInspect
Social inbox comments and replies for Instagram, Facebook Pages, Threads, and LinkedIn Pages (Pro plan or higher plus posts:read). Without comment_id: list comments filtered by account, platform, unread/flagged, search, or since/until dates, with limit/offset paging. With comment_id: one comment and its replies; only workspace_id may be added. YouTube and TikTok are refused rather than returned as an empty list. They stay off until each platform is reviewed and an inbox provider exists.
Inputs: limit, since, until, filter, +6 more.
list_conversationsARead-onlyIdempotentInspect
Social inbox DM conversations for Instagram and Facebook Page inboxes (Threads has no DMs; Pro plan or higher plus posts:read). Without conversation_id: list conversations filtered by account, platform, unread/starred/archived, search, or since/until dates, with limit/offset paging. With conversation_id: one conversation and its messages; there limit is the number of messages (default 50, max 100) and only workspace_id may be added. When a sync has stored it, each conversation includes the Meta reply window (open until a UTC time, or closed). A reply does not extend that window, and it is not guessed from the messages loaded in the thread.
Inputs: limit, since, until, filter, +6 more.
list_google_business_locationsARead-onlyIdempotentInspect
Read a Google Business location profile or look up Google Business categories. view=profile (default): read title, description, primary and additional categories, services, phone numbers, website URL, regular opening hours, attributes, and pending-review status for one location (pass account_id or location_id). view=categories: search Google Business categories via categories.list (region_code and language_code required, optional prefix filter, category_view BASIC or FULL, page_size up to 100, page_token). Stays off until location edits are switched on, and does not call Google while it is off.
Inputs: view, prefix, page_size, account_id, +7 more.
list_google_business_mediaARead-onlyIdempotentInspect
List the photos and videos on a Google Business Profile gallery (the media shown on Maps and Search) for one location/account or every accessible GBP location. This is separate from media attached to a post. Returns each item's resource name, category, format, image URL, and date. Pages the gallery already fetched from Google: limit defaults to 50 (max 200) and offset skips that many items.
Inputs: limit, offset, account_id, location_id, +1 more.
list_google_business_reviewsARead-onlyIdempotentInspect
Google Business Profile reviews. view=reviews (default): reviews for one location/account or every accessible location, paging through everything Google has (not just the first 50) with the full untruncated review text, its date, and each location's total review count; filter by rating or unanswered, page with limit/offset. Each review has review_name for manage_google_business_review reply/delete_reply. view=review_link (account_id or location_id): the direct public Google review link plus the Google Place ID (ChIJ...); that Place ID is output only and must NOT be passed back as location_id.
Inputs: view, limit, offset, rating, +4 more.
list_google_business_service_areasARead-onlyIdempotentInspect
Read Google Business service areas (the towns and postcodes a location covers, up to 20). view=areas (default): the current business type, country, and place list for one location. view=places (q required): search for a town or postcode to add. Place IDs from view=places are regions, not the review-link Place ID. Town search needs a maps key on the server; if it is missing, add a place with its Place ID and name on the update instead.
Inputs: q, view, account_id, location_id, +2 more.
list_jobsARead-onlyIdempotentInspect
AI generation jobs. type=image: one image job by job_id, or recent image jobs when job_id is omitted (filter by status, limit); poll it after generate_image for the finished urls. type=video: one video job by job_id, or recent video jobs (status includes dismissed, limit); poll it after generate_video for the finished video_url.
Inputs: type (required), limit, job_id, status.
list_mediaARead-onlyIdempotentInspect
List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files uploaded on /drop/. Each file includes its filename and the time it was added. Use public_url with validate_post / create_post. A drop listing returns up to 20 files per page by default so a full drop fits one page. The output says whether every matching file is shown; page with offset (offset + limit up to 1000) when it is not.
Inputs: limit, offset, drop_session_id.
list_oauth_clientsARead-onlyIdempotentInspect
List self-serve OAuth developer clients owned by the user. These are public PKCE clients for third-party app integrations.
Inputs: no named parameters.
list_platformsARead-onlyIdempotentInspect
Platforms, settings schemas, and connection links. view=platforms (default): every posterly integration with posting capabilities, content and media limits, settings schemas, helper tools, and analytics support. view=schema: the settings schema for one connected account_id (preferred: returns account context and connection-specific capabilities, needed before Instagram native tags/collaborators) or one platform; account_id wins if both are given. view=connect_link: dashboard connection links and readiness for every target, or one target (instagram, meta, linkedin_page, twitter, telegram, reddit, wordpress, ...); credential platforms show the credential_fields that connect_account needs. In a chat, prefer create_connect_session (opens the network sign-in, pollable).
Inputs: view, target, platform, account_id, +2 more.
list_postsARead-onlyIdempotentInspect
Posts in your workspaces, teammates' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to. view=list (default): posts filtered by status, platform, account_id, workspace_id, brand_id, group_id, release_id, approval_status, approval_waiting_on, and a scheduled date range: scheduled_from (inclusive) and scheduled_to (a plain date includes that whole day), read in timezone (IANA, default UTC; also the zone times are shown in). Returns limit posts (default 20, max 200) starting at offset; with a date range the order defaults to oldest first (order=asc|desc). The output always says whether every matching post was shown. If it says more are available, call again with the offset it gives and keep paging until all are shown before drawing any conclusion about totals, gaps, or how busy a client is. view=counts (scheduled_from and scheduled_to required, up to 366 days): exact totals per day, status, account, and brand for the same filters (limit, offset, and order are ignored); use it for "how many" or "is this month full" questions. Each post includes approval.pending_client_approval.
Inputs: view, limit, order, offset, +12 more.
list_post_suggestionsARead-onlyIdempotentInspect
List proactive post suggestions: evidence-based weekly drafts posterly writes in each account's learned voice, each with a rationale tying it back to what has performed well. The caption, rationale, and account id are returned in full. Filter by account_id and status (pending, scheduled, dismissed; default pending). The output says whether every matching suggestion is shown; page with offset until it does. Read-only; requires a Pro plan or higher. Use dismiss_suggestion to hide one, or pass save_as_draft true on that tool to keep it as an unpublished draft.
Inputs: limit, offset, status, account_id.
list_publishing_pausesARead-onlyIdempotentInspect
Is publishing paused? Shows whether the workspace is paused, which brands are paused (only brands you can see), and whether you may pause, resume, or publish missed posts. Read-only. Change it with manage_publishing_pause.
Inputs: workspace_id.
list_webhooksARead-onlyIdempotentInspect
List API webhook subscriptions, their event filters, active state, and most recent delivery status. view=deliveries (webhook_id) reads recent delivery attempts for one webhook. That history stays off until it is switched on, and it does not include the signing secret or the request body.
Inputs: view, limit, offset, webhook_id, +1 more.
list_workspace_membersARead-onlyIdempotentInspect
List the people in a workspace: members (with role, status, brand access and API access) and pending invites, plus seats in use. API access says whether a teammate can use this workspace's API plan from their own keys and AI apps; owners and admins also see each member's key count, connected AI apps and last use. Works with an API key that has the Manage team permission (any workspace member can list; brand-limited teammates only see brand ids they can access), or from ChatGPT, Claude and other OAuth connections when the user is an owner or admin of the workspace.
Inputs: workspace_id (required).
manage_brandADestructiveInspect
Create, update, or archive a brand. action=create (admin only): name, and the workspace_id from whoami when the key is not already scoped to one workspace. Optional timezone and website_url. Pass confirm=true only after the user agrees. action=update (admin only): brand_id plus name, timezone, or website_url. Pass confirm=true only after the user agrees. action=archive (admin only): preview then confirm. Call without confirm to see the brand and what archiving does, show that to the user, then call again with confirm=true and the preview_id. Archiving removes the brand from the active list. Connected accounts stay connected, and its scheduled posts are not cancelled: they still publish. The preview counts both.
Inputs: action (required), name, confirm, brand_id, +4 more.
manage_commentADestructiveInspect
Act on an inbox comment (Pro plan or higher plus posts:write). action=reply (comment_id, content): reply to an Instagram, Facebook Page, Threads, or LinkedIn Page comment; type private is Instagram only, the others are public replies only. action=update (comment_id, is_hidden and/or is_read): hide or unhide it on the platform, or mark it read or unread; reversible, no confirm needed. action=delete (comment_id): delete an Instagram or Facebook Page comment, irreversible and admin only; Threads replies cannot be deleted, hide them instead. reply and delete use preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id.
Inputs: action (required), comment_id (required), type, confirm, +5 more.
manage_conversationAInspect
Act on the social inbox (Pro plan or higher plus posts:write). action=send (conversation_id, content): send a DM reply in an Instagram or Facebook Page conversation, honoring the 24-hour messaging window (Threads has no DMs); preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. action=sync (account_id): pull the latest Instagram, Facebook Page, Threads, or LinkedIn inbox data for one account; 30-second cooldown (60 for LinkedIn); Threads and LinkedIn sync comments only.
Inputs: action (required), confirm, content, sync_type, +4 more.
manage_extra_accountADestructiveIdempotentInspect
Buy, raise, lower, or remove Agency extra-account slots. MONEY: raising charges the saved card exactly the quoted amount. Owner only; billing:write. action=set (extra_accounts = desired TOTAL, 0 removes all; add 20+ at a time). Call without confirm for the quote and preview_id; after the user agrees, call with confirm=true, that preview_id, the expected_ fields and proration_date from the quote. A changed price is refused. 3D Secure or a decline returns a payment link; nothing is added.
Inputs: action (required), extra_accounts (required), confirm, preview_id, +5 more.
manage_google_business_locationADestructiveIdempotentInspect
Update a Google Business location profile, hours, or attributes (one field group per call). Actions: update_hours (regular_hours.periods), update_attributes (attributes), update_description (description, max 750 chars, no URLs or phone numbers), update_categories (categories with primary_category and up to 9 additional_categories; carries over existing additional categories when omitted), update_services (service_items, replaces the full list or clears services when empty; free-form categories must belong to the location), update_title (title), update_phones (phone_numbers with primary_phone and up to 2 additional_phones; carries over existing additional phones when omitted), update_website (website_uri). Every action uses preview then confirm with a one-time token: call without confirm to get a preview and preview_id, show it to the user, then call again with confirm=true and that preview_id. Title and primary category edits warn that Google may hold the change for review and that an inaccurate name or category can get the listing suspended. Stays off until location edits are switched on; a confirm while it is off changes nothing and does not call Google.
Inputs: action (required), title, confirm, account_id, +10 more.
manage_google_business_mediaADestructiveInspect
Change a Google Business Profile gallery (the photos and videos shown on Maps and Search). action=add (source_url, category): add a photo or video from a public https URL (upload it with upload_media first); COVER and PROFILE are single-slot and replace the existing one. action=delete (media_name from list_google_business_media): permanently remove an item from the public profile. Both use preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id.
Inputs: action (required), confirm, category, account_id, +6 more.
manage_google_business_reviewADestructiveInspect
Act on Google Business Profile reviews. action=suggest_reply (star_rating, optional review_text): short, brand-aware AI reply suggestions; uses the AI Caption Assist allowance and never posts. action=reply (review_name, comment): post or update the owner reply. action=delete_reply (review_name): delete the owner reply. reply and delete_reply use preview then confirm: call without confirm to get a preview and preview_id (it repeats the review name, location, and exact reply text; show the reviewer, rating, and review text alongside it), then call again with confirm=true and that preview_id.
Inputs: action (required), tone, count, comment, +10 more.
manage_google_business_service_areaAIdempotentInspect
Replace the service areas on a Google Business location. action=update sends the full list (1 to 20 places, each with place_id and place_name from list_google_business_service_areas view=places or a known region Place ID). business_type is CUSTOMER_AND_BUSINESS_LOCATION (customers can visit, and you also travel) or CUSTOMER_LOCATION_ONLY (you only travel to customers). CUSTOMER_LOCATION_ONLY needs region_code when Google has not set one, and clear_storefront_address=true when a street address is still on the listing. The country cannot be changed once set. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Saving the same list again is safe.
Inputs: action (required), places, confirm, account_id, +6 more.
manage_oauth_clientADestructiveInspect
Manage self-serve OAuth 2.1 + PKCE developer clients (public clients with no client secret; list them with list_oauth_clients). action=create: client_name, allowed_redirect_uris, and default_scopes; confirm=true only after the user confirms the name, redirect URIs, and scopes. action=update: client_id plus the changed fields; confirm=true after the user confirms the changes. action=delete: client_id; prevents new authorizations (existing access tokens stay revocable as API keys); preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id.
Inputs: action (required), confirm, homepage, client_id, +6 more.
manage_planAInspect
Plans and the paid-plan link. action=list: plans, prices and the charge today to start the paid plan. action=confirm_link: a single-use 30-minute link for the human to confirm the price; omit tier and interval to start the current plan. This tool never charges the card (upgrade_subscription and manage_extra_account charge it only after the user agrees to their quote). A trial link needs billing:read. Changing a paid plan also needs billing:write.
Inputs: action (required), tier, interval.
manage_publishing_pauseADestructiveInspect
Pause or resume publishing for a whole workspace or one brand (check it first with list_publishing_pauses). Only act when the user asks; never pause on your own initiative. action=pause (optional brand_id; leave it out for the whole workspace): holds every scheduled post in that scope and blocks Post now until an admin resumes. Call it first without confirm to get a preview (scope and how many scheduled posts it holds), show it to the user, and only after they agree call again with confirm=true. Publisher or higher; a seat limited to some brands can only pause those brands. action=resume (optional brand_id; admin or higher): future posts are scheduled again; posts whose time passed while paused stay paused and are listed as missed. Missed posts never publish on their own. action=publish_missed (post_ids from the resume, confirm=true after the user agrees; admin or higher): publishes those missed posts now.
Inputs: action (required), confirm, brand_id, post_ids, +1 more.
manage_webhookADestructiveInspect
Change a webhook subscription (list them first with list_webhooks). action=update (webhook_id): change URL, events, workspace, description, or active state; outbound side effects, so pass confirm=true only after explicit confirmation. action=delete (webhook_id): remove the subscription; preview then confirm: call without confirm to get a preview and preview_id, show the URL, events, and workspace, then call again with confirm=true and that preview_id. action=test (webhook_id): send a signed webhook.test delivery; confirm=true after explicit confirmation.
Inputs: action (required), webhook_id (required), url, events, +5 more.
manage_workspace_memberADestructiveInspect
Invite, update, or remove a workspace colleague. This SENDS EMAILS and CHANGES WHO CAN ACCESS the workspace. Works with an API key that has the Manage team permission or an OAuth connection; the user must be a workspace owner or admin. ALWAYS preview first: call without confirm, show it, and call again with confirm: true and the preview_id only after the user explicitly approves. action=invite: email and role required (publisher, editor or viewer), optional brand_ids and resend; always sends a pending invite email, never adds anyone instantly. action=update: member_id or invite_id (from list_workspace_members) plus role and/or brand_ids; or member_id plus api_access (true or false, on its own) to turn API and AI app access on or off for that teammate, which lets them use the workspace API plan from their own keys and AI apps (off by default; you cannot change your own; only the owner can change it for an admin; turning it off stops their keys, AI app connections and webhooks for this workspace). action=remove: member_id (removes the teammate and revokes their API keys for this workspace) or invite_id (cancels a pending invite). Admin seats can only be granted in the posterly dashboard. The workspace owner is emailed about every change. For action=invite with confirm, reuse idempotency_key if the response is lost.
Inputs: action (required), workspace_id (required), role, email, +8 more.
manage_x_posting_addonADestructiveInspect
Buy an X posting add-on. action=buy: plan_code is x_posts_100 ($8/month, 100 extra posts), x_posts_250 ($18/month, 250), or x_posts_500 ($35/month, 500). Call without confirm to see the price. Show that price to the user. Nothing is charged on the preview. Then call again with confirm=true, the preview_id, and expected_addon_status, expected_plan_code, and expected_price_usd from the preview. Confirming returns a Stripe Checkout link. The card is charged only after the user pays on that page. If an add-on is already active, confirming opens the billing page for the workspace owner and does not buy a second plan. Read the allowance with get_x_posting_quota. Owner or admin. billing:write.
Inputs: action (required), confirm, plan_code, preview_id, +4 more.
pause_subscriptionADestructiveIdempotentInspect
Pause the authenticated user's posterly subscription for 30 days (one pause allowed per 90-day cooldown). A free trial cannot be paused (409 trial_not_pausable). Billing action; requires the billing:write scope. Only call after the user explicitly confirms.
Inputs: confirm (required).
posterly_statusARead-onlyIdempotentInspect
Check posterly's own publishing health: overall state from the last 4 hours of publishing success, any active incident (for example X being unavailable), and per-platform state with 7-day success rate and publish counts. Call it before scheduling a time-critical post, or when a user asks whether posterly or a platform is down or why posts are failing. Says so plainly when there is not enough recent activity to judge. Failures caused by content or account problems (expired connections, content limits) are excluded from the rates and reported separately as customer_side. Not the same as whoami view "status", which only reports the MCP server and npm package version. Read-only; aggregates only, no post or user data.
Inputs: no named parameters.
resume_subscriptionAIdempotentInspect
Resume the authenticated user's paused posterly subscription, restoring active billing. Requires the billing:write scope.
Inputs: no named parameters.
run_video_functionARead-onlyIdempotentInspect
Run a read-only Google Veo or xAI Grok video helper function before generation. Does not generate video or spend credits.
Inputs: identifier (required), functionName (required), params.
submit_agent_feedbackBInspect
Submit bounded private operational telemetry after a concrete posterly workflow outcome. This is non-destructive to product content but writes a private feedback event. Never include API keys, prompts, captions, media URLs, personal data, or fabricated outcomes. Requires an authenticated bearer API key and paid API add-on.
Inputs: tool (required), source (required), outcome (required), client, +3 more.
submit_product_feedbackAInspect
File a product bug, idea, or general feedback on the public posterly feedback board (same board users see in the dashboard). Only call this when the human explicitly asks to report a bug, suggest a feature, or send feedback to posterly. Require confirm=true after they approve the title and category. Never use this for tool failures or retries - use submit_agent_feedback for private operational telemetry. Never include API keys, secrets, captions, media URLs, or personal data about third parties. Requires an authenticated bearer API key and paid API add-on.
Inputs: title (required), confirm (required), category (required), client, +3 more.
trigger_platform_helperBRead-onlyIdempotentInspect
Run a platform helper for account-specific discovery, such as pinterest.boards, tiktok.creator_info, linkedin.recent_mentions, linkedin.company_lookup, youtube.playlists, or x.quota. Company lookup and YouTube playlists stay off until they are switched on.
Inputs: helper (required), params, platform, account_id.
update_postADestructiveIdempotentInspect
Change a scheduled or draft post. DESTRUCTIVE WRITE: show the user a side-by-side of CURRENT vs PROPOSED and pass confirm=true only after explicit confirmation. Edit (default): caption, media, schedule, post_type, settings, account_id, or thread_posts; cannot edit published or currently publishing posts. account_id moves it to another account in the same workspace and brand (the platform follows). thread_posts replaces an X or Threads reply chain (2+ non-empty parts; the first is the caption). If a client already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change, thread edit, or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. A reconnect pause, including on X, resumes with status scheduled once the account is healthy, the time is in the future, and publishing is not paused. A billing pause, including on X, resumes once billing is clear, the time is in the future, and publishing is not paused. release_id (with optional group_id): set or repair external release/group IDs; send it on its own. approval_action (request, approve, request_changes, or reject): change client approval. Owner or admin only; the actor is the API key user, never a brand guest. request emails the brand reviewers; the others are team-side decisions. request_changes needs approval_note. Optional approval_axis is asset or caption; omit it for both. Send approval_action on its own. Pass the Version from get_post as expected_version and send only changed fields; a stale edit is refused.
Inputs: confirm (required), post_id (required), status, caption, +18 more.
upgrade_subscriptionADestructiveIdempotentInspect
Upgrade to a strictly higher plan. MONEY: charges the saved card exactly the quoted amount (prorated). Owner only. Call without confirm for the quote and preview_id; after the user agrees, call with confirm=true, that preview_id, the expected_ fields and proration_date. A changed price is refused. If the quote mentions AI agent access, mention that option once. Set add_api_addon true only when the user asks to add it. 3D Secure or a decline returns a payment link; nothing changes.
Inputs: tier (required), confirm, interval, preview_id, +6 more.
upload_mediaADestructiveInspect
Upload an image or video to posterly storage and get a URL for create_post; nothing is published. base64_data with filename: small files (<=5MB decoded). url: copy a public HTTPS image or video. Larger files: create_signed_upload, then PUT the bytes. JPEG, PNG, GIF, WebP, MP4, MOV, WebM; counts against storage quota. No PDFs here: use create_signed_upload or create_media_drop. asset_id (from list_media) deletes that library file after a preview. A file a post still uses is kept.
Inputs: url, confirm, asset_id, filename, +5 more.
validate_postARead-onlyIdempotentInspect
Validate and normalize one post without creating it. Non-destructive: no records, media copies, quota use, webhooks or publication. Third-party media may return remote_media_not_materialized (live create copies and validates it). Run this before the final preview and the create_post confirmation. Advisory brand name and competitor checks with brand_compliance=true; never blocks.
Inputs: caption, metadata, platform, settings, +12 more.
whoamiARead-onlyIdempotentInspect
Who you are and how posterly is connected. view=identity (default): the authenticated user, API key scopes, workspaces, and onboarding next step. Pass include=api_keys to also list this account's API keys (name, prefix, scopes, created, last used). The secret is never included. Call this first. If onboarding.completed is false, call complete_onboarding (name and IANA timezone) IN THIS chat before scheduling, never via /onboarding-v2; if true, never ask again. view=status: hosted MCP server version, latest npm version for local app clients, endpoint and API auth health, and update guidance.
Inputs: view, include.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Social media scheduler for AI agents: draft, schedule and publish posts. OAuth or API key.
Publish, schedule, and manage social media posts across major platforms via the Postproxy API.
Schedule and publish social posts with OAuth, drafts, media, workspaces, and brand memory.
Publish and schedule social media posts and read analytics across 12 networks through one API.
Related MCP Servers
- AlicenseAqualityBmaintenanceSchedule and manage social media posts across 13 platforms (Bluesky, Threads, Instagram, LinkedIn, Mastodon, YouTube, Facebook, Pinterest, Telegram, Nostr, X/Twitter, Discord, Tumblr and more). OAuth 2.0 + PKCE, 10 tools, draft-first workflow for AI agents.21027AGPL 3.0
- AlicenseAqualityBmaintenanceThe best free social media publishing and scheduling API. Publish to 11 platforms from a single API call. Schedule posts, upload media, track analytics, and automate your social media workflow.514MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to write, schedule, publish, and measure social media posts across LinkedIn, Bluesky, Mastodon, and YouTube, plus manage media and queue slots, through one OAuth URL with no install or API key. It also covers retrying, cancelling, restoring posts and reading analytics, with reversibility safeguards around irreversible publishing.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to upload and schedule videos, images, carousels, and text posts across 17 social platforms, read analytics, and reply to comments through a hosted OAuth connection.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.