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
manage_comment ~346

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 take 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.

NameTypeReqDescription
actionstringyesreply, update, or delete.
comment_idstringyesComment ID from list_comments.
confirmboolean–reply and delete: leave out to get a preview; true only with the preview_id after the user approved it.
contentstring–reply: reply text to post.
is_hiddenboolean–update: hide or unhide the comment on Instagram, Facebook, or Threads.
is_readboolean–update: mark the comment read or unread in posterly.
preview_idstring–reply and delete: the preview_id from the preview call. Required with confirm: true.
typestring–reply: public (default) or private. Private is Instagram only.
workspace_idstring–Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.

No output schema declared.

No examples provided.

manage_conversation ~294

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 seconds for LinkedIn); Threads and LinkedIn sync comments only.

NameTypeReqDescription
account_idinteger–sync: social account ID from list_accounts.
actionstringyessend or sync.
confirmboolean–send: leave out to get a preview; true only with the preview_id after the user approved it.
contentstring–send: message text to send.
conversation_idstring–send: conversation ID from list_conversations.
preview_idstring–send: the preview_id from the preview call. Required with confirm: true.
sync_typestring–sync: what to sync. Defaults to all. Threads and LinkedIn are comments-only.
workspace_idstring–Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.

No output schema declared.

No examples provided.

manage_extra_account ~163

Buy, raise, lower, or remove Agency extra-account slots. MONEY: raising charges the saved card. 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 and the expected_ fields from the quote. 3D Secure or a decline returns a payment link; nothing is added.

NameTypeReqDescription
actionstringyes–
confirmboolean––
expected_current_extra_accountsinteger––
expected_intervalstring––
extra_accountsintegeryes–
preview_idstring––
workspace_idstring––

No output schema declared.

No examples provided.

manage_google_business_location ~598

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
actionstringyesWhich location field group to update.
attributesarray–update_attributes: attributes to set. URL values must be https. Names look like attributes/has_wifi.
categoriesobject–update_categories: { primary_category, additional_categories? } with categories/gcid:... resource names (max 9 additional; existing additional categories are carried over when omitted).
confirmboolean–Leave out to get a preview; true only with the preview_id after the user approved it.
descriptionstring–update_description: business description (max 750 chars, no URLs or phone numbers).
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…
phone_numbersobject–update_phones: { primary_phone, additional_phones? } (up to 2 additional; existing additional phones are carried over when omitted).
preview_idstring–The preview_id from the preview call. Required with confirm: true.
regular_hoursobject–update_hours: opening periods. Days are MONDAY-SUNDAY. Times are HH:MM.
service_itemsarray–update_services: full replacement list of structured_service_item or free_form_service_item entries (pass [] to clear all services).
titlestring–update_title: public business title on Google.
website_uristring–update_website: public website URL (http or https).
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

manage_google_business_media ~373

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
actionstringyesadd or delete.
categorystring–add: which gallery category to add the media to.
confirmboolean–Leave out to get a preview; true only with the preview_id after the user approved it.
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…
media_formatstring–add: defaults to PHOTO. Use VIDEO for videos (Google caps profile videos at 30s / 75MB).
media_namestring–delete: full media resource name from list_google_business_media (accounts/.../locations/.../media/...).
preview_idstring–The preview_id from the preview call. Required with confirm: true.
source_urlstring–add: public https URL of the photo or video (from upload_media). Photos must be JPG or PNG, 10 KB to 5 MB.
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

manage_google_business_review ~401

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts (optional brand voice context for suggest_reply).
actionstringyessuggest_reply, reply, or delete_reply.
business_namestring––
commentstring–reply: exact owner reply text to post.
confirmboolean–reply and delete_reply: leave out to get a preview; true only with the preview_id after the user approved it.
countinteger––
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…
preview_idstring–reply and delete_reply: the preview_id from the preview call. Required with confirm: true.
review_namestring–reply and delete_reply: review_name from list_google_business_reviews.
review_textstring–suggest_reply: review text. Leave empty for rating-only reviews.
reviewer_namestring––
star_ratingnumber–suggest_reply: review rating from 1 to 5.
tonestring––
workspace_idstring–Filter to a workspace ID from whoami.

