@omnisocials/mcp-server 1.39.0 → 1.46.0

package/build/tools/posts.js

@@ -1,5 +1,36 @@
 import { z } from "zod";
 import { formatDateTime, truncate, capitalize, formatNumber, metricRows } from "../client.js";
+// Comment-to-DM automations bound to the post (Instagram or Facebook must be
+// a channel; `platforms` picks which). The shape of create_automation without
+// the post: always this post, comment trigger. Needs the opt-in
+// automations:write scope on the API key.
+const COMMENT_DM_AUTOMATION = z.object({
+    platforms: z.array(z.enum(["instagram", "facebook"])).min(1).optional().describe("The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook."),
+    trigger: z.object({
+        keywords: z.array(z.string()).max(20).optional().describe("Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'."),
+        match: z.enum(["word", "contains", "any"]).optional().describe("word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first)."),
+    }).optional(),
+    actions: z.object({
+        dm: z.object({ text: z.string().max(1000).describe("The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.") }),
+        public_reply: z.object({
+            enabled: z.boolean().optional(),
+            variations: z.array(z.string().max(300)).max(10).optional().describe("Public replies posted under the comment, one picked at random per comment."),
+        }).optional(),
+    }),
+    limits: z.object({
+        max_sends: z.number().int().positive().nullable().optional().describe("Stop after this many DMs."),
+        stop_at: z.string().nullable().optional().describe("Stop at this time (ISO 8601)."),
+    }).optional(),
+}).describe("Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity. Needs the opt-in automations:write scope on the API key.");
+const commentDmLine = (p) => {
+    const a = p.comment_dm_automation;
+    if (!a)
+        return "";
+    const keywords = a.trigger.match === "any" ? "any comment" : a.trigger.keywords.map((k) => `"${k}"`).join(", ");
+    const list = a.automations?.length ? a.automations : [{ id: a.id, platform: a.platform }];
+    const ids = list.map((x) => `\`${x.id}\` (${x.platform === "facebook" ? "Facebook Page" : "Instagram"})`).join(", ");
+    return `| **Comment-to-DM** | ${a.status}, keywords ${keywords}, ${list.length > 1 ? "automations" : "automation"} ${ids} |\n`;
+};
 // Shared media entry schemas — every media list (flat arrays, per-platform
 // records, and x/bluesky/mastodon/threads thread parts) accepts either a plain string
 // or an object carrying `alt`: an accessibility description (alt text, max
@@ -81,6 +112,11 @@ const VIDEO_COVER_ENTRY = z.object({
     thumb_offset: z.number().int().min(0).optional().describe("Milliseconds into the video (type 'frame'). 3000 = 0:03."),
     cover_url: z.string().optional().describe("Public image URL, JPEG or PNG (type 'custom')."),
 });
