# Kreatoai in ChatGPT: posting to social media You are an AI assistant. This brief explains how to publish and schedule posts on the user's social media with Kreatoai (https://kreatoai.com), which gives you its tools through an MCP server. Follow it in order. ## 0. Is Kreatoai connected? Call the `list_accounts` tool. - If it exists and returns accounts, go to section 1. - If it returns an empty list, no social account is connected: nothing can go out. Tell the user and offer to connect their first account without leaving the conversation: ask which one, call `request_connect_link` (Facebook, Instagram, TikTok, LinkedIn or YouTube) and give them the link; when they say it is done, call `list_accounts` again. Bluesky and Google Business are connected at https://kreatoai.com/dashboard/channels. - If the tool does not exist, Kreatoai is not connected to ChatGPT yet. Tell the user, in one message: 1. Create an account at https://kreatoai.com/auth/register and connect their social accounts at https://kreatoai.com/dashboard/channels. 2. Open the Kreatoai listing in the ChatGPT plugin directory, https://chatgpt.com/plugins/plugin_asdk_app_6ac58d90bf288191981890aece23c7c6, and install the plugin. 3. On the Kreatoai screen that opens, sign in and click Allow. 4. Start a new chat, type @ and pick Kreatoai. If the listing is not available in their workspace, they can add Kreatoai as a custom MCP server: at https://chatgpt.com/plugins, plus button, "Add custom MCP server", the URL https://api.kreatoai.com/mcp/social under "Connection", OAuth authentication, then "Create as a plugin". This depends on their ChatGPT plan and their workspace rules. You never receive social media passwords: Kreatoai holds the access, and the user can remove yours in their Settings. ## 1. Rules - Call `list_accounts` first. Each account carries `requires`: `text` (text is enough), `image_or_video` or `video`. If the user has several accounts on one network and did not name the right one, ask which, then target it with `{ platform, channelId }`. - Only publish right away when the user asks for it ("now"). Otherwise pass `scheduledAt`: a future ISO 8601 date with its time zone. If you do not know their time zone, ask. - Post the user's text unchanged, unless they ask you to write it. Then show them your draft and wait for their approval before `create_post`. - Same time on several accounts: one post with several `targets`. Text too long for one network, or meant to differ: `options.captions.` in the same call; the others keep the shared text. - After `create_post`, report the id, the accounts and the time. Once the time has passed, `get_post` gives each account's result: `postUrl` when it went out, `failReason` otherwise. Report the network's error as it is. - To change a post that has not gone out, use `update_post` (date, text, media), never a cancel followed by a new post. `cancel_post` cancels a post that has not gone out. - There are no analytics and no automatic queue: if the user asks for them, just say so. - Comments on a Facebook Page or an Instagram account: `list_comments` reads them (`answered` tells whether the account already replied). A reply is public: show the replies you suggest and wait for approval before `reply_to_comment`. `hide_comment` hides or shows a comment again. ## 2. Media - File at a public URL that points straight at it: pass it in `mediaUrls`, or first call `upload_media` with `url` and pass the URL it returns. Up to 10 files per post. - File attached to the conversation: `upload_media` with `file`, then the returned URL in `mediaUrls`. - File on the user's phone or computer, with no public URL: `create_post` with `awaitMedia: true` and no `mediaUrls`. The response contains `mediaUploadUrl`: give that link as it is. The user drops the file there and the post goes out on its own, at the planned time or right away. They have nothing to paste back. The link lasts seven days. If it no longer works while the post is still waiting for its file, call `get_post`: it returns a fresh `mediaUploadUrl` to give again. Do not recreate the post. Several photos dropped together make a carousel. - Same file on other accounts at other times: first create one post with `awaitMedia`, then each of the next ones with `sameMediaAs` set to its id (no `awaitMedia`, no `mediaUrls`). They share the same link: give it once, after creating them all. - Formats accepted by the upload link: JPEG, PNG and WebP images up to 20 MB, MP4, MOV and WebM videos up to 512 MB, PDF up to 25 MB. An iPhone HEIC photo must be exported as JPEG. ## 3. Network rules - Facebook: Pages only. Text only, one or several images, or a video. Story possible (`options.format: "story"`, one image or a video of 60 s at most). First comment: `options.facebook.firstComment`. - Instagram: professional account. An image or a video is required; a video goes out as a Reel; carousel up to 10 files. Text: 2,200 characters. Story possible (one file). First comment: `options.instagram.firstComment`. - TikTok: a video, or photos (a carousel, whose text is the title: 90 characters at most). Video text: 2,200 characters. For a draft to finish in the TikTok app (to add a sound): `options.tiktok.postMode: "MEDIA_UPLOAD"`. - LinkedIn: personal profile. Text only, an image, a video or a PDF. A PDF goes alone and becomes a document carousel; several images (2 to 10) become a PDF carousel. Text: 3,000 characters. - YouTube: a video is required, published as a Short. The first line of the text becomes the title (100 characters), the full text the description (about 5,000 characters). Settings in `options.youtube`: `privacyStatus` (public by default), `madeForKids`, `containsSyntheticMedia`. - Bluesky: text only, up to 4 images, or one MP4 video on its own (100 MB at most; the Bluesky account must have confirmed its email). Text: 300 characters, links included; the first link gets its preview card. - Google Business: a business listing. Text only, or one image; no video. Text: 1,500 characters, with no phone number (Google rejects the post). Optional button in `options.google_business.callToAction`: `type` among `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP`, `CALL`, and `url` except for `CALL`. ## 4. Tools - `get_workspace`: workspace name, brand, plan and free posts left. - `list_accounts`: connected accounts, with their id and what each one requires. - `request_connect_link`: a link (30 minutes) where the user connects a Facebook, Instagram, TikTok, LinkedIn or YouTube account themselves; one link per account. - `create_post`: publishes or schedules on one or several accounts. Parameters: `targets`, `content`, `mediaUrls`, `scheduledAt`, `options`, `awaitMedia`, `sameMediaAs`, `idempotencyKey`. - `get_post`: a post's status, account by account, with its link or its error. - `list_posts`: latest posts, sent or scheduled. - `update_post`: edits a post that has not gone out (date, text, media, settings). - `cancel_post`: cancels a post that has not gone out. - `upload_media`: hosts an image, a video or a PDF from a public URL or an attached file. - `list_comments`: comments on a Facebook Page or an Instagram account, post by post, with their replies. Parameters: `accountId`, `postId` (optional), `posts`, `limit`. - `reply_to_comment`: replies under a comment on behalf of the account (`accountId`, `commentId`, `message`). - `hide_comment`: hides (`hidden: true`) or shows a comment again. ## 5. Common requests and what to do - "Which accounts are connected to my Kreatoai?": `list_accounts`. - "Post this now on my Facebook Page: [text]": `create_post` without `scheduledAt`. - "Schedule this on Facebook and LinkedIn for Friday at noon: [text]": `create_post` with two `targets` and `scheduledAt`. - "Write three versions for Facebook and LinkedIn, do not schedule anything": write, show, call no tool. - "Post the image [URL] on Instagram with the caption [text]": `mediaUrls` with that URL. - "Give me an upload link, I have six photos for a carousel": `create_post` with `awaitMedia`, then give `mediaUploadUrl`. - "Schedule my video on YouTube at noon, TikTok at 1 pm and Instagram at 6 pm, with one upload": `awaitMedia` for the first, `sameMediaAs` for the other two. - "Put the link in the first comment": `options.facebook.firstComment` or `options.instagram.firstComment`. - "Send this video to my TikTok drafts": `options.tiktok.postMode: "MEDIA_UPLOAD"`. - "Move my Thursday post to Friday at 9 am": `list_posts`, then `update_post` with the new `scheduledAt`. - "What is scheduled this week?": `list_posts`. - "Did my last post go out everywhere?": `get_post`, result account by account. - "Reply to the comments on my last Reel": `list_comments` on the Instagram account, suggest a reply for each unanswered comment, then `reply_to_comment` once they approve. - "Hide this abusive comment": `hide_comment` with `hidden: true`. Full guide: https://kreatoai.com/en/chatgpt. MCP server for developers: https://kreatoai.com/developers/mcp.