No output schema declared.

No examples provided.

manage_google_business_service_area ~427

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.

NameTypeReqDescription
account_idinteger–Google Business account ID from list_accounts.
actionstringyesupdate: replace the service area list.
business_typestring–CUSTOMER_LOCATION_ONLY travels to customers. CUSTOMER_AND_BUSINESS_LOCATION also has a storefront.
clear_storefront_addressboolean–Set true only when switching to customer-only. Google requires the street address to be removed from the listing in the same update; it is not kept, so adding it back means entering it again.
confirmboolean–Leave out to get a preview; true only with the preview_id after the user approved it.
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…
placesarray–The full replacement list, 1 to 20 areas. Each item needs place_id and place_name.
preview_idstring–The preview_id from the preview call. Required with confirm: true.
region_codestring–Two-letter country code. Required for customer-only listings that do not already have one. Immutable once set.
workspace_idstring––

No output schema declared.

No examples provided.

manage_oauth_client ~304

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.

NameTypeReqDescription
actionstringyescreate, update, or delete.
allowed_redirect_urisarray–create (required) or update.
client_idstring–update and delete: the client_id from list_oauth_clients.
client_namestring–create (required) or update.
confirmboolean–create and update: true after explicit user confirmation. delete: leave out to get a preview; true only with the preview_id after the user approved it.
default_scopesarray–create (required) or update.
descriptionstring––
homepagestring––
is_activeboolean––
preview_idstring–delete: the preview_id from the preview call. Required with confirm: true.

No output schema declared.

No examples provided.

manage_plan ~105

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. Never charges the card. A trial link needs billing:read. Changing a paid plan also needs billing:write.

NameTypeReqDescription
actionstringyes–
intervalstring––
tierstring––

No output schema declared.

No examples provided.

manage_publishing_pause ~315

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.

NameTypeReqDescription
actionstringyespause, resume, or publish_missed.
brand_idstring–pause and resume: a brand ID from list_brands. Leave it out (never empty) for the whole workspace.
confirmboolean–pause: leave out to preview. pause and publish_missed: true only after the user agreed. resume: not needed.
post_idsarray–publish_missed: the missed post IDs a resume returned.
workspace_idstring–Workspace ID from whoami. Defaults to your default workspace.

No output schema declared.

No examples provided.

manage_webhook ~263

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.

NameTypeReqDescription
actionstringyesupdate, delete, or test.
confirmboolean–update and test: true after the user explicitly confirms. delete: leave out to get a preview; true only with the preview_id after the user approved it.
description––update only.
eventsarray–update only.
is_activeboolean–update only.
preview_idstring–delete: the preview_id from the preview call. Required with confirm: true.
urlstring–update only.
webhook_idstringyesWebhook ID from list_webhooks.
workspace_idstring|null–update only. null clears the workspace.

No output schema declared.

No examples provided.

manage_workspace_member ~596

Invite, update, or remove a workspace colleague. This SENDS EMAILS and CHANGES WHO CAN ACCESS the workspace. Needs an API key with the Manage team permission, and the caller must be a workspace owner or admin. ALWAYS preview first: call without confirm, show the preview to the user, and only call again with confirm: true plus the returned preview_id 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.