+// Image fit per channel (shared/post-validation imageFit.js on the backend).
+const MEDIA_FIT_OPTIONS = z
+    .record(z.string(), z.enum(["auto", "crop", "keep"]))
+    .optional()
+    .describe("Image fit per channel, for feed images (type 'post') whose ratio is outside what a channel shows uncropped: { instagram: 'auto' | 'crop' | 'keep', pinterest: ... }. 'auto' (the default when omitted) takes the channel's rule: Instagram crops a tall (9:16) or wide image to 4:5 / 1.91:1 around the subject (Instagram cuts it to that window anyway, and Meta cannot boost a feed post outside it); Pinterest keeps a Pin taller than 2:3 and only reports it. 'crop' / 'keep' force it for that channel. Every decision comes back in the response `warnings` with code `image_fit` (relay it). The crop is a separate file for that channel only; 'default' and the other channels keep the original. On update_post, media_fit alone (no media) re-decides the stored images: 'keep' gives the original back, 'crop' crops an image that was kept.");
 const VIDEO_COVER_OPTIONS = VIDEO_COVER_ENTRY.extend({
     overrides: z
         .record(z.string(), VIDEO_COVER_ENTRY.nullable())
@@ -152,6 +188,103 @@ const LINKEDIN_POLL_OPTIONS = z
     .nullable()
     .optional()
     .describe("Non-sponsored LinkedIn poll(s) — independent per channel, keyed by `linkedin` (personal profile) / `linkedin_page` (company page). A poll is mutually exclusive with media and a link share on that channel's post — a poll takes priority over both at publish time. Still requires `content.linkedin` (or `content.default`) as that channel's caption; the poll itself only carries the question/options/duration. On update_post, set a channel's key to `null` to clear that channel's poll and revert it to a normal post — send the full desired state for both channels, since the whole object replaces wholesale.");
+// Polls on X, Threads and Mastodon (2026-10-12). One shape, nested under
+// the channel's options as `poll`; the post text is the question. A channel
+// with a poll carries no media (the API refuses the pair). On update_post,
+// `null` removes the poll; omitted leaves it.
+const X_POLL_OPTIONS = z
+    .object({
+    options: z.array(z.string().min(1).max(25)).min(2).max(4).describe("2 to 4 answer options of up to 25 characters, all different."),
+    duration_minutes: z.number().int().min(5).max(10080).optional().describe("How long the poll runs, in minutes (5 to 10080 = 7 days). Default 1440 (one day)."),
+})
+    .nullable()
+    .optional()
+    .describe("Attach a poll to the tweet; the tweet text is the question. No media on X together with a poll. On a thread the poll goes on the first tweet. On update_post, null removes it.");
+const THREADS_POLL_OPTIONS = z
+    .object({
+    options: z.array(z.string().min(1).max(25)).min(2).max(4).describe("2 to 4 answer options of 1 to 25 characters, all different."),
+})
+    .nullable()
+    .optional()
+    .describe("Attach a poll to the post; the post text is the question. Threads closes the poll 24 hours after it is published (no duration). Polls go on text-only posts: no media on Threads together with a poll. On a thread the poll goes on the first post. On update_post, null removes it.");
+const MASTODON_POLL_OPTIONS = z
+    .object({
+    options: z.array(z.string().min(1)).min(2).describe("The answer options, all different; count and length within the instance's limits (Mastodon's defaults: 4 options of 50 characters)."),
+    expires_in: z.number().int().min(300).optional().describe("How long the poll runs, in seconds, within the instance's range (Mastodon's defaults: 5 minutes to 1 month). Default 86400 (one day)."),
+    multiple: z.boolean().optional().describe("Allow several answers per person."),
+    hide_totals: z.boolean().optional().describe("Hide the vote counts until the poll ends."),
+})
+    .nullable()
+    .optional()
+    .describe("Attach a poll to the status; the status text is the question. No media on Mastodon together with a poll. On a thread the poll goes on the first status. On update_post, null removes it.");
+// Telegram (2026-10-17): the connected channel or group, posted by the
+// OmniSocials bot. One schema for create and update; on update_post every
+// key merges into the stored options and null removes it. Same shape as the
+// hosted server (backend/routes/api/v1/mcp.js, telegramSchema).
+const TELEGRAM_OPTIONS = z
+    .object({
+    silent: z.boolean().nullable().optional().describe("Send without a notification sound."),
+    link_preview: z.boolean().nullable().optional().describe("false hides the link preview of a text-only post (shown by default)."),
+    pin: z.boolean().nullable().optional().describe("Pin the post in the chat after it is sent. Needs the bot's Edit messages right in a channel (Pin messages in a group); without it the post is sent unpinned and get_post shows pin_error."),
+    protect_content: z.boolean().nullable().optional().describe("Stop forwarding and saving of the post in Telegram apps."),
+    spoiler: z.boolean().nullable().optional().describe("Blur the photos and videos until someone taps them."),
+    caption_above_media: z.boolean().nullable().optional().describe("Show the text above the media instead of below."),
+    buttons: z
+        .array(z.object({
+        text: z.string().max(64).describe("Button label (1 to 64 chars)."),
+        url: z.string().describe("Link the button opens: https://, http:// or tg://."),
+    }))
+        .max(3)
+        .nullable()
+        .optional()
+        .describe("Up to 3 link buttons under the post, one per row. Not on an album (2+ media) or a poll."),
+    poll: z
+        .object({
+        options: z.array(z.string().min(1).max(100)).min(2).max(12).describe("2 to 12 answer options of up to 100 chars, all different."),
+        open_period: z.number().int().min(5).max(2628000).optional().describe("Seconds the poll stays open (5 s to about 30 days). Omit to keep it open."),
+        multiple: z.boolean().optional().describe("Allow several answers per person."),
+    })
+        .nullable()
+        .optional()
+        .describe("A native Telegram poll. The post text is the question (max 300 chars). No media with a poll. On update_post, null removes it."),
+    first_comment: z.string().max(4096).optional().describe("A reply the bot sends under the post right after it is published (max 4,096 chars). On update_post pass an empty string to clear it."),
+})
+    .nullable()
+    .optional()
+    .describe("Telegram options. Text up to 4,096 chars; with media, text over 1,024 chars is sent as a reply under the media. Up to 10 photos and videos per album (no GIF in an album), files up to 50 MB, no Stories. A Reel is sent as a video message.");
+// Discord (2026-10-22): the connected Discord channel, posted through its
+// webhook. One schema for create and update; on update_post every key merges
+// into the stored options and null removes it. Same shape as the hosted
+// server (backend/routes/api/v1/mcp.js, discordSchema).
+const DISCORD_OPTIONS = z
+    .object({
+    silent: z.boolean().nullable().optional().describe("Send without a push or desktop notification (Discord's @silent)."),
+    link_preview: z.boolean().nullable().optional().describe("false hides the previews of the links in the text (shown by default)."),
+    allow_mentions: z.boolean().nullable().optional().describe("true lets @everyone, @here, role and user mentions in the text notify people. Off by default: mentions show as text and ping nobody. Only turn it on when the user asks to ping."),
+    spoiler: z.boolean().nullable().optional().describe("Blur every image and video until someone clicks it."),
+    thread_name: z.string().max(100).nullable().optional().describe("The post title in a forum or media channel, where Discord requires one (1 to 100 chars). Only for those channels: a text channel takes none, so the post goes out there without it (warning thread_name_ignored). On update_post, null removes it."),
+    buttons: z
+        .array(z.object({
+        text: z.string().max(80).describe("Button label (1 to 80 chars)."),
+        url: z.string().describe("Link the button opens: https:// or http://."),
+    }))
+        .max(5)
+        .nullable()
+        .optional()
+        .describe("Up to 5 link buttons in one row under the message. Not with a poll."),
+    poll: z
+        .object({
+        options: z.array(z.string().min(1).max(55)).min(2).max(10).describe("2 to 10 answer options of up to 55 chars, all different."),
+        duration_hours: z.number().int().min(1).max(768).optional().describe("Hours the poll stays open (1 to 768, 32 days). Default 24."),
+        multiple: z.boolean().optional().describe("Allow several answers per person."),
+    })
+        .nullable()
+        .optional()
+        .describe("A native Discord poll. The post text is the question (max 300 chars). No media and no buttons with a poll. On update_post, null removes it."),
+})
+    .nullable()
+    .optional()
+    .describe("Discord options. The post goes to the connected Discord channel through its webhook and shows the webhook's name and picture. Text up to 2,000 chars. Up to 10 images, GIFs and videos per message (they may mix); a video or GIF over Discord's 20 MB file limit is sent as a link in the text. No Stories; a Reel is sent as one video message.");
 // Per-platform option schemas shared verbatim by create_post,
 // create_and_publish_post and update_post (they were byte-identical in all
 // three). Platform blocks that genuinely differ per tool (instagram, youtube,
@@ -204,8 +337,8 @@ const X_THREAD_PART = z.object({
 });
 const BLUESKY_THREAD_PART = z.object({
     text: z.string().describe("Post text (≤ 300 characters, counted as graphemes — one emoji counts as 1)."),
-    media_ids: z.array(mediaIdEntry).max(4).optional().describe("Per-post media as Library IDs from upload_media. A part is one video OR up to 4 images. Each entry is a plain ID string or { id, alt } to attach alt text (set as the image's embed alt on Bluesky)."),
-    media_urls: z.array(mediaUrlEntry).max(4).optional().describe("Per-post media as external URLs. A part is one video OR up to 4 images. Each entry is a plain URL string or { url, alt } to attach alt text (set as the image's embed alt on Bluesky)."),
+    media_ids: z.array(mediaIdEntry).max(10).optional().describe("Per-post media as Library IDs from upload_media. A part is one video OR up to 10 images (5 or more post as a gallery). Each entry is a plain ID string or { id, alt } to attach alt text (set as the image's embed alt on Bluesky)."),
+    media_urls: z.array(mediaUrlEntry).max(10).optional().describe("Per-post media as external URLs. A part is one video OR up to 10 images (5 or more post as a gallery). Each entry is a plain URL string or { url, alt } to attach alt text (set as the image's embed alt on Bluesky)."),
 });
 const MASTODON_THREAD_PART = z.object({
     text: z.string().describe("Status text (≤ 500 characters by default; some instances allow more)."),
@@ -231,7 +364,7 @@ const GOOGLE_BUSINESS_OPTIONS = z.object({
             endDate: z.object({ year: z.number(), month: z.number(), day: z.number() }).optional(),
             endTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
         }).optional().describe("Google's split date+time shape. startDate required; end (if present) must be ≥ start."),
-    }).optional().describe("Required when topic_type is EVENT."),
+    }).optional().describe("Required when topic_type is EVENT or OFFER. For an OFFER, the title is the offer's name and the schedule its validity period (Google rejects an offer without it)."),
     offer: z.object({
         couponCode: z.string().max(58).optional(),
         redeemOnlineUrl: z.string().optional().describe("Must be https://. http URLs are rejected."),
@@ -285,15 +418,32 @@ function postAppUrl(p) {
     // client URL, so it's correct on staging/production. Fall back to a
     // hardcoded production URL for older API responses that don't return it.
     if (typeof p?.app_url === "string" && p.app_url)
-        return p.app_url;
+        return withRef(p.app_url);
     const id = p?.id;
     if (!id)
         return null;
     const status = String(p?.status || "").toLowerCase();
     const isEditable = status === "draft" || status === "scheduled" || status === "" || status === "failed";
-    return isEditable
+    return withRef(isEditable
         ? `https://app.omnisocials.com/create-post/${id}`
-        : `https://app.omnisocials.com/posts/${id}`;
+        : `https://app.omnisocials.com/posts/${id}`);
+}
+// `?ref=mcp` on every app link from an agent's answer, so the visits can be
+// counted (the app ignores the parameter). Same rule as the hosted server.
+function withRef(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.searchParams.set("ref", "mcp");
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+// The "Open in OmniSocials" table row, or nothing without an id.
+function appLinkRow(p) {
+    const url = postAppUrl(p);
+    return url ? `| **Open in OmniSocials** | ${url} |\n` : "";
 }
 export function registerPostTools(server, getClient) {
     server.tool("list_posts", "List all posts in the workspace. Optionally filter by status. The content column shows a preview of the default caption; if a post has per-platform overrides (e.g. a custom X version), the preview is suffixed with *(per-platform)* — call `get_post` to see every variant.", {
@@ -531,6 +681,78 @@ export function registerPostTools(server, getClient) {
             }
             md += `\n_Duration: ${poll.duration}_\n`;
         }
+        // Polls on X, Threads and Mastodon: the post text is the question.
+        for (const channel of ["x", "threads", "mastodon"]) {
+            const poll = p[channel]?.poll;
+            if (!poll || !Array.isArray(poll.options) || poll.options.length < 2)
+                continue;
+            const label = channel === "x" ? "X" : capitalize(channel);
+            md += `\n\n### ${label} Poll\n\n`;
+            for (const option of poll.options)
+                md += `- ${option}\n`;
+            const runs = channel === "x"
+                ? `${poll.duration_minutes ?? 1440} minutes`
+                : channel === "mastodon"
+                    ? `${poll.expires_in ?? 86400} seconds${poll.multiple ? ", several answers" : ""}`
+                    : "24 hours (set by Threads)";
+            md += `\n_Runs for: ${runs}_\n`;
+        }
+        const tg = (p.telegram && typeof p.telegram === "object" ? p.telegram : null);
+        if (tg) {
+            const flagKeys = ["silent", "link_preview", "pin", "protect_content", "spoiler", "caption_above_media"];
+            const flags = flagKeys.filter((k) => typeof tg[k] === "boolean").map((k) => `${k}: ${tg[k]}`);
+            const buttons = Array.isArray(tg.buttons) ? tg.buttons : [];
+            const pollOptions = tg.poll && Array.isArray(tg.poll.options) ? tg.poll.options : [];
+            const poll = pollOptions.length >= 2 ? tg.poll : null;
+            const result = tg.result && typeof tg.result === "object" ? tg.result : null;
+            if (flags.length || buttons.length || poll || result) {
+                md += `\n\n### Telegram\n\n`;
+                if (flags.length)
+                    md += `${flags.join(" · ")}\n`;
+                for (const b of buttons)
+                    md += `- Button: ${b.text ?? ""} → ${b.url ?? ""}\n`;
+                if (poll) {
+                    md += `\n**Poll:**\n`;
+                    for (const option of pollOptions)
+                        md += `- ${option}\n`;
+                    md += `\n_Open: ${poll.open_period ? `${poll.open_period} seconds` : "until closed"}${poll.multiple ? ", several answers" : ""}_\n`;
+                }
+                if (result) {
+                    const count = Array.isArray(result.message_ids) ? result.message_ids.length : 0;
+                    const link = result.link_public || result.link_private;
+                    md += `\nSent: ${count} message${count === 1 ? "" : "s"}${result.pinned ? ", pinned" : result.pin_error ? ` (not pinned: ${result.pin_error})` : ""}${link ? ` · ${link}` : ""}\n`;
+                }
+            }
+        }
+        const dc = (p.discord && typeof p.discord === "object" ? p.discord : null);
+        if (dc) {
+            const flagKeys = ["silent", "link_preview", "allow_mentions", "spoiler"];
+            const flags = flagKeys.filter((k) => typeof dc[k] === "boolean").map((k) => `${k}: ${dc[k]}`);
+            const buttons = Array.isArray(dc.buttons) ? dc.buttons : [];
+            const pollOptions = dc.poll && Array.isArray(dc.poll.options) ? dc.poll.options : [];
+            const poll = pollOptions.length >= 2 ? dc.poll : null;
+            const result = dc.result && typeof dc.result === "object" ? dc.result : null;
+            if (flags.length || dc.thread_name || buttons.length || poll || result) {
+                md += `\n\n### Discord\n\n`;
+                if (flags.length)
+                    md += `${flags.join(" · ")}\n`;
+                if (dc.thread_name)
+                    md += `Forum post title: ${dc.thread_name}\n`;
+                for (const b of buttons)
+                    md += `- Button: ${b.text ?? ""} → ${b.url ?? ""}\n`;
+                if (poll) {
+                    md += `\n**Poll:**\n`;
+                    for (const option of pollOptions)
+                        md += `- ${option}\n`;
+                    md += `\n_Open: ${poll.duration_hours ?? 24} hours${poll.multiple ? ", several answers" : ""}_\n`;
+                }
+                if (result) {
+                    const links = Array.isArray(result.video_links) ? result.video_links.length : 0;
+                    const titleDropped = Array.isArray(result.warnings) && result.warnings.includes("thread_name_ignored");
+                    md += `\nSent${result.url ? `: ${result.url}` : ""}${links ? ` · ${links} video${links === 1 ? "" : "s"} sent as a link (over Discord's 20 MB file limit)` : ""}${titleDropped ? " · the post title was left out (the channel is not a forum)" : ""}\n`;
+                }
+            }
+        }
         const publishedUrls = (p.published_urls && typeof p.published_urls === "object" && !Array.isArray(p.published_urls))
             ? p.published_urls
             : {};
@@ -575,7 +797,7 @@ export function registerPostTools(server, getClient) {
         }
         // First comments: nested under each platform object by the API. Show the
         // configured text plus, once published, the outcome (posted/failed/skipped).
-        const firstCommentPlatforms = ["instagram", "facebook", "linkedin", "linkedin_page", "youtube", "tiktok"];
+        const firstCommentPlatforms = ["instagram", "facebook", "linkedin", "linkedin_page", "youtube", "tiktok", "telegram"];
         const firstCommentRows = [];
         for (const platform of firstCommentPlatforms) {
             const opts = p[platform];
@@ -747,6 +969,7 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - TikTok posts: ALWAYS require at least one image or video.
    - Pinterest posts: ALWAYS require an image AND a board_id.
    - Other platforms (LinkedIn, LinkedIn Page, X, Bluesky, etc.): Media is optional.
+   - **Image fit (aspect ratio)**: a feed image outside what a channel shows uncropped is handled PER CHANNEL. Instagram shows feed images between 4:5 and 1.91:1: a 9:16 (story-style) image posted to the Instagram feed is CROPPED to 4:5 around the subject by default, because Instagram cuts it to that window anyway and Meta cannot boost a feed post outside it. Pinterest keeps a Pin taller than 2:3 and reports it. Before posting a tall image to Instagram, run \`check_media_compatibility\` (its fit rows say per connected channel whether the image fits and what the default does) and ASK the user: crop to 4:5 (recommended: Meta can boost it) or keep the original (Instagram cuts it itself, no boost)? Pass the answer as \`media_fit: { instagram: "crop" | "keep" }\`. If the user gave no preference, let the default run and RELAY the \`image_fit\` warning from the response (it names the crop and how to undo it with update_post). Stories, reels and videos are never cropped; 'default' and the other channels keep the original. Never drop a channel over this.
 
    **Per-platform max media items (enforced at submit, returns 400 validation_error if exceeded):**
    - Bluesky, X, Mastodon — max **4** items per post; cannot mix images and video
@@ -754,10 +977,12 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - TikTok — max **35** photos per photo-post; cannot mix photos and videos in one post
    - Pinterest carousel — 2–5 images, all same aspect ratio (a video splits off into its own video pin)
    - Facebook, LinkedIn, LinkedIn Page — cannot mix images and video in one post (images only, or a single video)
+   - Telegram — max **10** items per album; photos and videos CAN be mixed, a GIF goes on its own, files do not mix with photos
+   - Discord — max **10** files per message; images, GIFs and videos CAN be mixed
 
    **Per-platform video caps (duration + size, checked via ffprobe at submit; exceeding either returns a 400 validation_error stating the exact cap and the file's value, e.g. "X only allows videos up to 2min 20s; yours is 2min 35s. Trim the video or deselect X."):**
    - X — **140s (2min 20s)** · **512MB** on free/Basic accounts; when the connected X account has **Premium or Premium+** the caps rise to **125min / 16GB** automatically (tier is read from the connection; reconnect X after upgrading). X also can't mix a video with images in one tweet: a tweet is either 1 video OR up to 4 images
-   - Bluesky 180s · Threads 5min · Instagram 15min · TikTok 10min · YouTube Short 3min · LinkedIn 10min · Pinterest 15min · Facebook 240min (Post + Reel; the old 90s Reel cap is gone)
+   - Bluesky 10min · Threads 5min · Instagram 15min · TikTok 10min · YouTube Short 3min · LinkedIn 30min · Pinterest 15min · Facebook 240min (Post + Reel; the old 90s Reel cap is gone) · Telegram no duration cap, **50MB** per file (photos 10MB) · Discord no duration cap; a video or GIF over **20MB** goes as a link in the message instead of a file
    Pick a file within the cap up front; if the user's video is over, tell them the limit so they can trim it rather than retrying blindly.
 
    When attaching more than these caps to a selected platform, EITHER trim the array OR move to a flat \`media_urls: [...]\` and let the user know which platform will be over the limit so they can split into multiple posts.
@@ -769,8 +994,10 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
      If the user named a board ("post to my Marketing board") or specified one in the request, use that one instead of the first — match on name (case-insensitive) against the boards list.
    - YouTube: Title, privacy status, tags?
    - TikTok: Privacy level?
-   - **X threads vs long-form**: A chained "thread" (the user explicitly asks for one) → pass \`x.thread_parts\` as an array of 2–25 \`{ text }\` objects (each ≤ 280 chars on free/Basic, 25,000 on Premium/Premium+); the \`content\` field is then ignored for X. A single **long-form** post on a Premium / Premium+ account → just put the full text (up to 25,000 chars) in \`content\` — no threading needed (check \`platform_details.subscription_type\` via list_accounts). On free / Basic, X caps a single post at 280 chars, so either split into a thread or shorten. Never cram "1/", "2/" prefixes into \`content\` — that posts one tweet, not a thread.
-   - **Bluesky, Mastodon and Threads chains**: the same \`thread_parts\` shape works under \`bluesky\`, \`mastodon\` and \`threads\` (each an array of 2 to 25 \`{ text, media_ids?, media_urls? }\` objects); parts after the first publish as replies to the previous part and \`content\` is then ignored for that platform. Threads: 2 to 25 parts, 500 characters per part, up to 10 media per part (images and videos can be mixed). Bluesky: 300 characters per part, 4 media. Mastodon: 500 characters per part (instance-dependent), 4 media.
+   - **X threads vs long-form**: A chained "thread" (the user explicitly asks for one) → pass \`x.thread_parts\` as an array of 2–25 \`{ text }\` objects (each ≤ 280 chars on free accounts, 25,000 on Basic, Premium and Premium+); the \`content\` field is then ignored for X. A single **long-form** post on a Basic, Premium or Premium+ account → just put the full text (up to 25,000 chars) in \`content\` — no threading needed (check \`platform_details.subscription_type\` via list_accounts). On a free account, X caps a single post at 280 chars, so either split into a thread or shorten. Never cram "1/", "2/" prefixes into \`content\` — that posts one tweet, not a thread.
+   - **Telegram** (a channel or group the user connected; the OmniSocials bot posts it): options under \`telegram\`: \`silent\`, \`link_preview\`, \`pin\`, \`protect_content\`, \`spoiler\`, \`caption_above_media\`, up to 3 \`buttons\` (\`{ text, url }\`, not on an album or a poll), a native \`poll\` (2 to 12 options; the post text is the question, max 300 chars; no media) and \`first_comment\` (a reply under the post). Text up to 4,096 characters; with media, text over 1,024 characters is sent as a reply under the media. No Stories. Telegram gives bots no view counts: statistics are reactions and the subscriber count.
+   - **Discord** (one Discord channel the user connected; the message is sent through the channel's webhook and shows the webhook's name and picture): options under \`discord\`: \`silent\`, \`link_preview\`, \`allow_mentions\` (off by default, so @everyone and role mentions in the text ping nobody; turn it on only when the user asks to ping), \`spoiler\`, \`thread_name\` (the post title, required in a forum or media channel; a text channel takes none, so the post goes out there without it), up to 5 \`buttons\` (\`{ text, url }\`, not with a poll) and a native \`poll\` (2 to 10 options of up to 55 chars, \`duration_hours\` 1 to 768, default 24; the post text is the question, max 300 chars; no media). Text up to 2,000 characters. No Stories; a Reel is one video message. Discord gives webhooks no view counts: statistics are reactions and the poll votes. A sent message can be deleted at any time.
+   - **Bluesky, Mastodon and Threads chains**: the same \`thread_parts\` shape works under \`bluesky\`, \`mastodon\` and \`threads\` (each an array of 2 to 25 \`{ text, media_ids?, media_urls? }\` objects); parts after the first publish as replies to the previous part and \`content\` is then ignored for that platform. Threads: 2 to 25 parts, 500 characters per part, up to 20 media per part (images and videos can be mixed). Bluesky: 300 characters per part, 10 images or 1 video. Mastodon: 500 characters per part (instance-dependent), 4 media.
    - **X posts containing a link cost credits**: X's API bills posts whose text contains a URL at a premium, and OmniSocials passes that through as prepaid credits at X's exact rate (20 credits ≈ $0.20 per URL-containing tweet; threads are charged per part that contains a link). Only a link written with http:// or https:// counts; a bare domain (brand.com) or a www. link is free. The create response includes a \`warnings\` entry (\`x_url_post_credits\`) with the cost and current balance — relay it to the user. Credits are only deducted after the post successfully publishes; a failed publish is never charged. If the balance can't cover it at publish time, only the X target fails (message says to top up at https://app.omnisocials.com/credits) and the post can be retried after topping up. Posts without links stay free — never remove a user's link to dodge the fee without asking them. Scheduling is also gated up front: every scheduled X link post reserves its cost, and a create/schedule that would push the reserved total past the balance is refused with a 402 \`x_credits_insufficient\` error (details carry credits_required / credits_balance / credits_reserved) — tell the user to top up or remove the link, don't silently retry.
 
 Do NOT call this tool without media when creating stories, reels, Instagram posts, TikTok posts, or Pinterest posts — it will fail.
@@ -778,7 +1005,8 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
 **When the user shares an image in chat but you cannot upload it** (e.g. no public URL available): save the post as a draft with the caption, then tell the user: "I saved your post as a draft in OmniSocials. Open it there to add your image and schedule it when ready." Include a link to https://app.omnisocials.com. Do NOT tell the user it's impossible — always save the draft so their caption isn't lost.`, {
         content: z.union([z.string(), z.record(z.string(), z.string())]).describe("Post caption. String for same text on all channels, or object with platform keys for per-channel captions: { \"default\": \"fallback\", \"linkedin\": \"long version\", \"threads\": \"short version\" }. The \"default\" key is used for any selected channel without its own key."),
         channels: z.array(z.string()).optional().describe("Array of channel IDs to post to. Get the available channel IDs from list_accounts. Each entry may be a bare platform name (e.g. `\"youtube\"`) or the composite `\"<workspace_id>_<platform>\"` form from list_accounts (e.g. `\"844008_youtube\"`); always source these from list_accounts for the API key in use — composite IDs with an unknown or mismatched workspace prefix are rejected as unknown accounts. Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels. A workspace can have both connected and post to each separately."),
-        scheduled_at: z.string().optional().describe("ISO 8601 date for scheduled publishing"),
+        scheduled_at: z.string().optional().describe("ISO 8601 date for scheduled publishing. With `draft: true` the time is kept but the post stays a draft (a planned draft on the user's calendar)."),
+        draft: z.boolean().optional().describe("Planned draft. With scheduled_at, the post is stored as a draft that keeps that time: it shows on the user's calendar at that slot with a dashed outline, is never published by the scheduler, and the user schedules it from the composer (or you do with update_post and draft: false). Use it when you propose a time slot that the user should confirm, e.g. 'put a draft on Thursday 10:00 for me to review'. Not allowed with publish_now or approval_workflow_id. Without scheduled_at it changes nothing."),
         media_ids: z.union([
             z.array(mediaIdEntry),
             z.record(z.string(), z.array(mediaIdEntry)),
@@ -795,13 +1023,14 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
         location_id: z.string().optional().describe("Instagram only. Facebook Place ID of a single physical venue (with a street address) to tag the post's location. Applied to single-image and carousel Instagram feed posts. To get a valid ID, call the `search_locations` tool with the place name and let the user pick. Ignored by other platforms."),
         collaborators: z.array(z.string()).max(3).optional().describe("Instagram only. Up to 3 public Instagram usernames to invite as co-authors (the 'Collab' feature). Works on image, carousel, and reel posts — NOT Stories. Invited users get an invite in the Instagram app; once they accept, the post also appears on their profile and feed. A leading '@' is stripped; usernames are case-insensitive. Private or non-existent usernames are rejected by Instagram at publish time with a clear error. Ignored by other platforms."),
         user_tags: z.array(USER_TAG_ENTRY).optional().describe("Instagram only. Tag public accounts at x/y positions on a PHOTO (not video/reels/stories). For a single image omit image_index; for a carousel, set image_index to the slide each tag belongs to. Private/non-existent usernames are rejected at publish time. Ignored by other platforms."),
-        hashtag_set: z.string().optional().describe("Name of a saved hashtag set (from list_hashtag_sets, matched case-insensitively) to apply. The set's tags are merged in ONCE at create time — tags already in a caption are skipped, and Instagram's 30-hashtag cap returns a clear hashtag_limit_exceeded error. When the user says 'add my usual hashtags', check list_hashtag_sets first."),
-        hashtag_placement: z.enum(["caption_append", "first_comment"]).optional().describe("Where the set's tags land. caption_append (default): appended to each target caption after a blank line. first_comment: posted as the auto first comment on Instagram/Facebook/LinkedIn/LinkedIn Page/YouTube/TikTok (TikTok only when the workspace enabled TikTok comments) (appended after any explicit first_comment); platforms without a comment API fall back to caption_append. Stories always use captions."),
+        hashtag_set: z.string().optional().describe("Name of a saved hashtag set (from list_hashtag_sets, matched case-insensitively) to apply. The set's tags are merged in ONCE at create time — tags already in a caption are skipped, and Instagram's 5-hashtag cap returns a clear hashtag_limit_exceeded error. When the user says 'add my usual hashtags', check list_hashtag_sets first."),
+        hashtag_placement: z.enum(["caption_append", "first_comment"]).optional().describe("Where the set's tags land. caption_append (default): appended to each target caption after a blank line. first_comment: posted as the auto first comment on Instagram/Facebook/LinkedIn/LinkedIn Page/YouTube/TikTok/Telegram (TikTok only when the workspace enabled TikTok comments) (appended after any explicit first_comment); platforms without a comment API fall back to caption_append. Stories always use captions."),
         hashtag_platforms: z.array(z.string()).optional().describe("Optional subset of the post's channels to apply the hashtag set to (e.g. [\"instagram\", \"tiktok\"]). Defaults to all selected channels."),
         video_cover: VIDEO_COVER_OPTIONS,
+        media_fit: MEDIA_FIT_OPTIONS,
         pinterest: PINTEREST_OPTIONS,
         youtube: z.object({
-            title: z.string().optional().describe("Short title shown on YouTube. Falls back to \"YouTube Short\" when omitted."),
+            title: z.string().optional().describe("Short title shown on YouTube (max 100 characters). When omitted, the first line of the caption is used; \"YouTube Short\" only when there is no caption either."),
             tags: z.array(z.string()).optional(),
             privacy_status: z.enum(["public", "private", "unlisted"]).optional(),
             category_id: z.string().optional(),
@@ -832,20 +1061,26 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
             paid_partnership: z.boolean().optional().describe("Mark as paid partnership disclosure"),
             made_with_ai: z.boolean().optional().describe("Mark as AI-generated content"),
+            poll: X_POLL_OPTIONS,
             thread_parts: z.array(X_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained X thread instead of a single tweet. Provide 2–25 parts; each is posted in order via in_reply_to_tweet_id. Attach media to any part (first tweet or reply) via media_ids (from upload_media) or media_urls — max 4 per part. For a single tweet, omit thread_parts and use content."),
         }).optional().describe("X (Twitter) options"),
         bluesky: z.object({
-            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Bluesky thread instead of a single post. Provide 2–25 parts; each is posted in order via AT Protocol reply refs (root + parent). Attach media to any part via media_ids (from upload_media) or media_urls — a part is one video OR up to 4 images. Links, mentions and hashtags are made clickable automatically. For a single post, omit thread_parts and use content."),
+            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Bluesky thread instead of a single post. Provide 2–25 parts; each is posted in order via AT Protocol reply refs (root + parent). Attach media to any part via media_ids (from upload_media) or media_urls — a part is one video OR up to 10 images. Links, mentions and hashtags are made clickable automatically. For a single post, omit thread_parts and use content."),
         }).optional().describe("Bluesky options"),
         mastodon: z.object({
+            poll: MASTODON_POLL_OPTIONS,
             thread_parts: z.array(MASTODON_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Mastodon thread instead of a single status. Provide 2–25 parts; each is posted in order as a native reply to the previous status (in_reply_to_id). Attach media to any part via media_ids (from upload_media) or media_urls — max 4 per part. For a single status, omit thread_parts and use content."),
         }).optional().describe("Mastodon options"),
         threads: z.object({
+            poll: THREADS_POLL_OPTIONS,
             location_id: z.string().nullable().optional().describe("Tag a location on the Threads post. Use an `id` from search_locations with platform \"threads\" (Threads location ids are NOT Facebook Place IDs, so never reuse the Instagram location_id here). On a multi-post thread the tag goes on the first post. Needs the workspace's Threads connection to have the threads_location_tagging permission; the API returns a clear 400 asking to reconnect Threads when it is missing, and a clear 400 while location tagging is still rolling out (Meta has not approved the permission yet). On update_post, pass null to remove the tag."),
             thread_parts: z.array(THREADS_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Threads (Meta) thread instead of a single post. Provide 2 to 25 parts; parts after the first are posted as replies to the previous part. Each part holds up to 500 characters and up to 10 media (images and videos can be mixed) via media_ids (from upload_media) or media_urls. When set, the Threads caption is taken from part 1 and content is ignored for Threads. For a single post, omit thread_parts and use content."),
         }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
+        telegram: TELEGRAM_OPTIONS,
+        discord: DISCORD_OPTIONS,
         approval_workflow_id: z.string().optional().describe("Route the post through a saved approval workflow (id from list_approval_workflows). The post is created as `in_approval` instead of `scheduled`: its approvers are notified, they review it on the Approvals page, and it publishes at scheduled_at only once the workflow's last step approves it (or approve_post). Use this whenever the user wants to review/approve agent-created posts before they go out. Requires scheduled_at; not allowed with publish_now (use create_post, never create_and_publish_post). A workflow with no approvers on its first step is rejected with validation_error."),
+        comment_dm_automation: COMMENT_DM_AUTOMATION.optional(),
     }, { title: "Create Post", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async (params) => {
         const result = await getClient().createPost({ ...params, source: "mcp" });
         if (result.error) {
@@ -869,9 +1104,14 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             const schedAt = p.schedule_at ?? p.scheduled_at;
             const channels = selectedChannels(p);
             const inApproval = p.status === "in_approval";
+            // A draft that carries a time is a planned draft: on the calendar,
+            // not scheduled. Say so, or the agent reports it as scheduled.
+            const planned = p.status === "draft" && !!schedAt;
             let md = inApproval
                 ? `## Post Submitted for Approval\n\n`
-                : `## Draft Created (not yet published)\n\n`;
+                : planned
+                    ? `## Draft Planned (not scheduled yet)\n\n`
+                    : `## Draft Created (not yet published)\n\n`;
             md += `| Field | Value |\n`;
             md += `|-------|-------|\n`;
             md += `| **ID** | \`${p.id}\` |\n`;
@@ -879,15 +1119,19 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             if (inApproval)
                 md += `| **Approval status** | ${capitalize(p.approval_status || "pending")} |\n`;
             if (schedAt)
-                md += `| **${inApproval ? "Publishes (once approved)" : "Scheduled"}** | ${formatDateTime(schedAt)} |\n`;
+                md += `| **${inApproval ? "Publishes (once approved)" : planned ? "Planned for" : "Scheduled"}** | ${formatDateTime(schedAt)} |\n`;
             if (channels.length)
                 md += `| **Channels** | ${channels.join(", ")} |\n`;
+            md += commentDmLine(p);
             if (appUrl)
                 md += `| **Open in OmniSocials** | ${appUrl} |\n`;
             md += `\n**Content:** ${truncate(p.content, 100)}\n\n`;
             if (inApproval) {
                 md += `_The approvers have been notified. The post publishes at the time above as soon as the workflow's last step approves it (Approvals page in OmniSocials, or approve_post). Nothing else is needed from the user until then._\n\n`;
             }
+            else if (planned) {
+                md += `_The draft sits on the user's calendar at that time with a dashed outline. It does not publish until someone schedules it: the user from the composer, or you with update_post and draft: false._\n\n`;
+            }
             if (Array.isArray(result.warnings) && result.warnings.length > 0) {
                 for (const w of result.warnings) {
                     md += `⚠️ ${w.message}\n`;
@@ -928,10 +1172,12 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - Instagram/TikTok posts: ALWAYS need at least one image or video.
    - Pinterest: ALWAYS need an image + board_id.
    - Ask the user which media to use. Use list_media to show options.
-   - **Max items per platform** (same caps as create_post — exceeding returns 400): Bluesky/X/Mastodon ≤4, Instagram/Threads ≤10, TikTok ≤35 photos, Pinterest carousel 2–5 same-ratio images. Mixing images+video is rejected on Facebook/LinkedIn/X/Bluesky/Mastodon/TikTok; Instagram and Threads mixed carousels are allowed.
-   - **Video duration/size caps** (ffprobe at submit — over either returns 400 validation_error with the exact cap + the file's value): X **140s/512MB** free/Basic, **125min/16GB** when the connected X account has Premium/Premium+ (auto-detected; no video+image mix in one tweet), Bluesky 180s, Threads 5min, Instagram 15min, TikTok 10min, YouTube Short 3min, LinkedIn 10min, Facebook 240min (Post + Reel; the old 90s Reel cap is gone).
+   - **Max items per platform** (same caps as create_post — exceeding returns 400): Bluesky/X/Mastodon ≤4, Instagram/Threads/Telegram/Discord ≤10, TikTok ≤35 photos, Pinterest carousel 2–5 same-ratio images. Mixing images+video is rejected on Facebook/LinkedIn/X/Bluesky/Mastodon/TikTok; Instagram and Threads mixed carousels are allowed.
+   - **Video duration/size caps** (ffprobe at submit — over either returns 400 validation_error with the exact cap + the file's value): X **140s/512MB** free/Basic, **125min/16GB** when the connected X account has Premium/Premium+ (auto-detected; no video+image mix in one tweet), Bluesky 10min, Threads 5min, Instagram 15min, TikTok 10min, YouTube Short 3min, LinkedIn 30min, Facebook 240min (Post + Reel; the old 90s Reel cap is gone), Telegram 50MB per file, Discord: a video or GIF over 20MB goes as a link in the message.
+   - **Telegram**: options under \`telegram\` (silent, link_preview, pin, protect_content, spoiler, caption_above_media, buttons, poll, first_comment), same shape as create_post. No Stories.
+   - **Discord**: options under \`discord\` (silent, link_preview, allow_mentions, spoiler, thread_name, buttons, poll), same shape as create_post. No Stories. \`allow_mentions\` stays off unless the user asks to ping @everyone or a role.
 4. **Pinterest board (auto-default to first board)**: If Pinterest is in \`channels\` and \`pinterest.board_id\` is NOT provided, do NOT block on asking — and do NOT skip Pinterest. Call \`get_account\` on the Pinterest account, take the FIRST board from the returned boards list, and pass its \`id\` as \`pinterest.board_id\`. In your reply, mention which board you used (e.g. "Published to your 'Marketing' board on Pinterest — let me know if you'd prefer a different one.") so the user can redirect. If the user named a specific board in the request, match it (case-insensitive) against the list and use that one instead.
-5. **X threads vs long-form**: A chained "thread" → pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects (each ≤ 280 chars on free/Basic, 25,000 on Premium/Premium+). A single long-form post on a Premium / Premium+ account → put the full text (up to 25,000 chars) in \`content\`; no threading needed. On free / Basic, X caps a single post at 280 chars. Do NOT split into "1/", "2/" inside \`content\` — that produces a single tweet, not a thread. The same \`thread_parts\` shape works under \`bluesky\`, \`mastodon\` and \`threads\` (Threads: 2 to 25 parts, 500 characters per part, up to 10 media per part; parts after the first publish as replies to the previous part).
+5. **X threads vs long-form**: A chained "thread" → pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects (each ≤ 280 chars on free accounts, 25,000 on Basic, Premium and Premium+). A single long-form post on a Basic, Premium or Premium+ account → put the full text (up to 25,000 chars) in \`content\`; no threading needed. On a free account, X caps a single post at 280 chars. Do NOT split into "1/", "2/" inside \`content\` — that produces a single tweet, not a thread. The same \`thread_parts\` shape works under \`bluesky\`, \`mastodon\` and \`threads\` (Threads: 2 to 25 parts, 500 characters per part, up to 10 media per part; parts after the first publish as replies to the previous part).
 6. **X posts containing a link cost credits**: X bills API posts whose text contains a URL at a premium; OmniSocials passes that through as prepaid credits at X's exact rate (20 credits ≈ $0.20 per URL-containing tweet, threads charged per link-containing part; only a link written with http:// or https:// counts, a bare domain or www. link is free). Because this tool publishes IMMEDIATELY, the debit happens right away — if the company's balance can't cover it, the X target fails with a top-up message while other platforms still publish. Relay any \`x_url_post_credits\` warning and X publish failure to the user; never strip their link to avoid the fee without asking. If the balance (minus credits reserved by scheduled X link posts) can't cover this post, the request is refused up front with a 402 \`x_credits_insufficient\` error instead of failing at publish.
 
 Do NOT call without required media — it will fail.`, {
@@ -957,6 +1203,7 @@ Do NOT call without required media — it will fail.`, {
         hashtag_placement: z.enum(["caption_append", "first_comment"]).optional().describe("caption_append (default) appends tags to the captions; first_comment posts them as the auto first comment on comment-capable platforms (others fall back to caption)."),
         hashtag_platforms: z.array(z.string()).optional().describe("Optional subset of the post's channels to apply the hashtag set to. Defaults to all selected channels."),
         video_cover: VIDEO_COVER_OPTIONS,
+        media_fit: MEDIA_FIT_OPTIONS,
         pinterest: PINTEREST_OPTIONS,
         youtube: z.object({
             title: z.string().optional().describe("Short title shown on YouTube."),
@@ -990,19 +1237,25 @@ Do NOT call without required media — it will fail.`, {
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
             paid_partnership: z.boolean().optional().describe("Mark as paid partnership disclosure"),
             made_with_ai: z.boolean().optional().describe("Mark as AI-generated content"),
+            poll: X_POLL_OPTIONS,
             thread_parts: z.array(X_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained X thread (2–25 parts). Each is posted in order via in_reply_to_tweet_id. Attach media to any part via media_ids (from upload_media) or media_urls — max 4 per part."),
         }).optional().describe("X (Twitter) options"),
         bluesky: z.object({
-            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Bluesky thread (2–25 parts). Each is posted in order via AT Protocol reply refs (root + parent). Attach media to any part via media_ids or media_urls — one video OR up to 4 images per part. Links, mentions and hashtags are made clickable automatically."),
+            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Bluesky thread (2–25 parts). Each is posted in order via AT Protocol reply refs (root + parent). Attach media to any part via media_ids or media_urls — one video OR up to 10 images per part. Links, mentions and hashtags are made clickable automatically."),
         }).optional().describe("Bluesky options"),
         mastodon: z.object({
+            poll: MASTODON_POLL_OPTIONS,
             thread_parts: z.array(MASTODON_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Mastodon thread (2–25 parts). Each is posted in order as a native reply (in_reply_to_id). Attach media to any part via media_ids or media_urls — max 4 per part."),
         }).optional().describe("Mastodon options"),
         threads: z.object({
+            poll: THREADS_POLL_OPTIONS,
             location_id: z.string().nullable().optional().describe("Tag a location on the Threads post. Use an `id` from search_locations with platform \"threads\" (Threads location ids are NOT Facebook Place IDs, so never reuse the Instagram location_id here). On a multi-post thread the tag goes on the first post. Needs the workspace's Threads connection to have the threads_location_tagging permission; the API returns a clear 400 asking to reconnect Threads when it is missing, and a clear 400 while location tagging is still rolling out (Meta has not approved the permission yet). On update_post, pass null to remove the tag."),
             thread_parts: z.array(THREADS_THREAD_PART).min(2).max(25).optional().describe("Publish as a chained Threads (Meta) thread (2 to 25 parts). Parts after the first are posted as replies to the previous part. Each part holds up to 500 characters and up to 10 media (images and videos can be mixed) via media_ids or media_urls. The Threads caption is taken from part 1."),
         }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
+        telegram: TELEGRAM_OPTIONS,
+        discord: DISCORD_OPTIONS,
+        comment_dm_automation: COMMENT_DM_AUTOMATION.optional(),
     }, { title: "Create and Publish Post", readOnlyHint: false, destructiveHint: true, openWorldHint: true }, async (params) => {
         const result = await getClient().createAndPublishPost({ ...params, source: "mcp" });
         if (result.error) {
@@ -1049,12 +1302,13 @@ Do NOT call without required media — it will fail.`, {
     });
     server.tool("update_post", `Update an existing post. Only draft and scheduled posts can be updated.
 
-**Per-platform options (\`youtube\`, \`pinterest\`, \`instagram\`, \`tiktok\`, \`google_business\`)** are accepted here, same shape as in \`create_post\`. Pass an object — never a JSON-encoded string. For YouTube Shorts, the **title** lives at \`youtube.title\`; the **video description** lives in \`content\` (or \`content.youtube\` for a per-platform override). They are not the same field — changing the caption does NOT rename the Short.
+**Per-platform options (\`youtube\`, \`pinterest\`, \`instagram\`, \`tiktok\`, \`google_business\`, \`telegram\`, \`discord\`)** are accepted here, same shape as in \`create_post\`. Pass an object — never a JSON-encoded string. For YouTube Shorts, the **title** lives at \`youtube.title\`; the **video description** lives in \`content\` (or \`content.youtube\` for a per-platform override). They are not the same field — changing the caption does NOT rename the Short.
 
-**X threads**: To convert an existing draft into a chained X thread, pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects (each ≤ 280 chars on free/Basic, 25,000 on Premium/Premium+). Pass \`null\` to revert to single-tweet mode. Do NOT shove "1/", "2/" into \`content\` — that's a single tweet, not a thread. The same applies to \`bluesky.thread_parts\`, \`mastodon.thread_parts\` and \`threads.thread_parts\` (Threads: 2 to 25 parts, 500 characters per part, up to 10 media per part; \`null\` reverts to a single post).`, {
+**X threads**: To convert an existing draft into a chained X thread, pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects (each ≤ 280 chars on free accounts, 25,000 on Basic, Premium and Premium+). Pass \`null\` to revert to single-tweet mode. Do NOT shove "1/", "2/" into \`content\` — that's a single tweet, not a thread. The same applies to \`bluesky.thread_parts\`, \`mastodon.thread_parts\` and \`threads.thread_parts\` (Threads: 2 to 25 parts, 500 characters per part, up to 10 media per part; \`null\` reverts to a single post).`, {
         id: z.string().describe("The post ID to update"),
         content: z.union([z.string(), z.record(z.string(), z.string())]).optional().describe("Updated post caption / body text. For YouTube Shorts this becomes the video description, NOT the title — to rename the Short, use `youtube.title`. String or object with platform keys: { \"default\": \"fallback\", \"linkedin\": \"long\" }."),
-        scheduled_at: z.string().optional().describe("Updated scheduled date (ISO 8601, must be in the future). A draft becomes scheduled. A post waiting for approval keeps its in_approval status; only its time moves."),
+        scheduled_at: z.string().optional().describe("Updated scheduled date (ISO 8601, must be in the future). A draft becomes scheduled (or stays a planned draft when draft: true is sent with it). A post waiting for approval keeps its in_approval status; only its time moves."),
+        draft: z.boolean().optional().describe("Planned-draft switch. false without scheduled_at schedules a planned draft at the time it already carries (validation_error when it has no time or the time is in the past). true without scheduled_at unschedules a scheduled post: it keeps its time, stays on the calendar as a dashed draft and nothing publishes; a post waiting for approval leaves its workflow. true with scheduled_at moves the time and keeps the post a draft."),
         channels: z.array(z.string()).optional().describe("Updated channel IDs. Bare platform name or composite `\"<workspace_id>_<platform>\"`; always source from list_accounts for this API key (unknown or mismatched workspace prefixes are rejected as unknown accounts). Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels."),
         media_ids: z.union([
             z.array(mediaIdEntry),
@@ -1072,6 +1326,7 @@ Do NOT call without required media — it will fail.`, {
         collaborators: z.array(z.string()).max(3).optional().describe("Instagram only. Up to 3 public Instagram usernames to invite as co-authors. Replaces the existing collaborator list. Send an empty array to clear collaborators. Works on image, carousel, and reel posts — NOT Stories. Ignored by other platforms."),
         user_tags: z.array(USER_TAG_ENTRY).optional().describe("Instagram only. Tag public accounts at x/y positions on a PHOTO (not video/reels/stories). Replaces the existing tag list. Send an empty array to clear. For carousels set image_index per tag. Ignored by other platforms."),
         video_cover: VIDEO_COVER_OPTIONS.nullable().describe("Replaces the stored video cover wholesale; pass null to remove it; omit to leave it untouched. facebook.thumbnail_type / thumb_offset / cover_url merge into overrides.facebook on their own."),
+        media_fit: MEDIA_FIT_OPTIONS,
         youtube: z.object({
             title: z.string().optional().describe("Short title shown on YouTube. To change the Short's title on an existing draft, set this — do NOT use `content` (which is the description)."),
             tags: z.array(z.string()).optional(),
@@ -1105,19 +1360,25 @@ Do NOT call without required media — it will fail.`, {
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
             paid_partnership: z.boolean().optional(),
             made_with_ai: z.boolean().optional(),
+            poll: X_POLL_OPTIONS,
             thread_parts: z.array(X_THREAD_PART).min(2).max(25).nullable().optional().describe("Replace the X thread shape on this post. Pass an array (2–25 parts) to update/create the thread (attach media to any part via media_ids or media_urls, max 4 per part), or `null` to revert to single-tweet mode."),
         }).optional().describe("X (Twitter) options"),
         bluesky: z.object({
-            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).nullable().optional().describe("Replace the Bluesky thread shape on this post. Pass an array (2–25 parts) to update/create the thread (attach media to any part via media_ids or media_urls; one video OR up to 4 images per part), or `null` to revert to single-post mode."),
+            thread_parts: z.array(BLUESKY_THREAD_PART).min(2).max(25).nullable().optional().describe("Replace the Bluesky thread shape on this post. Pass an array (2–25 parts) to update/create the thread (attach media to any part via media_ids or media_urls; one video OR up to 10 images per part), or `null` to revert to single-post mode."),
         }).optional().describe("Bluesky options"),
         mastodon: z.object({
+            poll: MASTODON_POLL_OPTIONS,
             thread_parts: z.array(MASTODON_THREAD_PART).min(2).max(25).nullable().optional().describe("Replace the Mastodon thread shape on this post. Pass an array (2–25 parts) to update/create the thread (attach media to any part via media_ids or media_urls; max 4 per part), or `null` to revert to single-status mode."),
         }).optional().describe("Mastodon options"),
         threads: z.object({
+            poll: THREADS_POLL_OPTIONS,
             location_id: z.string().nullable().optional().describe("Tag a location on the Threads post. Use an `id` from search_locations with platform \"threads\" (Threads location ids are NOT Facebook Place IDs, so never reuse the Instagram location_id here). On a multi-post thread the tag goes on the first post. Needs the workspace's Threads connection to have the threads_location_tagging permission; the API returns a clear 400 asking to reconnect Threads when it is missing, and a clear 400 while location tagging is still rolling out (Meta has not approved the permission yet). On update_post, pass null to remove the tag."),
             thread_parts: z.array(THREADS_THREAD_PART).min(2).max(25).nullable().optional().describe("Replace the Threads (Meta) thread shape on this post. Pass an array (2 to 25 parts, 500 characters per part) to update/create the thread (attach up to 10 media to any part via media_ids or media_urls; images and videos can be mixed), or `null` to revert to single-post mode."),
         }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
+        telegram: TELEGRAM_OPTIONS,
+        discord: DISCORD_OPTIONS,
+        comment_dm_automation: COMMENT_DM_AUTOMATION.nullable().optional().describe("Replaces the post's comment-to-DM setup (keywords, DM text, public replies, limits, platforms); a channel no longer listed in platforms loses its automation; pass null to remove them all; omit to leave them untouched. Needs the opt-in automations:write scope."),
     }, { title: "Update Post", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async ({ id, ...data }) => {
         const result = await getClient().updatePost(id, data);
         if (result.error) {
@@ -1139,9 +1400,12 @@ Do NOT call without required media — it will fail.`, {
         md += `| **ID** | \`${p.id}\` |\n`;
         md += `| **Status** | ${capitalize(p.status || "—")} |\n`;
         if (schedAt)
-            md += `| **Scheduled** | ${formatDateTime(schedAt)} |\n`;
+            md += `| **${p.status === "draft" ? "Planned for" : "Scheduled"}** | ${formatDateTime(schedAt)} |\n`;
         if (appUrl)
             md += `| **Open in OmniSocials** | ${appUrl} |\n`;
+        if (p.status === "draft" && schedAt) {
+            md += `\n_A planned draft: on the user's calendar at that time, not published until it is scheduled (composer, or update_post with draft: false)._\n`;
+        }
         return {
             content: [{ type: "text", text: md }],
         };
@@ -1176,6 +1440,8 @@ IMPORTANT: Before publishing, verify the post has all required media. If publish
         md += `|-------|-------|\n`;
         md += `| **ID** | \`${p.id}\` |\n`;
         md += `| **Status** | ${capitalize(p.status || "publishing")} |\n`;
+        md += appLinkRow({ ...p, id: p.id || id });
+        md += `\n_Publishing runs in the background, usually within a minute. Share the "Open in OmniSocials" link with the user; \`get_post\` lists the live links once each platform has posted._`;
         return {
             content: [{ type: "text", text: md }],
         };
@@ -1205,6 +1471,7 @@ The retry runs asynchronously (usually within a few minutes). Poll \`get_post\`
         if (Array.isArray(p.platforms) && p.platforms.length) {
             md += `| **Retrying** | ${p.platforms.map((x) => capitalize(x.replace(/_/g, " "))).join(", ")} |\n`;
         }
+        md += appLinkRow({ ...p, id: p.id || id });
         md += `\n_Platforms that already succeeded are never re-published. Check \`get_post\` in a minute or two for the outcome._`;
         return {
             content: [{ type: "text", text: md }],
@@ -1267,6 +1534,7 @@ If this is the workflow's last step, the post is finalized immediately: it moves
         md += `| **ID** | \`${p.id}\` |\n`;
         md += `| **Status** | ${capitalize(p.status || "in_approval")} |\n`;
         md += `| **Approval status** | ${capitalize(p.approval_status || "pending")} |\n`;
+        md += appLinkRow({ ...p, id: p.id || id });
         if (p.message)
             md += `\n${p.message}\n`;
         return {
@@ -1295,6 +1563,7 @@ IMPORTANT: this only succeeds if the connected user is a listed approver for the
         md += `|-------|-------|\n`;
         md += `| **ID** | \`${p?.id || id}\` |\n`;
         md += `| **Status** | Rejected |\n`;
+        md += appLinkRow({ id: p?.id || id, status: "rejected" });
         md += `\n_The approval workflow has stopped. This post will not be published unless it's edited and resubmitted for approval._`;
         return {
             content: [{ type: "text", text: md }],
@@ -1514,9 +1783,9 @@ Notes:
                 md += `No product Pins in this part of the Pin list. Call again with bookmark \`${result.bookmark}\` to scan the next part.\n`;
             }
             else if (fromCatalog) {
-                md += groups.length
-                    ? "This product group has no products.\n"
-                    : "The Pinterest account has no catalog. Try source \"pins\", or pass a product Pin link as check_pin.\n";
+                md += result?.no_catalog || !groups.length
+                    ? "The Pinterest account has no catalog yet. The user adds products at https://www.pinterest.com/business/catalogs/ (then call again). Until then, try source \"pins\", or pass a product Pin link as check_pin.\n"
+                    : "This product group has no products.\n";
             }
             else {
                 md += "No product Pins found. A product Pin comes from the Pinterest catalog, or links to a product page on a website the account claimed on Pinterest.\n";