Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

posterly

NPM · POSTERLY-MCP-SERVER · 2 COMPONENTS

Validate, schedule, publish, and analyze social content across 18 platforms with posterly.

0 this week 76 Trust /100

Last scanned (17 hours ago)

Scores higher than 53% of npm servers

Category Marketing and SEO

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security81
  • No malware found by supply-chain analysis.Pass
  • CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
  • No install/post-install scripts declared.Pass
  • 31 of 93 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability59
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 22157 tokens (~295/item across 75 items; 75 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage95
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 86% of tool parameters carry a description.Partial
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 76 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 17 Nov 26 +6
    • Known CVEs: unverified → fail ▼ security
    • Dependency health: unverified → 0.85 ▲ functional
  • 16 Nov 26 −6
    • Known CVEs: fail → unverified ▼ security
    • Stability: pass → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Dependency health: 0.85 → unverified ▼ functional
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • Package version: 0.58.0 → 0.63.0 functional
    • Package version: 0.58.0 → 0.62.1 functional
  • 14 Nov 26 +1
    • Stability: 0.97 → pass security
  • 12 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.

  • 10 Nov 26 +6
    • Source repository: unverified → pass ▲ security
  • 9 Nov 26 −5
    • Provenance: pass → unverified ▼ security
  • 8 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.

  • 6 Nov 26 +2
    • Stability: fail → 0.73 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/posterly-mcp-server@0.63.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-mrhx-c7xc-m3w5 CVE-2023-54404 high CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H yes

Background: What a vulnerability scan can and cannot prove →

Dependencies 93 packages
Packages resolved 93
Stale 31
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 75 exposed · ~21,852 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
ask_support ~209

Ask posterly Support AI an authenticated question using posterly docs plus read-only account/post diagnostics for the caller workspace. Requires POSTERLY_API_KEY with accounts:read and posts:read scopes. Human ticket creation requires request_human=true and confirm_escalation=true after explicit user confirmation.

NameTypeReqDescription
confirm_escalationboolean–Must be true after explicit user confirmation before a human support ticket can be created.
conversation_idstring–Continue a previous support conversation.
page_urlstring–Optional posterly page URL for context.
post_idinteger–Optional post ID to inspect directly.
questionstringyes–
referenced_post_idsarray–Optional post IDs to include in read-only diagnostics.
request_humanboolean–Ask for human review. Does not create a ticket unless confirm_escalation is also true.
workspace_idstring–Workspace to inspect. Omit to use the API-key scoped workspace or personal workspace.

No output schema declared.

No examples provided.

audit_google_business_profile ~186

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
location_idstring–Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Pref…
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

cancel_subscription ~209

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.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms the cancellation.
feedbackstring–Optional free-text detail the user gave about why they are cancelling.
immediateboolean–Cancel immediately instead of at period end. Defaults to false. Ignored for past_due and unpaid plans, which always end now.
reasonstringyesWhy the user is cancelling. Ask the user before calling; do not guess.

No output schema declared.

No examples provided.

complete_onboarding ~213

Finish posterly onboarding IN THIS conversation, for people who signed up through an AI app. Call whoami first: only when onboarding.completed is false, ask what to call them and their IANA timezone (for example Europe/London), then call this with name and timezone. It saves the same About you answers as the web onboarding and marks onboarding complete, so the dashboard and connect links open directly. Never call it, and never ask the onboarding questions, when onboarding.completed is already true. Next, offer create_connect_session for the network they want to post to first.

NameTypeReqDescription
completeboolean–Mark onboarding complete (default true). Pass false to save name or timezone only.
namestring–What to call the user (their display name in posterly). A name already taken gets a short suffix, which the result reports.
timezonestring–IANA timezone such as Europe/London or America/New_York. Free text such as a city name is rejected so you can ask again.

No output schema declared.

No examples provided.

connect_account ~430

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.

NameTypeReqDescription
api_keystring–Dev.to: API key from Settings, Extensions, DEV Community API Keys.
app_passwordstring–Bluesky: app password from account settings. WordPress: application password from wp-admin Users, Profile, Application Passwords.
bot_tokenstring–Telegram: bot token from BotFather.
chat_idstring–Telegram: target channel or group chat ID.
connect_session_idstring–Optional connect session ID to mark connected or failed based on the outcome.
handlestring–Bluesky: handle, for example posterly.bsky.social.
instancestring–Lemmy: instance domain, for example lemmy.world.
passwordstring–Lemmy: account password (TOTP-enabled accounts are not supported).
patstring–Hashnode: personal access token from Account Settings, Developer.
platformstringyesCredential-based connection target: telegram, bluesky, discord, wordpress, devto, hashnode, or lemmy.
site_urlstring–WordPress: site URL, e.g. https://blog.example.com.
usernamestring–WordPress: username the application password belongs to. Lemmy: username or email.
webhook_urlstring–Discord: channel webhook URL from channel settings, Integrations, Webhooks.
workspace_idstring–Workspace to connect the account into. Workspace-scoped API keys ignore this.

No output schema declared.

No examples provided.

create_api_key ~330

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.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms that a new secret API key should be created.
expires_in_daysinteger–Optional expiry from now, up to 365 days. Never later than the calling key: omitted, the new key inherits the calling key's expiry (none if the calling key does not expire).
namestring–Human-readable key name.
scopesarray–Scopes for the new key. Omit to copy the calling key scopes. Cannot exceed the calling key scopes. billing:read and billing:write allow managing the posterly subscription (cancel/pause/resume/downgra…
workspace_client_idstring–Optional brand (workspace client id) in that workspace. Omit for a key that can see every brand. A key limited to one brand cannot create keys.
workspace_idstring–Optional workspace restriction. Workspace-scoped calling keys cannot create keys outside their workspace.

No output schema declared.

No examples provided.

create_connect_session ~186

Create a short-lived posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll list_accounts with view=connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; posterly handles those browser steps.

NameTypeReqDescription
auto_startboolean–When true, the dashboard starts the provider flow after the user opens the URL. Defaults to true.
debugboolean–When true, include the raw connect session JSON for debugging. Keep false for normal user-facing agent flows.
platformstringyesConnection target such as instagram, meta, linkedin_page, twitter, google_business, telegram, bluesky, discord, mastodon, devto, hashnode, wordpress, or lemmy.
workspace_idstring–Workspace to connect the account into. Workspace-scoped API keys ignore this.

No output schema declared.

No examples provided.

create_media_drop ~197

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/<token>). 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.

NameTypeReqDescription
filenamestring–Optional filename hint for the user, e.g. launch-video.mp4
max_filesinteger–How many files the drop can accept. Default 10, max 20.
workspace_idstring–Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.

No output schema declared.

No examples provided.

create_post ~1,821

Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user's real social accounts - once scheduled_at passes, it will be posted publicly and cannot be un-posted. REQUIRED BEFORE CALLING: 1. Call `whoami` at the start of any new session to confirm which workspace and user you are acting for. 2. Show the user a preview containing ALL of: account(s) and platform(s), final caption text, scheduled time (in the user's timezone), media attached (if any), and workspace name. 3. Get explicit confirmation from the user (e.g. "post it", "yes schedule that", "looks good") BEFORE calling this tool. Do NOT infer consent from earlier instructions like "post about X every Monday" - confirm each individual post or the entire batch. 4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole, then prefer `create_posts_batch` so they are created in one API request. AFTER CALLING: Tell the user the post was created, include the posterly dashboard link returned by the tool, and offer the next natural action. Do not narrate raw HTTP, curl, or API plumbing. Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller's default (personal) workspace - pass workspace_id explicitly if the user has more than one workspace. MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media` with `url` first if you want to upload once and reuse the returned posterly URL across posts. THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Me…