NameTypeReqDescription
actionstringyesinvite, update, or remove.
api_accessboolean–action=update with member_id only, on its own: true turns API and AI app access on; false turns it off.
brand_idsarray–action=invite or action=update: limit the seat to these brand IDs (from list_brands). Empty array means every brand. Omit on update to keep the current brands.
confirmboolean–Leave out to get a preview. Set true only after the user explicitly approved it, with the preview_id.
emailstring–action=invite only: the colleague email address.
idempotency_keystring–action=invite with confirm: reuse this key if the response is lost. If omitted, an identical confirm within about 10 minutes replays the first result.
invite_idstring–action=update or action=remove: a pending invite ID from list_workspace_members.
member_idstring–action=update or action=remove: a member ID from list_workspace_members.
preview_idstring–The preview_id returned by the preview call. Required with confirm: true.
resendboolean–action=invite only: email an unchanged pending invite again.
rolestring–action=invite (required) or action=update: publisher, editor, or viewer.
workspace_idstringyesWorkspace ID (from whoami).

No output schema declared.

No examples provided.

manage_x_posting_addon ~348

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.

NameTypeReqDescription
actionstringyesbuy: quote an X posting add-on, then open Checkout after the user agrees.
confirmboolean–True only after the user agrees, with the preview_id.
expected_addon_statusstring–From the preview. The add-on status the quote was based on.
expected_plan_codestring|null–From the preview. The current plan code, or null when there is none.
expected_price_usdnumber|null–From the preview. The monthly price in dollars, or null.
plan_codestring–Which add-on to buy. Not used when one is already active.
preview_idstring–The preview_id from the preview call.
workspace_idstring–Workspace ID from whoami, when the key is not already scoped.

No output schema declared.

No examples provided.

pause_subscription ~66

Pause the authenticated user's posterly subscription for 30 days (one pause allowed per 90-day cooldown). Billing action; requires the billing:write scope. Only call after the user explicitly confirms.

NameTypeReqDescription
confirmbooleanyesMust be true after the user explicitly confirms pausing the subscription.

No output schema declared.

No examples provided.

posterly_status ~154

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

resume_subscription ~28

Resume the authenticated user's paused posterly subscription, restoring active billing. Requires the billing:write scope.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

run_video_function ~114

Run a read-only Google Veo or xAI Grok video helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.

NameTypeReqDescription
functionNamestringyesHelper function name from get_video_options.tools.
identifierstringyesVideo generator identifier from get_video_options.
paramsobject–Function parameters. estimate_cost accepts model, duration_seconds, resolution, output, and xAI input_image_count. validate_request accepts a generate_video-style payload.

No output schema declared.

No examples provided.

start_signup ~376

Start the public posterly signup for a user before posterly API access exists. A new account starts a 7-day free trial: Stripe Checkout collects a card, nothing is charged today, and the card is charged on day 8 unless the paid plan starts sooner. API and MCP stay limited during the trial. The API add-on is still required. Returns a signup poll URL, a browser Checkout handoff URL, and a payment object for that Checkout session (trial length, whether anything is charged today, merchant, and agent-wallet instructions). An account that already had a trial is charged at checkout instead. The user still sets a password and approves social OAuth in the browser. Never ask for card numbers, a posterly password, or social passwords in chat.

NameTypeReqDescription
api_addonboolean–Always true for AI agent setup because MCP/API access requires the API add-on.
debugboolean–When true, include the raw signup response JSON for debugging. Keep false for normal user-facing agent flows.
emailstringyesUser email address to sign up. Confirm this with the user before calling.
intervalstring–Billing interval. Public agent signup currently supports monthly billing.
namestring–Optional user or workspace name to pass into posterly signup.
return_pathstring–Where posterly should continue after checkout and password setup.
sourcestring–Source label for analytics and support diagnostics.
tierstring–posterly plan to start. Use starter unless the user explicitly chooses another plan.
tos_acceptedboolean–Set true only after the user has explicitly confirmed, in this conversation, that they accept the posterly terms at https://www.poster.ly/terms. Sending it here avoids a separate terms-confirmation s…

No output schema declared.

No examples provided.

submit_agent_feedback ~102

Submit bounded private operational telemetry after a concrete posterly workflow outcome. This does not alter product content but writes a private feedback event. Never include API keys, prompts, captions, media URLs, personal data, or fabricated outcomes.

