postly.apply_ad
ChatGPTPublishes a reviewed ad campaign or change from postly.prepare_ad to the ad network. This can spend money. Call only after the user explicitly confirms that exact summary. Repeating the call returns the same operation instead of creating a duplicate. If the result needs attention, check the native ads account and postly.list_ad_operations before trying again. Only workspace Owners and Admins can create or change ads with AI agents. Requires ads.write.
postly.compare_ads
ChatGPTCompares 2 to 20 ads from postly.list_ads on one metric and explains which performed best and why. Pass each ad as its key and snapshot_id. Requires ads.read.
postly.craft_query
ChatGPTTurns a user-written Postly question into a safe, explicit plan of existing MCP tools and identifies any missing context. Use this first for free-form requests; then call the planned tools. It never runs raw database or SQL queries.
postly.create_post
ChatGPTCreates, queues, or schedules a Postly post for social or email/newsletter targets. Accepts content, target selections, schedules, platform settings, and client-provided media references for import in the same action. Returns the mutation result, platform readiness, blockers, and any required follow-up data.
postly.delete_post
ChatGPTPermanently removes only the post in Postly. Does not delete or recall live content on any social platform. For live removal, use Delete on Platforms in the dashboard where supported before deleting the post, or remove content directly on the platform. Requires a Postly post ID, not a provider post ID.
postly.get_account_analytics
ChatGPTFetches analytics for a connected Postly source such as a social account, page, profile, location, or channel. Returns metrics for the requested source and date range.
postly.get_ads_overview
ChatGPTFetches paid ads performance for one connected ad account: spend, impressions, clicks, conversions, CTR, CPC, CPM, cost per result, and ROAS, with a per-campaign breakdown. Use a period of 1 to 90 days, or all_time where the network supports it. Requires ads.read.
postly.get_campaign
ChatGPTFetches one Postly campaign, including its brief, objective, audience, schedule, status, and targets. Requires campaigns.read.
postly.get_campaign_report
ChatGPTFetches the performance report for a Postly campaign: planned, scheduled, published, and failed content plus engagement where available. Optionally limit it to a period of 1 to 366 days. Requires campaigns.read.
postly.get_channel_schema
ChatGPTReturns platform rules, character and media limits, required settings, safe defaults, and capture requirements for a supported Postly publishing channel. Use it before creating or scheduling content when the channel requirements are not already known.
postly.get_post
ChatGPTRetrieves sanitized details for a specific Postly post.
postly.get_post_analytics
ChatGPTFetches analytics for a published Postly post on a supported platform. Returns metrics for the requested post and analytics source.
postly.get_post_status
ChatGPTRetrieves the current publishing status and delivery counts for a specific Postly post.
postly.get_publishing_activity
ChatGPTReturns publishing activity for a requested date or time range, with actual published delivery counts separated from queued and processing posts.
postly.list_ad_accounts
ChatGPTLists the paid ads networks and ad accounts connected to a Postly workspace, such as Google Ads and Meta Ads, with each account ID, name, currency, and whether it is selected for reporting. Use provider:account_id as the account key for other ads tools. Requires ads.read.
postly.list_ad_campaigns
ChatGPTLists the native campaigns in a connected ad account with their status, budget, and dates. Pass next as cursor to load more. Requires ads.read.
postly.list_ad_operations
ChatGPTLists the 30 most recent ad creations and changes made through Postly for an ad account, with their status and result. Use it to check an operation from postly.apply_ad. Requires ads.read.
postly.list_ads
ChatGPTLists individual ads with their performance for a period, across all connected ad accounts or one account or network. Each ad includes key and snapshot_id for postly.compare_ads. Page with offset and next_offset, then next_account when several accounts are listed. Requires ads.read.
postly.list_analytics_sources
ChatGPTLists connected accounts, pages, profiles, locations, and channels that support analytics for one workspace or every accessible workspace. Returns sources grouped by workspace.
postly.list_campaign_posts
ChatGPTLists posts linked to a Postly campaign, newest first, with their status and targets. Use status published or failed to review outcomes. Requires campaigns.read and posts.read.
postly.list_campaigns
ChatGPTLists Postly campaigns in a workspace, newest first. Filter by status or by a name prefix or CAM- ID. Returns campaign IDs, names, objectives, status, dates, and targets. Requires campaigns.read.
postly.list_media
ChatGPTLists durable stored media, or recovers one upload by idempotency_key. Recovery distinguishes processing, completed, and unknown. Respect retry_after_seconds; use media only when storage confirms completion. Requires media.read.
postly.list_organizations
ChatGPTLists Postly organizations available to the authenticated connection. Returns organization identifiers and metadata for workspace selection.
postly.list_posts
ChatGPTLists recent Postly posts, optionally filtered by workspace and status. Returns sanitized post summaries for the authenticated connection.
postly.list_scheduled_posts
ChatGPTLists scheduled posts for a requested workspace, date, relative date window, or explicit time range. Returns the resolved window, counts, and matching post summaries.
postly.list_social_accounts
ChatGPTLists connected social channels and email/newsletter targets for a Postly workspace. Returns publishing target identifiers and metadata.
postly.list_workspaces
ChatGPTLists Postly workspaces available to the authenticated connection, optionally filtered by organization. Returns workspace identifiers and metadata.
postly.list_youtube_playlists
ChatGPTLists one page of the selected connected YouTube channel playlists. Follow next_page_token until absent. Use the returned IDs in optional YouTube settings.playlist_ids.
postly.prepare_ad
ChatGPTValidates a new ad campaign or a change to an existing one and saves it as a review that expires in 15 minutes. Nothing is published and no money is spent. Show the returned summary (action, budget, currency, countries, destination) to the user and get explicit confirmation before calling postly.apply_ad. Only workspace Owners and Admins can create or change ads with AI agents. Meta ad creation is pending Meta approval. Requires ads.write.
postly.resolve_publishing_targets
ChatGPTResolves publishing targets by platform, organization, workspace, or name before a post is created or scheduled. Returns matching channels and workspace context.
postly.retry_youtube_playlists
ChatGPTChecks playlist membership and retries definite failed additions for an already uploaded video. Never uploads a video or resends an uncertain addition. Requires explicit user authorization to retry.
postly.update_post
ChatGPTUpdates editable content, media, labels, social or email/newsletter targets, and schedules for an existing Postly post. Accepts client-provided media references for import in the same action and returns the mutation result, platform readiness, blockers, and any required follow-up data.
postly.upload_media
ChatGPTImports media into Postly storage independently of a post mutation. Accepts a client-provided file reference, URL, data URL, or base64 payload. Returns a durable Postly media object only when complete; a 202 processing result requires a later list_media check with its idempotency_key before creating or scheduling a post.
postly.upload_media_batch
ChatGPTUploads up to 50 files with bounded concurrency and a 30-second overall deadline. Returns completed, processing, failed, not_started, or unknown for every item with its stable idempotency key. Unknown uploads may still complete; reconcile stored media or retry with the same key.
postly.validate_post
ChatGPTChecks proposed post text, media, platform settings, schedules, and targets against Postly and platform-specific requirements. Returns validation status, errors, warnings, platform readiness, and applicable limits.