NameTypeReqDescription
account_idstring–Social account ID (from list_accounts)
captionstring–The post caption/text content. On Instagram, @username is a caption mention, not a native tag or collaborator invite. Optional on Instagram Stories (first slide only in a series). Ignored when `threa…
confirmbooleanyesMust be true after explicit user confirmation of the post/account/workspace/schedule.
idempotency_keystring–Optional retry key (printable ASCII, 255 characters or fewer). Reuse it when a create errors, times out, or the response is lost. If omitted, an identical create within about 10 minutes returns the o…
instagram_settingsobject–Instagram-specific settings. If “tag” is ambiguous, distinguish caption @mentions (put @username in caption), native media tags (user_tags), and co-author invitations (collaborators). Native media ta…
media_urlstring–Media URL to attach. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved. Short-lived signed URLs must still be live when this too…
media_urlsarray–Multiple media URLs for carousel or multi-image posts. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved. For TikTok, 2 or more…
platformstring–Platform name (required with username). Supported: instagram, facebook, tiktok, twitter, linkedin, youtube, pinterest, threads, google_business, telegram, bluesky, discord, slack, mastodon, devto, ha…
platform_settingsobject–Platform-specific settings for the selected account. Use this for non-Instagram settings and prefer it over raw metadata.
post_typestring–Optional post type: text, image, video, carousel, reel, story, story_series, document, photo, cover_photo, x_thread, or threads_thread. Omit it for auto-detection from media. For TikTok photo posts,…
scheduled_atstring–ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.
thread_postsarray–For X or Threads only: array of 2+ strings, one per post in the thread. The first entry leads, the rest reply in order. When set, the platform must be twitter or threads.
usernamestring–Account username (alternative to account_id)
workspace_idstring–Workspace ID to assign the post to (from whoami). If omitted, uses the account's workspace or the caller's default workspace.

No output schema declared.

No examples provided.

create_posts_batch ~477

Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user's real social accounts - once scheduled_at passes, posts may go public and cannot be un-posted. REQUIRED BEFORE CALLING: 1. Call `whoami` at the start of any new session to confirm which workspace and user you are acting for. 2. Show the user a preview of EVERY post: account/platform, final caption or thread text, scheduled time in their timezone, media, platform settings, and workspace. 3. Get explicit confirmation for the whole batch before calling. Do not infer consent from an earlier content plan. AFTER CALLING: Summarize the batch result in natural language, include the posterly dashboard link returned by the tool, and avoid narrating raw HTTP, curl, or API plumbing. Each item accepts the same fields as `create_post`, including `thread_posts`, `platform_settings`, `instagram_settings`, media URLs, workspace_id, and idempotency_key. For TikTok, an item with no `platform_settings.privacy_level` publishes directly using the saved audience, else public, and returns `tiktok_audience_defaulted` (tell the person); `post_mode: "inbox"` sends it to the app. The endpoint may partially succeed; failed items are returned with their index. IDEMPOTENCY: If this call errors, times out, or the response is lost, retry with the same idempotency_key (and the same per-item keys). If you omit them, an identical batch within about 10 minutes returns the original posts instead of creating them again (deduplicated: true, original post id). When a result is unclear, call get_post or list_posts before creating again.

NameTypeReqDescription
confirmbooleanyesMust be true after explicit user confirmation of every post in the batch.
idempotency_keystring–Optional retry key for the whole batch. Reuse it when the batch errors or the response is lost. Per-item idempotency_key wins for that item. If both are omitted, each item gets its own key for about…
postsarrayyesPosts to create. Each item uses the same schema as create_post, including an optional idempotency_key.

No output schema declared.

No examples provided.

create_signed_upload ~410

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). Pinning is available per request with pin_content_type: true, which locks each slot to the content_type you declare (a PUT with any other Content-Type then fails with 403). posterly may turn it on by default in the future, so always send the Content-Type header returned with the slot. Slots expire in 15 minutes.

NameTypeReqDescription
content_typestring–Single file: MIME type, e.g. video/mp4. Omit when using files.
filenamestring–Single file: filename with extension, e.g. launch-video.mp4. Omit when using files.
filesarray–Batch: 1 to 20 {filename, content_type, size}. Use instead of the single-file fields.
pin_content_typeboolean–Optional. true locks each slot to the declared content_type; a PUT with any other Content-Type fails with 403.
sizeinteger–Single file: size in bytes. Omit when using files.
workspace_idstring–Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.

No output schema declared.

No examples provided.

create_webhook ~156

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.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms webhook creation.
descriptionstring––
eventsarray–Events to deliver. Defaults to core post lifecycle events.
is_activeboolean–Defaults to true.
urlstringyesHTTPS webhook endpoint URL. Localhost HTTP is allowed by the API for development.
workspace_idstring–Optional workspace filter. Omit for all workspaces owned by the API key user.

No output schema declared.

No examples provided.

delete_api_key ~123

Revoke a posterly API key owned by the authenticated user. DESTRUCTIVE: call whoami or use a known key ID, 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.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms API key revocation.
key_idstringyesAPI key ID to revoke. This is the API key resource ID, not the secret pst_live_ value.

No output schema declared.

No examples provided.

delete_post ~438

Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered. post_id: delete one post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). 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. Never delete several posts one by one without listing each and confirming the full list.

NameTypeReqDescription
confirmboolean–post_id: true after explicit user confirmation of the deletion. group_id: leave out to get a preview; true only with the preview_id after the user approved it.
confirm_publishedboolean–With post_id only. True only after the user explicitly confirms taking a live post down. Required with delete_mode=platform.
delete_modestring–posterly removes only the record; platform also takes down live content and requires confirm_published=true.
group_idstring–Delete every unpublished post in this group or release instead. Never deletes published posts.
post_idnumber–Delete this one post.
preview_idstring–group_id: the preview_id from the preview call. Required with confirm: true.

No output schema declared.

No examples provided.

disconnect_account ~123

Disconnect a connected social account from posterly. DESTRUCTIVE and IRREVERSIBLE: removes the account connection, emits account.disconnected webhooks, and may transfer Instagram scheduled posts to a replacement account. REQUIRED BEFORE CALLING: Call `list_accounts` first, show the user the exact platform, username, account ID, and workspace that will be disconnected, then get explicit confirmation. Pass confirm=true only after that confirmation.

NameTypeReqDescription
account_idstringyesConnected social account ID from list_accounts.
confirmbooleanyesMust be true after explicit user confirmation.

No output schema declared.

No examples provided.

dismiss_suggestion ~120

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.

NameTypeReqDescription
save_as_draftboolean–True saves the suggestion as an unpublished draft and does not dismiss it. Omit to dismiss.
suggestion_idstringyesSuggestion ID from list_post_suggestions.

No output schema declared.

No examples provided.

downgrade_subscription ~108

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.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms the downgrade.
tierstring–Optional explicit target tier. Omit to drop one tier automatically.

No output schema declared.

No examples provided.

find_available_slot ~269

Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Each slot includes the UTC instant to pass as scheduled_at. Pass workspace_id to only avoid collisions with posts in that workspace. 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.

NameTypeReqDescription
account_idsarray–Filter slots for specific account IDs
countnumber–Number of slots to return (max 10). Default 5 for next_free, 3 for best_engagement.
strategystring–next_free (default): earliest free slots. best_engagement: best times by engagement (requires account_ids).
timezonestring–IANA timezone (e.g. Asia/Dubai, Europe/London). Defaults to America/New_York - pass the user's actual timezone or slots will be wrong.
workspace_idstring–Scope slot-finding to a single workspace (get IDs via whoami).

No output schema declared.

No examples provided.

generate_captions ~239

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 or schedule posts. After the user chooses final copy, pass it to create_post or create_posts_batch.

NameTypeReqDescription
allow_emojisboolean––
briefstring–What the post is about. Recommended for generate mode.
countinteger––
hashtag_strategystring––
manual_brand_voiceobject–Use when posterly asks for brand voice input.
modestring––
platformsarrayyesTarget platforms such as instagram, linkedin, twitter, tiktok, youtube, pinterest, or google_business.
preserve_call_to_actionboolean––
preserve_linksboolean––
preserve_mentionsboolean––
social_account_idstring–Optional connected account ID for brand voice and workspace billing context.
source_captionstring–Required when mode=adapt. The master caption to adapt.
source_platformstring––
tonestring––
workspace_idstring––

No output schema declared.

No examples provided.

generate_image ~729

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 until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price. COSTS CREDITS. Every call consumes part of the user's monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you're about to generate (subject, style, aspect ratio, quality/thinking, resolution) to the user and get confirmation before calling. If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry. Common aspect ratios by platform: • Instagram feed / LinkedIn: 1:1 (square) or 4:5 (portrait) • Instagram Story/Reel, TikTok, YouTube Shorts: 9:16 • YouTube thumbnail, Twitter cards, landscape feed: 16:9 • Pinterest: 2:3

NameTypeReqDescription
aspect_ratiostring–Aspect ratio. Default 1:1. Pick based on target platform (see tool description).
confirmbooleanyesMust be true after explicit user confirmation of subject, style, aspect ratio, quality, and credit use.
modelstring–Google-only. lite (8 credits, 1K only) suits drafts; flash (default, Nano Banana 2.1, 15 at 1K) balances quality and cost; pro (30 at 1K) is highest quality. Ignored for xAI.
promptstringyesDetailed image description. 5-4000 characters. Describe subject, scene, lighting, mood, and style.
providerstring–Image provider. Default google. Use xai for Grok Imagine Image 2.0.
qualitystring–Google: high turns on Gemini thinking (dashboard thinkingLevel=high). low/medium leave thinking minimal unless thinking_level is set. xAI: low or medium credit tiers; high is invalid.
reference_image_urlsarray–Google only. Up to 14 HTTPS image URLs used as references (logo, product, style lock). Same as dashboard reference images.
resolutionstring–Output resolution. Default 1K. xAI supports 1K/2K only. Google flash (Nano Banana 2.1): 15/23/35 credits at 1K/2K/4K. 512 is no longer available. Pro: 30 at 1K-2K, 55 at 4K.
stylestring–Preset style. Default photographic. Use youtube_thumbnail / reel_cover for platform-optimized covers; review_background for testimonial backgrounds.
thinking_levelstring–Google flash/lite only. Gemini image quality control. minimal is fastest; high is for infographics, grounded scenes, and harder layouts. Pro reasons automatically. Overrides quality when both are set…
variationsinteger–How many variations to generate. Default 1. Each variation costs credits separately - prefer 1 unless the user explicitly wants options.
workspace_idstring–Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.

No output schema declared.

No examples provided.

generate_video ~280

Queue an AI video generation 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. Grok supports 1 to 15 seconds and 480p to 1080p; reference-to-video is capped at 720p. Poll list_jobs with type=video for status and final video_url.

NameTypeReqDescription
aspect_ratiostring––
confirmbooleanyesMust be true after explicit user confirmation of prompt, model, duration, resolution, and credit cost.
duration_secondsinteger––
end_image_urlstring––
generate_audioboolean–Google can disable generated audio. xAI Grok includes audio and requires this to remain true.
image_urlstring––
modelstring––
negative_promptstring––
promptstringyes–
providerstring––
reference_imagesarray––
resolutionstring––
source_video_urlstring––
workspace_idstring–Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.

No output schema declared.

No examples provided.

get_agent_signup_info ~36

Explain how to use posterly MCP for agent-led signup before an API key exists, including the safe human-in-the-browser boundaries.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_credits ~88

Get the authenticated user's posterly AI credit balance: what is available to spend now, how much of the monthly included allowance is left, purchased pack balance, plan tier, and when the included pool next resets. Credits are a shared WORKSPACE wallet, so this reports the balance the caller can actually spend, not a personal figure. Read-only, spends nothing. Requires the billing:read scope.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_post ~148

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), its Version and who last edited it (pass the Version as expected_version when you update), 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.

NameTypeReqDescription
post_idnumberyesThe post ID to look up
viewstring–post (default) or missing.

No output schema declared.

No examples provided.

get_signup_session ~133

Poll a public posterly signup session created by start_signup. Use this to narrate the free trial (card saved, nothing charged today), password setup, and agent access status before a posterly API key is installed. An account that already had a trial is charged at checkout instead. Keep updates user-facing; do not narrate raw HTTP, curl, or API plumbing.

NameTypeReqDescription
debugboolean–When true, include the raw signup session JSON for debugging. Keep false for normal user-facing agent flows.
session_idstringyesSignup session ID returned by start_signup, usually the Stripe checkout session ID.

No output schema declared.

No examples provided.

get_subscription ~122

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_updates ~139

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.

NameTypeReqDescription
include_contentboolean–Include the full markdown body of each update. Defaults to false.
limitinteger–Number of updates to return. Default 10, max 50.
offsetinteger–How many updates to skip. Use the offset the previous page gives to get the next page.
sincestring–ISO date. Return updates published on or after this date.

No output schema declared.

No examples provided.

get_video_options ~42

List read-only Veo video generation options, input modes, durations, resolutions, aspect ratios, and credit-cost estimates. This does not generate video or spend credits.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_x_posting_quota ~59

Get managed X posting quota for a workspace, including total monthly allowance, used posts, remaining posts, and URL-blocking status.

NameTypeReqDescription
workspace_idstring–Workspace ID from whoami. Defaults to the caller personal workspace context.

No output schema declared.

No examples provided.

list_accounts ~371

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 identify direct-login versus Meta-linked connections 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 saved brand profile. view=performance_profile (account_id): 90-day coaching stats, engagement-rate trend, and summary (Pro plan or higher; platforms without per-post analytics never get one). view=connect_session (session_id): poll a session from create_connect_session and keep the user updated in plain language; stop when status is connected, failed, cancelled, or expired.

NameTypeReqDescription
account_idstring|number–Social account ID from list_accounts. Required for learned_voice and performance_profile; with view=accounts it returns just that account.
connectionstring–view=accounts: ok, or needs_reconnect to list only accounts that need a reconnect.
debugboolean–view=connect_session: when true, include the raw connect session JSON for debugging. Keep false for normal user-facing agent flows.
session_idstring–view=connect_session: connect session ID returned by create_connect_session.
viewstring–accounts (default), learned_voice, performance_profile, or connect_session.
workspace_idstring–view=accounts: filter to accounts in a specific workspace (get IDs via whoami).

No output schema declared.

No examples provided.

list_activity ~200

List recent activity and publish events for posts, including edits (who changed what, and from where: dashboard, API key, MCP, client review), 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.

NameTypeReqDescription
limitinteger–Number of items to return. Default 50, max 100.
offsetinteger–How many events to skip. Use the offset the previous page gives to get the next page.
post_idinteger–Filter to one post ID.
sincestring–ISO datetime. Return events created at or after this time.
typestring–Event source filter. Defaults to all.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_analytics ~496

Analytics for connected social accounts (Instagram, X, Facebook, 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 account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, 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 (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers. include_extras on accounts asks for saved audience breakdowns, the last analytics sync, and entity snapshots. Those stay off until snapshot extras are switched on, and this does not start a new sync.

NameTypeReqDescription
account_idnumber|string–The social account ID (from list_accounts). Required for accounts and posts; optional filter for insights.
checkpointstring–insights: filter to one checkpoint after publish.
fromstring–accounts and posts: start date (ISO date, e.g. 2026-03-19). Defaults to 30 days ago.
include_extrasboolean–accounts: also return saved audience breakdowns, sync status, and entity snapshots when that read is switched on.
limitnumber–posts: number of posts (default 50, max 200). insights: max insights (default 20, max 100).
offsetnumber–posts: pagination offset
post_idinteger–insights: filter to one post ID.
presentationstring–accounts and posts: compact, table, or json.
tostring–accounts and posts: end date (ISO date). Defaults to today.
viewstringyesaccounts, posts, or insights.

No output schema declared.

No examples provided.

list_brands ~211

Brands (clients) and their saved context. view=brands (default): brands the caller can access with brand ID, name, workspace ID, source, and how many social accounts are assigned (optional workspace_id). view=brand (brand_id): one brand with its workspace, source, and linked legacy brand group. view=accounts (brand_id): the connected social accounts assigned to the brand; use it when a user refers to a brand name rather than an account 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).

NameTypeReqDescription
brand_idstring–The brand ID (from view=brands). Required for brand, accounts, and profile.
viewstring–brands (default), brand, accounts, or profile.
workspace_idstring–view=brands: filter to brands in a specific workspace (get IDs via whoami).

No output schema declared.

No examples provided.

list_comments ~237

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.

NameTypeReqDescription
account_idinteger–From list_accounts.
comment_idstring–One comment and its replies.
filterstring–Default all.
limitinteger–Rows to return. Default 50.
offsetinteger–Rows to skip.
platformstring––
searchstring–Search comment content or author username.
sincestring–ISO date/time, inclusive.
untilstring–ISO date/time, inclusive.
workspace_idstring–Omit to search all your workspaces, or pass an ID from whoami.

No output schema declared.

No examples provided.

list_conversations ~292

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.

NameTypeReqDescription
account_idinteger–From list_accounts.
conversation_idstring–One conversation and its messages.
filterstring–Default all (excludes archived).
limitinteger–Rows (messages with conversation_id). Default 50.
offsetinteger–Rows to skip.
platformstring–Instagram or Facebook. Threads has comments, not DMs.
searchstring–Search participant username or last message preview.
sincestring–ISO date/time, inclusive.
untilstring–ISO date/time, inclusive.
workspace_idstring–Omit to search all your workspaces, or pass an ID from whoami.

No output schema declared.

No examples provided.

list_google_business_locations ~380

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
category_viewstring–categories: BASIC (default) or FULL (includes service types and more-hours types).
include_google_updatedboolean–profile: when true, also check Google-suggested updates (the getGoogleUpdated method).
language_codestring–categories: BCP-47 language code, e.g. en or en-GB.
location_idstring–Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Pref…
page_sizeinteger–categories: max results per page (1 to 100, default 50).
page_tokenstring–categories: next_page_token from a previous categories response.
prefixstring–categories: optional category display name prefix filter.
region_codestring–categories: two-letter ISO country code, e.g. US or GB.
viewstring–profile (default) or categories.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_google_business_media ~230

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
limitinteger–Items per page. Default 50, max 200. This pages the gallery already fetched; it does not ask Google for a smaller page.
location_idstring–Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Pref…
offsetinteger–Items to skip. Use the offset the previous page gives.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_google_business_reviews ~329

Google Business Profile reviews. view=reviews (default): reviews for one location/account or every accessible GBP location, paging through all reviews 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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
limitinteger–reviews: maximum reviews to return in this call (default 200, max 1000). Every returned review is listed in full.
location_idstring–Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from view=review_link. Prefer account_id.
offsetinteger–reviews: skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.
ratinginteger–reviews: filter to a 1-5 star rating.
unansweredboolean–reviews: only return reviews without owner replies.
viewstring–reviews (default) or review_link.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_google_business_service_areas ~254

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts. Required for view=areas.
location_idstring–Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Pref…
qstring–places: town or postcode to search for.
region_codestring–places: optional two-letter country code, for example GB.
viewstring–areas (default) or places (search).
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_jobs ~136

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 Veo or Grok video job by job_id, or recent video jobs (status includes dismissed, limit); poll it after generate_video for the finished video_url.

NameTypeReqDescription
job_idstring–One job. Leave out to list recent jobs.
limitinteger––
statusstring–Filter a job list. dismissed is video only.
typestringyesimage or video.

No output schema declared.

No examples provided.

list_media ~184

List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files the human uploaded on /drop/<token>. 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.

NameTypeReqDescription
drop_session_idstring–Filter to files uploaded through one create_media_drop session
limitinteger–Number of assets to return (default 10, or 20 when drop_session_id is set; max 50)
offsetinteger–How many assets to skip. Use the offset the previous page gives to get the next page.

No output schema declared.

No examples provided.

list_oauth_clients ~34

List self-serve OAuth developer clients owned by the user. These are public PKCE clients for third-party app integrations.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_platforms ~387

Platforms, settings schemas, and connection links. view=platforms (default): posterly platform integrations, posting capabilities, content/media limits, settings schemas, helper tools, and analytics support (include_planned shows future integration possibilities). view=schema: the settings schema for one connected account_id (preferred: returns connection-specific capabilities, needed before Instagram native tags/collaborators) or one platform; account_id wins if both are given. view=connect_link: dashboard handoff links and readiness for every target, or one target (instagram, meta, linkedin_page, twitter, telegram, reddit, wordpress, ...); use connection_url in a logged-in browser (direct OAuth URLs are intentionally not exposed); credential platforms show the credential_fields that connect_account needs.

NameTypeReqDescription
account_idstring–view=schema: connected account ID from list_accounts. Preferred because it returns account context.
debugboolean–view=connect_link: when true, include the raw connect option JSON for debugging. Keep false for normal user-facing agent flows.
include_plannedboolean–Include planned integrations such as reddit, medium, skool, whop.
platformstring–view=schema: platform ID such as instagram, facebook, tiktok, twitter, linkedin, youtube, pinterest, threads, google_business, telegram, bluesky, discord, slack, mastodon, devto, hashnode, wordpress,…
targetstring–view=connect_link: connection target such as instagram, meta, linkedin_page, twitter, x, google_business, telegram, reddit, or wordpress. Omit to list live connection targets.
viewstring–platforms (default), schema, or connect_link.
workspace_idstring–view=connect_link: filter connected account counts to a workspace.

No output schema declared.

No examples provided.

list_post_suggestions ~202

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 for that account. 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.

NameTypeReqDescription
account_idstring|number–Filter to one social account ID (from list_accounts).
limitinteger–Max suggestions to return (default 20).
offsetinteger–How many suggestions to skip. Use the offset the previous page gives to get the next page.
statusstring–Suggestion status to list (default pending).

No output schema declared.

No examples provided.

list_posts ~787

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.

NameTypeReqDescription
account_idstring–Filter to a specific social account ID (from list_accounts).
approval_statusstring–Filter by client review approval status. pending_client means the post is waiting on the client.
approval_waiting_onstring–client: approval_status pending_client. team: changes_requested or rejected. Conflicts with a non-overlapping approval_status.
brand_idstring–Filter to posts assigned to a specific brand/client (the id from list_brands).
group_idstring–Caller group id. Matches api_group_id, group_id, and post_group_id.
limitnumber–Posts per page (default 20, max 200). Ignored by view=counts.
offsetinteger–Matching posts to skip; use the offset the previous page gives. Ignored by view=counts.
orderstring–asc (oldest first) or desc (newest first). Default asc with a date range, otherwise desc. Ignored by view=counts.
platformstring–Filter by platform: instagram, facebook, tiktok, twitter, linkedin, youtube, pinterest, threads, google_business, telegram, bluesky, discord, slack, mastodon, devto, hashnode, wordpress, lemmy.
release_idstring–Caller release id. Matches release_id only.
scheduled_fromstring–Start of the scheduled range, inclusive: a date (2026-10-01) or an ISO date-time. Plain dates and times without an offset are read in timezone.
scheduled_tostring–End of the scheduled range: a plain date (2026-10-31) includes that whole day; an ISO date-time is exclusive.
statusstring–Stored post status (draft, scheduled, publishing, processing, awaiting_tiktok_publish, awaiting_manual, published, failed, paused, paused_due_to_token, paused_due_to_billing, or missed). paused_due_t…
timezonestring–IANA time zone such as Europe/London for reading plain dates and showing times. Default UTC.
viewstring–list (default): the posts. counts: totals (needs scheduled_from and scheduled_to).
workspace_idstring–Filter to posts in a specific workspace (get IDs via whoami).

No output schema declared.

No examples provided.

list_publishing_pauses ~76

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.

NameTypeReqDescription
workspace_idstring–Workspace ID from whoami. Defaults to your default workspace.

No output schema declared.

No examples provided.

list_webhooks ~128

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.

NameTypeReqDescription
limitinteger––
offsetinteger––
viewstring–webhooks (default) or deliveries.
webhook_idstring–deliveries: webhook ID from view=webhooks.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

list_workspace_members ~119

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. Needs an API key with the Manage team permission. Any workspace member can list; brand-limited teammates only see brand ids they can access.

NameTypeReqDescription
workspace_idstringyesWorkspace ID (from whoami).

No output schema declared.

No examples provided.

manage_brand ~323

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.

NameTypeReqDescription
actionstringyescreate, update, or archive.
brand_idstring–update and archive: the brand ID from list_brands.
confirmboolean–create and update: true only after the user agrees. archive: true only with the preview_id from a preview call.
namestring–create: required. update: the new name.
preview_idstring–archive: the preview_id from the preview call.
timezonestring–create or update: an IANA timezone such as Europe/London.
website_urlstring–create or update: an http or https website. Pass an empty string on update to clear it.
workspace_idstring–create: workspace ID from whoami, when the key is not already scoped.

No output schema declared.

No examples provided.

Install

How do I install the posterly MCP server?

posterly runs locally as an npm package, launched with npx -y posterly-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · posterly-mcp-server

# add to Claude Code
claude mcp add awpthorp-posterly -- npx -y posterly-mcp-server
Common questions

What is the posterly MCP server?

posterly is an MCP server listed in the public MCP registry as io.github.awpthorp/posterly. Validate, schedule, publish, and analyze social content across 18 platforms with posterly. This page covers its npm package (posterly-mcp-server).

Is the posterly MCP server safe to use?

posterly scores 76 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the posterly MCP server expose?

posterly exposes 75 tools: get_agent_signup_info, start_signup, get_signup_session, whoami, complete_onboarding, and 70 more. Their descriptions and schemas cost roughly 21,852 tokens of context every time the server is loaded.

Is the posterly MCP server still maintained?

posterly is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the posterly MCP server under?

posterly declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the posterly MCP server?

VerifyMCP ran 16 checks on posterly, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.