add_queue_slot
ChatGPTA weekly slot when the queue posts from this category, optionally only to some channels.
batch_create_posts
ChatGPTCreate up to 100 posts in one call, as drafts (asDraft:true) or scheduled. Each post is body + channelIds, full variants, or (drafts only) baseBody. Two or more posts form a post set (setId in the result). A post with no future time publishes now, which asks for confirmation first.
bulk_import_posts
ChatGPTImport up to 500 posts (for example rows from a spreadsheet), each with channels, a time, and media by library assetId or public URL. A row that is not a draft and whose time has passed publishes now, which asks for confirmation first.
caption_from_transcript
ChatGPTA post caption written from a video's transcript.
complete_media_upload
ChatGPTFinish an upload after the file's bytes were PUT to the uploadUrl from create_media_upload, and check whether a file is ready to attach. Images are usually ready at once. A video is probed first: while status is processing, call this again with the same mediaId every 10 seconds or so until it is ready or failed. Also use it to follow a file started with import_media_from_url. Calling it again never re-uploads or duplicates anything.
create_draft
ChatGPTSave a post as a DRAFT — it is never published or scheduled; the user reviews it in the composer first. Use when the user says 'draft a post about X', 'save this for later', or wants content prepared without going live. Optionally attach channels by ID (from list_channels). Per-network options go in channelSettings; call get_channel_options for a channel to see what it accepts. For a TikTok channel, ask the user who should be able to view the post and confirm their answer before you set tiktokPrivacy: TikTok allows no default, so the post cannot be scheduled without it. For YouTube, leaving ytPrivacy out publishes the video Public.
create_hashtag_group
ChatGPTSave a named set of up to 50 hashtags.
create_media_upload
ChatGPTStart uploading an image or video file so it can be attached to a post. Returns an uploadUrl: send the file's raw bytes to it with an HTTP PUT and the uploadHeaders, e.g. curl -X PUT -H "Content-Type: video/mp4" --data-binary @launch-teaser.mp4 "<uploadUrl>". Then call complete_media_upload with the mediaId, and attach the mediaId to a post with schedule_post. The URL works once, for this file only, and expires at expiresAt. If you cannot run an HTTP PUT yourself, use import_media_from_url with a public link to the file instead.
create_queue_category
ChatGPTA category of evergreen posts the queue draws from, optionally recycling them every recycleGapDays up to maxCycles times.
create_review_link
ChatGPTA link a client opens (no account needed) to review and comment on up to 50 posts. The url is in the result once; give it to the user.
create_template
ChatGPTSave reusable post text under a name, with optional tags.
delete_post
ChatGPTDelete a post by ID. Use when the user says 'delete my last post', 'cancel that post', or 'remove the scheduled post'.
delete_slack_alerts
ChatGPTStop sending alerts to Slack. set_slack_alerts turns them back on.
delete_webhook
ChatGPTStop sending events to this endpoint and delete it with its delivery history. Asks for confirmation first.
disconnect
ChatGPTDisconnect a social account from Postify. Posts scheduled to it are moved back to drafts. Asks for confirmation first.
disconnect_slack_app
ChatGPTUninstall the Postify app from the user's Slack workspace and stop its alerts. Asks for confirmation first. get_slack_install_link adds it back.
draft_inbox_reply
ChatGPTDRAFT a suggested reply to one inbox item (a mention, comment or DM) — and ONLY draft it. This tool cannot send, post, or publish anything: it returns text for the user to review and send themselves from the Inbox. Use when the user asks you to reply to / answer / respond to something in their inbox. Get the itemId from list_inbox_items first. Never tell the user the reply was sent — nothing you can call does that.
duplicate_post
ChatGPTCopy a post into a new draft.
execute_typescript
ChatGPTRun a short TypeScript program that orchestrates Postify MCP tools (found via search_tools) in an isolated sandbox. See the server instructions for the full contract.
export_analytics_csv
ChatGPTPer-post publishing results as CSV text (status, dates, delivery attempts and failures), optionally for one platform.
fields_from_transcript
ChatGPTTitle, caption, description and summary for a video post, written from its transcript.
generate_variants
ChatGPT1 to 10 alternative versions of a post, optionally in a tone.
generate_week
ChatGPTGenerate a whole content calendar — several posts at once, each tailored to the voice of every connected platform. Pass persist:true to save them as drafts in a new draft set (setId in the result); nothing is scheduled or published. The result's count is the number of posts generated: say exactly that number. Spends the workspace's AI credits.
get_analytics
ChatGPTGet workspace analytics (post counts, delivery rate, channel stats). Use when the user asks 'how did my posts perform', 'show analytics', or 'what's my delivery rate'.
get_analytics_insights
ChatGPTFollower growth per connected account and the best-performing posts over the last 7, 30 or 90 days. topPosts.supportedPlatforms names the networks whose engagement is measured; elsewhere a post's absence means unmeasured, not unpopular.
get_channel_options
ChatGPTList the per-post settings one connected channel accepts (who can view or reply, privacy, story or reel switches, tags, and so on) with every allowed value, plus the settings already saved on the channel. For a TikTok channel it also returns TikTok's own answer for that account: the audiences it allows, its nickname, and whether comments, Duet and Stitch are disabled. Call it before create_draft whenever the user wants a network-specific option, and pass the chosen values in create_draft's channelSettings. TikTok allows no default audience: ask the user who should be able to view the post, offer only the audiences returned here, and confirm their choice before you schedule anything. YouTube: omitting ytPrivacy publishes the video Public. Get the channelId from list_channels.
get_connect_links
ChatGPTGet the link the user opens to connect a social network to this Postify workspace. Use when the user wants to connect, add or link a social account, or a post needs a network that list_channels does not show. Give the user the url for the network they want and ask them to open it: they sign in and approve on the network's own page (method oauth_redirect), or fill in a short form inside Postify (method form_in_postify). Never ask for a password, app password, bot token or webhook URL in the chat. When they say they are done, call list_channels to confirm the channel is connected. A link with available false cannot be connected on this deployment yet, and networks in comingSoon cannot be connected at all.
get_hook_test
ChatGPTOne hook test's versions side by side with their views and engagement, and the leading version once every version has numbers. Reads the metrics Postify already stored.
get_media
ChatGPTOne media library item: URL, type, size, duration, cover frame and processing status.
get_post
ChatGPTFetch a single post by id, including its per-channel variants, schedule, and recurrence. Use to inspect one specific post before editing, rescheduling, or deleting it.
get_post_deliveries
ChatGPTPer-channel delivery attempts for a post: status, the platform's post URL, and the error if one failed.
get_post_set
ChatGPTA set of posts created together (a planned week or a bulk create) with each post and its status.
get_schedule
ChatGPTList the user's posts that fall inside a date window (from inclusive, to exclusive). A post's date is when it was published, else when it is scheduled, else when it was created, so the window can also hold drafts and published posts: check each post's status. Use for anything about a period: 'what's going out this week', 'is anything scheduled Thursday', 'how does next week look'. hasMore is true when the window holds more than was returned. To browse or filter by status with no period ('show my drafts'), use list_posts instead.
get_slack_alerts
ChatGPTThe Slack destination that receives Postify failure alerts, if any (the URL is masked).
get_slack_install_link
ChatGPTA single-use link that adds the Postify app to the user's Slack workspace, so failure alerts post there. Give the user the url: they approve on Slack's own page. The link works once and expires after 15 minutes.
get_transcript
ChatGPTA transcription's status and progress, and its text and timed segments once it is done.
get_transcription_usage
ChatGPTTranscription minutes used this period, the plan's limit and the longest clip it allows.
get_webhook_secret
ChatGPTThe secret the receiver uses to verify this webhook's signatures (and the previous one while a rotation overlaps).
import_media_from_url
ChatGPTCopy an image or video into Postify from a public link, so it can be attached to a post. Use this when you cannot upload a file yourself with create_media_upload. The link must be https:// and download the file directly. Postify checks the file's type and size, answers with a mediaId, and copies the file in the background: call complete_media_upload with that mediaId until it is ready, then attach it with schedule_post.
list_activity_log
ChatGPTWhat happened in this workspace and when, newest first: posts created, scheduled and published, channels changed, settings updated. Page back with before (the oldest createdAt you have) or poll with since.
list_channel_presets
ChatGPTSaved groups of channels to post to together.
list_channels
ChatGPTList the workspace's connected social channels (platform, handle, connection status, follower count). Use when the user asks 'what channels are connected', 'which accounts do I have', or before posting to confirm a platform is live. If no channel is connected, or the network the user wants is missing, call get_connect_links and give the user the link for that network; never ask for passwords or tokens in chat. A TikTok channel lists the audiences TikTok currently allows that account (tiktokAudienceOptions) and a tiktokAudienceHint: TikTok requires the user to choose the audience, so relay the options, let the user choose and confirm it, and only then set tiktokPrivacy (see get_channel_options and create_draft).
list_connections
ChatGPTThe social accounts connected to this workspace and whether each is healthy (the same data as list_channels).
list_failed_deliveries
ChatGPTDeliveries that used up their retries (the dead-letter queue), newest first.
list_granted_scopes
ChatGPTWhat this connection may do: its permission tiers and fine-grained scopes. Call request_scopes to ask for more.
list_hashtag_groups
ChatGPTSaved hashtag sets.
list_hook_tests
ChatGPTThis workspace's hook tests, newest first: each test's hooks, caption, when it was made, and how many of its trial reels published or failed.
list_posts
ChatGPTBrowse the user's most recently created posts (one page, newest first, not the full history), optionally filtered by status (draft, scheduled, published, failed). Use for 'show my drafts', 'list my failed posts', 'what have I posted lately'. It has no date window and does not look at when a post is scheduled, so for anything about a period ('today', 'this week', 'upcoming', 'next Thursday') use get_schedule instead.
list_queue_categories
ChatGPTContent categories that feed the posting queue, with their recycle settings and slot and pool counts.
list_queue_pool
ChatGPTEvergreen posts the queue can draw from, optionally for one category.
list_queue_slots
ChatGPTThe weekly time slots of a category.
list_review_links
ChatGPTClient review links for this workspace: label, posts, state and expiry.
list_templates
ChatGPTSaved post templates with their tags.
list_tiktok_drafts_needing_audience
ChatGPTDrafts whose TikTok version has no audience chosen yet, grouped by TikTok account, with a short label for each. TikTok allows no default audience, so these cannot be scheduled until the user picks one.
list_webhook_deliveries
ChatGPTThe last 50 deliveries to one webhook, with status codes and errors.
list_webhooks
ChatGPTOutgoing webhook endpoints and the events each receives.
list_workspaces
ChatGPTList the Postify workspaces this connection may act on (id, name, the user's role). Call it first when the user has more than one workspace, then pass the chosen workspace's id as workspaceId to the other tools. A connection granted a single workspace never needs to pass one.
optimize_length
ChatGPTTrim or expand a post to fit a platform's length limit.
plan_content
ChatGPTA day-by-day content plan for a theme over 1 to 14 days and the given platforms: topic, hook, format and a draft for each day.
post_from_url
ChatGPTA post written from a web page: the page is fetched, and no figure the page does not state is used.
preview_queue
ChatGPTWhat the queue will post over the next 1 to 168 hours.
publish_now
ChatGPTPUBLISH a post PUBLICLY and IMMEDIATELY to its connected social channels. This goes live right away and is visible to the world — only use when the user explicitly asks to publish now. For anything tentative, use create_draft or reschedule_post instead.
recycle_post
ChatGPTA fresh angle on an old post's text, ready to schedule again.
reject_post
ChatGPTSend a post waiting for approval back to its author, with an optional reason.
render_hook_variants
ChatGPTStart rendering one library video once per opening hook (2 to 5 hooks), each burned in. Returns a hookTestId and one pending video asset per hook; follow them with get_media until ready, then call create_hook_test.
replay_failed_webhook_deliveries
ChatGPTSend again every failed delivery to this webhook from the last 1h, 6h, 24h or 72h.
replay_webhook_delivery
ChatGPTSend one delivery again.
request_scopes
ChatGPTGet a one-time link the user opens to give this connection more permission tiers. Use after a SCOPE_MISSING refusal: its next.args.tiers says which.
reschedule_post
ChatGPTReschedule a post to a new date/time. Use when the user says 'move that to Tuesday', 'reschedule for 3pm', or 'push it back a day'.
research_hashtags
ChatGPTRelevant hashtags for a topic on one platform, each with a usage tip.
reverify
ChatGPTCheck a connected account is still authorized and refresh its sign-in. If the person must sign in again, the result has reconnectUrl: give it to the user to open.
search_docs
ChatGPTSearch Postify's public API documentation: REST endpoints/operations, error (problem) codes, webhook event types, and permission scopes. Returns each match with its canonical docs URL. Use when the user asks how to call the API, what an error code means, which webhook events exist, or what a scope grants.
search_media_library
ChatGPTSearch the user's own media library (the images they have already uploaded to Postify) and return the best matches, each with its id, URL and alt text. Keywords are matched against each file's name and description; an empty query returns the most recent uploads. Use it when the user refers to their own media: 'a photo from my library', 'the image I uploaded earlier', 'my logo', 'that product shot'. It only reads: nothing is attached to a post and nothing is changed. The applied field is true whenever the search ran; it does not mean an image was used anywhere.
search_tools
ChatGPTFind the Postify MCP tools this connection can reach, returned as TypeScript declarations to call from execute_typescript. See the server instructions for the full contract.
seed_demo_content
ChatGPTAdd three sample draft posts to an empty calendar so a new workspace has something to explore. Drafts never publish; it does nothing if the samples were already added.
set_default_channel_preset
ChatGPTMake a preset the composer's default, or unset it.
set_post_evergreen
ChatGPTAdd a post to the evergreen pool (in a category, until an optional expiry) or take it out.
set_tiktok_audience_on_drafts
ChatGPTAsk the user — never choose for them. Sets who can view the videos, and every other TikTok setting, on the TikTok version of up to 100 drafts for one TikTok account (list_tiktok_drafts_needing_audience lists them; get_channel_options lists the audiences the account allows). Pass the user's own answer for each field. The drafts stay drafts; skipped lists any that are not drafts on that account.
set_video_poster
ChatGPTUse the frame at atSec seconds as the video's cover image.
share_hook_test
ChatGPTSave the winning version of a hook test as a normal Instagram reel draft for the main grid. postId is a published version from get_hook_test. It never publishes: the person opens the draft and confirms.
suggest_channels
ChatGPTWhich of the workspace's connected channels suit this content, with the reason.
suggest_optimal_time
ChatGPTSuggest the best times to post for the target platforms, ranked from this workspace's own publish history and engagement (deterministic — no model call, no AI credits). Returns up to 3 suggestions per platform (platform, ISO datetime of the next occurrence, human-readable day/time, reason, 0-100 rank score) plus a basis: 'account_data' when the ranking is the workspace's own data, 'baseline' when it has too little history to personalize and a generic industry default was served instead. Report the basis rather than presenting a baseline as personalized. Changes nothing — pair with reschedule_post or create_draft to act on a suggestion.
test_slack_alerts
ChatGPTSend a test alert to the Slack destination now.
test_webhook
ChatGPTSend a sample event to the endpoint now.
train_brand_voice
ChatGPTLearn a brand voice from sample posts (action train), rewrite text in a voice (apply), or describe how well a text matches one (analyze). set_brand_voice saves the result.
transcribe_media
ChatGPTStart transcribing (or translating to English) a video or audio file from the media library. Poll get_transcript with the returned id.
update_channel_settings
ChatGPTChange a connected channel's defaults, merged into what is already set: for example the Pinterest board new pins go to (boardId). Only the keys passed change.
update_queue_category
ChatGPTRename a category or change its colour or recycle settings.
update_queue_slot
ChatGPTMove a slot, change its channels, or pause it.
writing_prompts
ChatGPTFresh post ideas for a niche on a platform.
create_draft
Claudedelete_post
Claudeexecute_typescript
Claudeget_analytics
Claudeget_post
Claudeget_schedule
Claudelist_channels
Claudelist_inbox_items
Claudelist_posts
Claudepublish_now
Claudereschedule_post
Claudesearch_docs
Claudesearch_media_library
Claudesearch_tools
Claudesuggest_optimal_time
Claude