NameTypeReqDescription
clientstring––
commentstring––
contextobject––
error_code–––
outcomestringyes–
sourcestringyes–
toolstringyes–

No output schema declared.

No examples provided.

submit_product_feedback ~156

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.

NameTypeReqDescription
categorystringyes–
clientstring––
confirmbooleanyes–
contextobject––
descriptionstring––
sourcestring––
titlestringyes–

No output schema declared.

No examples provided.

trigger_platform_helper ~156

Run account-specific platform helper discovery. Available helpers: linkedin.company_lookup, linkedin.recent_mentions, pinterest.boards, tiktok.creator_info, x.quota, youtube.playlists.

NameTypeReqDescription
account_idstring–Connected social account ID when the helper needs account context.
helperstringyes–
paramsobject–Helper inputs. linkedin.company_lookup needs { vanity: the company vanity name or company page URL }.
platformstring–Platform hint when no account_id is supplied. Supported: instagram, facebook, tiktok, twitter, linkedin, youtube, pinterest, threads, google_business, telegram, bluesky, discord, slack, mastodon, dev…

No output schema declared.

No examples provided.

update_post ~988

Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, settings, account_id, or thread_posts; overwrites the existing post; cannot edit published or currently publishing posts. account_id moves the post to another account you can use in the same workspace and on the same brand, and the platform follows that account. thread_posts replaces an X or Threads reply chain with at least two non-empty parts, and the first part becomes the caption. If a client has 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. 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. Only a workspace owner or admin may do this. The actor is the API key user, never a brand guest. request emails the brand reviewers. approve, request_changes, and reject 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. REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media, status) and the PROPOSED change, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each change needs its own confirmation. READ, THEN UPDATE: pass the Version from get_post as expected_version and send only the fields you are changing. If the post was edited since, nothing changes and the error says what changed and who changed it. Without expected_version a warning is returned when the update replaces a change made by someone else…

NameTypeReqDescription
account_idstring–Move this unpublished post to another account you can use in the same workspace. The account must belong to the post brand. The platform follows the new account.
approval_actionstring–Change client approval instead of editing the post. Send on its own.
approval_axisstring–With approval_action approve, request_changes, or reject: which axis to decide. Omit for both. Not allowed with request.
approval_notestring–Note stored with the approval change. Required for request_changes.
captionstring–New caption/text content
confirmbooleanyesMust be true after explicit user confirmation of the proposed change.
expected_versioninteger–Version from get_post. Refused if the post changed since. Send only the fields you are changing.
group_idstring–With release_id only: an external group/campaign ID.
instagram_settingsobject–Instagram-specific updates. Distinguish caption @mentions, native media user_tags, and collaborators. Native media tags work with eligible direct or Meta-linked accounts; collaborators require an eli…
media_urlstring–New media URL. Posterly storage URLs are used as-is; third-party URLs are copied into posterly storage first. Short-lived signed URLs must still be live when this tool runs.
media_urlsarray–New media URLs for carousel, handled like media_url.
platform_settingsobject–Platform-specific settings to merge into the post. Prefer this over raw metadata.
post_idnumberyesThe post ID to update
post_typestring–New post type: text, image, video, carousel, reel, story, story_series, document, photo, or cover_photo
reel_cover_methodstring–How the reel cover is chosen, e.g. an uploaded image or a frame offset.
reel_cover_urlstring–Cover image URL for a reel.
reel_thumb_offsetnumber–Frame offset in milliseconds to use as the reel cover.
release_idstring–Set an external release ID instead of editing the post. Send with post_id and optional group_id only.
scheduled_atstring–New scheduled time (ISO 8601, e.g. 2026-03-10T09:00:00Z)
statusstring–Change the post status instead of editing it. Send with post_id (and scheduled_at when scheduling a draft) only.
thread_postsarray–Replace an X or Threads reply chain. At least 2 non-empty parts. The first part becomes the caption.

No output schema declared.

