cancel_post
ChatGPTCancel a scheduled post. Only scheduled posts can be cancelled. Cancelled posts cannot be rescheduled; a new post is needed instead.
create_post
ChatGPTCreate and schedule a new social media post for one social account. socialAccountId comes from list_social_accounts. mediaIds come from: upload_attached_file (files attached in ChatGPT), open_upload_box (user uploads files from their device, best for local files and videos), create_upload_url + finish_upload (if you can run curl), upload_media_from_url (public links) or list_media. Pass mediaIds in carousel order. PLATFORM NOTES: - Instagram: Requires at least 1 image or video - YouTube: Requires 1 video and youtubeParams.title - Pinterest: Requires pinterestParams.boardId (board IDs come from list_pinterest_boards) - TikTok: Requires at least 1 image or video - X/Twitter: Max 280 chars, max 4 media - Google Business: topicType STANDARD (default), EVENT, or OFFER. EVENT/OFFER require eventTitle + startDate + endDate. scheduledAt must be a future ISO 8601 datetime.
create_upload_url
ChatGPTGet a one-time URL to upload a file from the user's device directly, up to 300MB (images, videos, PDFs). Steps: 1) call this, 2) POST the file to uploadUrl as multipart/form-data: every entry of fields, then the file as "file" (last), (e.g. curl -F "key=<fields.key>" -F "Content-Type=<fields.Content-Type>" ... one -F per field ... -F "file=@photo.jpg" "<uploadUrl>"), 3) call finish_upload with the uploadId to get the media ID. The URL expires after 15 minutes. Supports: JPEG, PNG, GIF, WebP, MP4, MOV, PDF.
delete_media
ChatGPTPermanently delete an uploaded media file by its ID.
delete_post
ChatGPTPermanently delete a post. This action cannot be undone.
edit_post
ChatGPTUpdate a scheduled post. Only scheduled posts can be edited. Only include the fields you want to change.
finish_upload
ChatGPTAfter the file was uploaded to the URL from create_upload_url, call this with its uploadId. Returns the media ID to pass to create_post. For a carousel, finish each file and pass the IDs in carousel order.
get_account_analytics
ChatGPTGet analytics data for a specific social account. Includes account-level metrics (followers, following) and post-level metrics (views, likes, comments, engagement rate). Returns platform-specific data format.
get_analytics_trends
ChatGPTGet historical trend data for a social account: follower growth and engagement metrics over time. Returns daily snapshots for the specified number of days.
get_brand_overview
ChatGPTGet an aggregated analytics overview for a workspace. Includes all connected social accounts with 7-day metrics (views, engagement, follower changes), top 10 posts, and daily view/engagement trends over the same window.
get_current_user
ChatGPTGet the authenticated user's profile. Use this to verify the connection is working or to get user context.
get_post
ChatGPTGet detailed info about a specific post including content, status, media, publishing logs, and its latest performance metrics (views, likes, comments, shares, engagement rate). The metrics field is null when the post has not been published yet, or when no analytics have been collected for it. A null metric means no data was collected, which is different from zero.
get_social_account
ChatGPTGet details about a specific connected social account.
get_workspace
ChatGPTGet detailed info about a specific workspace including its connected social accounts.
list_conversation_messages
ChatGPTRead the messages in a direct message conversation. Page 1 holds the most recent messages, returned oldest to newest so they read like a chat. fromBusiness is true for messages the business sent. type is TEXT, IMAGE, VIDEO, AUDIO, FILE, STICKER, STORY_REPLY, STORY_MENTION or UNKNOWN; media is in attachments. Use the id returned from list_conversations as conversationId.
list_conversations
ChatGPTList private direct message conversations from Instagram and Facebook Messenger for a workspace, newest first. Each conversation includes the customer, the last message preview, whether it needs a reply, who it is assigned to, and replyWindow (canReply, expiresAt): Instagram and Facebook only allow replies within 24 hours of the customer's last message. These are private messages: only summarize or quote them for the user who asked. Use needsReply to find conversations waiting on an answer, then list_conversation_messages to read one.
list_media
ChatGPTList media that can be attached to posts. With workspaceId, returns that workspace's media library (the files uploaded in the PostPlanify dashboard) plus files uploaded through the API/MCP. Without workspaceId, returns only files uploaded through the API/MCP. Both kinds of media ids work in create_post. Each item has a "source" of "library" or "upload".
list_pinterest_boards
ChatGPTList Pinterest boards for a Pinterest account. Pinterest posts need one of these board IDs as pinterestParams.boardId.
list_posts
ChatGPTList posts with filters. Returns paginated results. workspaceId is required. Statuses: SCHEDULED, PUBLISHED, CANCELLED, RESCHEDULED. Set includeMetrics to true to attach each post's latest performance figures (views, likes, comments, shares, engagement rate). Use this to compare how posts performed instead of fetching them one at a time. A null metrics field means no analytics have been collected for that post, which is different from zero.
list_social_accounts
ChatGPTList all connected social media accounts across all workspaces. Returns account IDs, platform types (INSTAGRAM, X, FACEBOOK, LINKEDIN, TIKTOK, YOUTUBE, THREADS, BLUESKY, PINTEREST), and account names. Use the returned account IDs when creating posts.
list_workspaces
ChatGPTList all workspaces (brands) the user has access to. Use this to find workspace IDs needed for other operations like listing posts or social accounts.
mark_conversation_read
ChatGPTMark a direct message conversation as read in PostPlanify, so it no longer shows as unread for the team. This only changes PostPlanify; the customer does not see it.
open_upload_box
ChatGPTShow an upload box in the chat so the user can pick files from their own device (images, videos or PDFs, up to 300MB each, up to 20 files) and put them in carousel order. Use this when the user wants to post files from their computer or phone that are not at a public URL. If the user already attached the files in this chat, do not ask them to upload again: use upload_attached_file instead (ChatGPT). Use the upload box only when the files are not in the chat yet, or for videos and files too large to attach. After they upload, the user sends a message with the media IDs in order: pass them to create_post in that order. Do not call other upload tools for those files.
reply_to_conversation
ChatGPTSend a direct message reply in an Instagram or Facebook conversation. The message is delivered to the customer immediately and cannot be unsent, so confirm the wording with the user first. Text only. Length limits: Instagram 1000, Facebook 2000 characters. Only works while replyWindow.canReply is true (within 24 hours of the customer's last message).
upload_attached_file
ChatGPTChatGPT only: upload an image or video the user attached in ChatGPT. Other clients: use open_upload_box (user picks files from their device), create_upload_url (if you can run curl) or upload_media_from_url instead. Call it once per file; for a carousel, upload each file and pass the returned media IDs to create_post in carousel order. For public links use upload_media_from_url. Supports: JPEG, PNG, GIF, WebP, MP4, MOV, PDF. Returns a media ID that can be attached to a post.
upload_media_from_base64
ChatGPTLast resort for small files: upload a file sent as a base64-encoded string. Prefer, in order: upload_attached_file for files the user attached in this chat (ChatGPT); create_upload_url + finish_upload if you can run shell commands (curl); open_upload_box to let the user pick files from their device; upload_media_from_url for public links. The file is stored exactly as received, without compression or resizing. Max size: 7MB. Supports: JPEG, PNG, GIF, WebP, MP4, MOV, PDF. Returns a media ID that can be attached to a post.
upload_media_from_url
ChatGPTDownload a file from a public URL and upload it to PostPlanify. This is the primary way to add images and videos for use in posts. Supports: JPEG, PNG, GIF, WebP, MP4, MOV, PDF. After uploading, use the returned media ID when creating posts. Workflow: 1) Upload media, 2) Note the returned media ID, 3) Create a post with the media IDs.
cancel_post
Claudecreate_post
Claudedelete_media
Claudedelete_post
Claudeedit_post
Claudeget_account_analytics
Claudeget_analytics_trends
Claudeget_brand_overview
Claudeget_current_user
Claudeget_post
Claudeget_social_account
Claudeget_workspace
Claudelist_media
Claudelist_pinterest_boards
Claudelist_posts
Claudelist_social_accounts
Claudelist_workspaces
Claudeupload_media_from_base64
Claudeupload_media_from_url
Claude