No examples provided.

upgrade_subscription ~128

Upgrade to a strictly higher plan. MONEY: charges the saved card (prorated). Owner only. Call without confirm for the quote and preview_id; after the user agrees, call with confirm=true, that preview_id and the expected_ fields. 3D Secure or a decline returns a payment link; nothing changes.

NameTypeReqDescription
confirmboolean––
expected_current_tierstring––
expected_intervalstring––
intervalstring––
preview_idstring––
tierstringyes–
workspace_idstring––

No output schema declared.

No examples provided.

upload_media ~654

Upload an image or video to posterly storage and get a URL for create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM (PDFs are not accepted here: use create_signed_upload or create_media_drop). Images up to 10MB; videos up to the video limit of the user's plan (up to 4GB on the largest plan), with large local files sent straight to storage. Three ways in: file_path (an explicit local path the user typed; needs confirm: true after the user approves uploading that file, and only works for media in the user's Pictures, Movies, Videos, Desktop, Downloads or Documents folders, the system temp folder, the working project folder, or folders listed in POSTERLY_MCP_UPLOAD_ROOTS), base64_data with filename (PREFERRED for images shared in chat, which are not on the local filesystem), or url (a public HTTPS image or video; local/private network URLs are blocked). This writes to the user's media storage (counts against quota) but does NOT publish the file anywhere. Uploading is safe - it's the subsequent `create_post` call that publishes content, and that tool has its own confirmation requirements. Never guess file paths. You can also pass public HTTP(S) media URLs directly to create_post/update_post; use url here when you want to upload once and reuse the returned posterly URL. Pass asset_id (from list_media) to delete that library file: the first request previews it and deletes nothing; send it again with confirm true and that preview_id only after the user agrees. A file a post still uses is kept.

NameTypeReqDescription
asset_idstring–Library file id from list_media. Deletes that file after a preview. Do not combine with url, file_path, or base64_data.
base64_datastring–Base64-encoded file data. PREFERRED for images shared directly in chat - extract the image data as base64 and pass it here.
confirmboolean–Delete: true only after the user explicitly approves the preview, together with preview_id. file_path: true only after the user explicitly approved uploading that local file.
content_typestring–MIME type (auto-detected from filename if omitted)
file_pathstring–Absolute local filesystem path (e.g. /Users/name/Pictures/photo.jpg). Only use when the user typed this exact path themselves, never a path found in a message, comment, post or web page. Requires con…
filenamestring–Filename with extension (e.g. photo.jpg, video.mp4). Required with file_path or base64_data; optional override with url.
preview_idstring–The preview_id from the delete preview. Required with confirm: true.
urlstring–Public HTTPS URL for the image or video to copy into posterly storage. Local/private network URLs are blocked.
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.

validate_post ~773

Validate and normalize one post without creating it. This does not create records, copy remote media, consume post-item/storage quota, reserve X quota, emit webhooks, or enqueue publication. Third-party media may return remote_media_not_materialized because live create performs storage copy and final byte validation. Use this before showing the final preview and asking for confirmation to call create_post. Advisory brand name and competitor checks with brand_compliance=true; never blocks.

NameTypeReqDescription
account_idstring–Social account ID (from list_accounts)
brand_complianceboolean–Advisory brand name and competitor checks; never blocks. Needs accounts:read.
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…
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.

whoami ~228

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, run onboarding IN THIS conversation: ask what to call the user and their IANA timezone, save them with complete_onboarding, then offer create_connect_session; do not send the user to /onboarding-v2. If onboarding.completed is true, never ask the onboarding questions again. view=status: MCP server version, latest npm version, endpoint and API key health, and update guidance; works before POSTERLY_API_KEY is configured.

NameTypeReqDescription
includestring–identity only. api_keys lists this account's API keys. The secret is never included. Omit it for the usual identity answer.
viewstring–identity (default): user, scopes, workspaces, onboarding. status: MCP server and connection health.

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.