@omnisocials/mcp-server 1.21.0 → 1.23.0

package/README.md

@@ -188,7 +188,7 @@ Apply a set when creating a post: `create_post` / `create_and_publish_post` acce
 
 | Tool | Description |
 |------|-------------|
-| `list_inbox_conversations` | List conversations — Instagram/Facebook DMs, comments, mentions, and LinkedIn company-page comments/mentions; filter by platform, type, or unread |
+| `list_inbox_conversations` | List conversations — Instagram/Facebook DMs, comments, mentions, LinkedIn company-page comments/mentions, TikTok video comments, and X DMs (opt-in); filter by platform, type, or unread |
 | `get_inbox_conversation` | Get a conversation's full message history |
 | `mark_inbox_read` | Mark all incoming messages in a conversation as read |
 | `reply_to_inbox` | Reply to a DM, comment, or mention (existing conversations only) |

package/build/client.d.ts

@@ -101,11 +101,16 @@ export interface MastodonPostOptionsUpdate {
     thread_parts?: MastodonThreadPartInput[] | null;
 }
 /** Non-sponsored LinkedIn poll: question + 2-4 options + duration. */
-export interface LinkedInPollInput {
+export interface LinkedInPollFields {
     question: string;
     options: string[];
     duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
 }
+/** LinkedIn poll(s), independent per channel. A channel's poll is omitted/null when it isn't a poll. */
+export interface LinkedInPollInput {
+    linkedin?: LinkedInPollFields | null;
+    linkedin_page?: LinkedInPollFields | null;
+}
 /**
  * Request body for POST /posts/create. `createAndPublishPost` accepts the
  * same shape minus `scheduled_at` (publishing is immediate).

package/build/tools/inbox.js

@@ -4,12 +4,13 @@ const PLATFORM_EMOJI = {
     instagram: "📸",
     facebook: "📘",
     linkedin: "💼",
+    tiktok: "🎵",
     x: "🐦",
 };
 export function registerInboxTools(server, getClient) {
-    server.tool("list_inbox_conversations", "List social inbox conversations (Instagram/Facebook DMs, comments, mentions, LinkedIn company-page comments/mentions, and X DMs where the workspace has opted into X DMs), newest activity first. Cursor-paginated: pass the returned cursor to get the next page.", {
+    server.tool("list_inbox_conversations", "List social inbox conversations (Instagram/Facebook DMs, comments, mentions, LinkedIn company-page comments/mentions, TikTok video comments, and X DMs where the workspace has opted into X DMs), newest activity first. Cursor-paginated: pass the returned cursor to get the next page.", {
         platform: z
-            .enum(["instagram", "facebook", "linkedin", "x"])
+            .enum(["instagram", "facebook", "linkedin", "tiktok", "x"])
             .optional()
             .describe("Filter to one platform"),
         type: z
@@ -137,9 +138,11 @@ export function registerInboxTools(server, getClient) {
             ],
         };
     });
-    server.tool("reply_to_inbox", "Reply to an existing inbox conversation (DM, comment, or mention) on Instagram, Facebook, LinkedIn, or X. You can only reply to conversations that already exist. Meta direct-message replies must be within the platform's 24-hour messaging window. X replies are DM-only and use 2 prepaid credits per send (X's API fee passed through at cost) — a 402 insufficient_credits error means the organisation needs to top up at https://app.omnisocials.com/credits; relay that link to the user rather than retrying. Each workspace can send up to 1,000 replies per day.", {
+    server.tool("reply_to_inbox", "Reply to an existing inbox conversation (DM, comment, or mention) on Instagram, Facebook, LinkedIn, TikTok, or X. You can only reply to conversations that already exist. Meta direct-message replies must be within the platform's 24-hour messaging window. TikTok replies are comments only, text-only, and capped at 150 characters; they can take a few minutes to appear on TikTok while they pass spam review. X replies are DM-only and use 2 prepaid credits per send (X's API fee passed through at cost) — a 402 insufficient_credits error means the organisation needs to top up at https://app.omnisocials.com/credits; relay that link to the user rather than retrying. Each workspace can send up to 1,000 replies per day.", {
         conversation_id: z.string().describe("The conversation ID to reply to"),
-        text: z.string().describe("The reply text (max 2000 characters)"),
+        text: z
+            .string()
+            .describe("The reply text (max 2000 characters; TikTok comments max 150)"),
     }, async ({ conversation_id, text }) => {
         const result = await getClient().replyToInboxConversation(conversation_id, {
             text,

package/build/tools/posts.js

@@ -83,8 +83,7 @@ const LINKEDIN_PAGE_OPTIONS = z
 })
     .optional()
     .describe("LinkedIn Company Page options");
-const LINKEDIN_POLL_OPTIONS = z
-    .object({
+const LINKEDIN_POLL_FIELDS = z.object({
     question: z.string().max(140).describe("The poll question (max 140 characters)."),
     options: z
         .array(z.string().max(30))
@@ -94,10 +93,19 @@ const LINKEDIN_POLL_OPTIONS = z
     duration: z
         .enum(["ONE_DAY", "THREE_DAYS", "SEVEN_DAYS", "FOURTEEN_DAYS"])
         .describe("How long the poll stays open for votes."),
+});
+const LINKEDIN_POLL_OPTIONS = z
+    .object({
+    linkedin: LINKEDIN_POLL_FIELDS.nullable()
+        .optional()
+        .describe("Poll for the personal profile post. Omit or null = not a poll."),
+    linkedin_page: LINKEDIN_POLL_FIELDS.nullable()
+        .optional()
+        .describe("Poll for the company page post. Omit or null = not a poll."),
 })
     .nullable()
     .optional()
-    .describe("Non-sponsored LinkedIn poll, posted to whichever of `linkedin`/`linkedin_page` is selected in `accounts`. Mutually exclusive with media and a link share — a poll takes priority over both at publish time. Still requires `content.linkedin` (or `content.default`) as the post's caption; the poll itself only carries the question/options/duration. Pass `null` on update_post to clear a poll and revert to a normal post.");
+    .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.");
 // 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,
@@ -133,7 +141,7 @@ const USER_TAG_ENTRY = z.object({
 // z.array(...).min(2).max(25)[.nullable()].optional().describe(...) stays
 // per-tool (update_post allows null to clear the thread).
 const X_THREAD_PART = z.object({
-    text: z.string().describe("Tweet text (≤ 280 chars). X counts every link as 23 characters (its t.co length), so a short link still uses 23 toward the limit."),
+    text: z.string().describe("Tweet text (≤ 280 chars by X's weighted count). X counts every link as 23 characters (its t.co length) and every emoji or non-Latin symbol (🚀, …, ₹, CJK) as 2 — so text that looks under 280 can still be over. When trimming generated copy to fit, leave headroom instead of cutting to exactly 280 raw characters."),
     media_ids: z.array(mediaIdEntry).max(4).optional().describe("Per-tweet media as Library IDs from upload_media (max 4 combined with media_urls). Each entry is a plain ID string or { id, alt } to attach alt text (X applies it to photos/GIFs). Attach your uploaded graphics to any tweet in the thread."),
     media_urls: z.array(mediaUrlEntry).max(4).optional().describe("Per-tweet media as external URLs (max 4 combined with media_ids). Each entry is a plain URL string or { url, alt } to attach alt text (X applies it to photos/GIFs)."),
 });
@@ -274,7 +282,7 @@ export function registerPostTools(server, getClient) {
             content: [{ type: "text", text: md }],
         };
     });
-    server.tool("get_post", "Get details of a specific post by ID — content, channels, media (with URLs + any per-media alt text), first comment, Instagram collaborators/user tags/location/Trial Reel state/Reel cover (thumbnail_type + thumb_offset in ms), dates and live URLs, enough to fully verify a scheduled post without opening the dashboard. When a post has per-platform caption overrides (e.g. a shorter X version alongside the default), every variant is rendered as its own labeled block under `### Content` so you can see exactly what each platform will publish. X threads are rendered under `### X Thread` with each tweet labeled in publish order — read this to see the full chained tweet text, since thread-only posts have no caption in `content`. A LinkedIn poll is rendered under `### LinkedIn Poll` with the question, options, and duration. After publishing, includes `published_urls` — a map of platform → live URL for each platform that successfully posted (e.g. facebook, instagram, linkedin, x). Useful for polling: when a post's status is `published`, read `published_urls` to surface the live links.", {
+    server.tool("get_post", "Get details of a specific post by ID — content, channels, media (with URLs + any per-media alt text), first comment, Instagram collaborators/user tags/location/Trial Reel state/Reel cover (thumbnail_type + thumb_offset in ms), dates and live URLs, enough to fully verify a scheduled post without opening the dashboard. When a post has per-platform caption overrides (e.g. a shorter X version alongside the default), every variant is rendered as its own labeled block under `### Content` so you can see exactly what each platform will publish. X threads are rendered under `### X Thread` with each tweet labeled in publish order — read this to see the full chained tweet text, since thread-only posts have no caption in `content`. A LinkedIn poll is rendered under `### LinkedIn Profile Poll` and/or `### LinkedIn Page Poll` (independent per channel) with the question, options, and duration. After publishing, includes `published_urls` — a map of platform → live URL for each platform that successfully posted (e.g. facebook, instagram, linkedin, x). Useful for polling: when a post's status is `published`, read `published_urls` to surface the live links.", {
         id: z.string().describe("The post ID"),
     }, async ({ id }) => {
         const result = await getClient().getPost(id);
@@ -407,11 +415,15 @@ export function registerPostTools(server, getClient) {
                 md += `\n`;
             }
         }
-        // LinkedIn poll: mutually exclusive with media/link-share, so surface
-        // it prominently rather than leaving callers to infer it's a poll.
-        if (p.linkedin_poll?.question) {
-            const poll = p.linkedin_poll;
-            md += `\n\n### LinkedIn Poll\n\n`;
+        // LinkedIn poll(s): independent per channel, mutually exclusive with
+        // media/link-share on that channel, so surface each prominently
+        // rather than leaving callers to infer it's a poll.
+        for (const channel of ["linkedin", "linkedin_page"]) {
+            const poll = p.linkedin_poll?.[channel];
+            if (!poll?.question)
+                continue;
+            const label = channel === "linkedin_page" ? "LinkedIn Page" : "LinkedIn Profile";
+            md += `\n\n### ${label} Poll\n\n`;
             md += `**${poll.question}**\n\n`;
             for (const option of poll.options || []) {
                 md += `- ${option}\n`;
@@ -511,10 +523,11 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - Other platforms (LinkedIn, LinkedIn Page, X, Bluesky, etc.): Media is optional.
 
    **Per-platform max media items (enforced at submit, returns 400 validation_error if exceeded):**
-   - Bluesky, X, Mastodon — max **4** items per post
-   - Instagram, Threads — max **10** items per carousel
+   - Bluesky, X, Mastodon — max **4** items per post; cannot mix images and video
+   - Instagram, Threads — max **10** items per carousel; images and videos CAN be mixed in one carousel
    - TikTok — max **35** photos per photo-post; cannot mix photos and videos in one post
-   - Pinterest carousel — 2–5 images, all same aspect ratio
+   - 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)
 
    **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** (X also can't mix a video with images in one tweet: a tweet is either 1 video OR up to 4 images)
@@ -674,7 +687,7 @@ 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 with no photo/video mix, Pinterest carousel 2–5 same-ratio images.
+   - **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** (no video+image mix in one tweet), Bluesky 180s, Threads 5min, Instagram 15min, TikTok 10min, YouTube Short 3min, LinkedIn 10min, Facebook Reel 90s.
 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). 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.

package/build/types.d.ts

@@ -28,7 +28,7 @@ export interface InboxParticipant {
 }
 export interface InboxConversation {
     conversation_id: string;
-    platform: "instagram" | "facebook" | "linkedin";
+    platform: "instagram" | "facebook" | "linkedin" | "tiktok" | "x";
     type: "dm" | "comment" | "mention";
     participant: InboxParticipant;
     unread_count: number;
@@ -152,11 +152,18 @@ export interface ApiPost {
     facebook?: ApiPlatformOptionsOut;
     linkedin?: ApiPlatformOptionsOut;
     linkedin_page?: ApiPlatformOptionsOut;
-    /** Non-sponsored LinkedIn poll echoed back after create/update/publish. */
+    /** Non-sponsored LinkedIn poll(s), independent per channel — echoed back after create/update/publish. */
     linkedin_poll?: {
-        question: string;
-        options: string[];
-        duration: string;
+        linkedin?: {
+            question: string;
+            options: string[];
+            duration: string;
+        } | null;
+        linkedin_page?: {
+            question: string;
+            options: string[];
+            duration: string;
+        } | null;
     } | null;
     tiktok?: ApiPlatformOptionsOut;
     google_business?: ApiPlatformOptionsOut;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
   "main": "build/index.js",
@@ -19,11 +19,24 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
+    "model-context-protocol",
     "omnisocials",
     "social-media",
+    "social-media-scheduling",
+    "scheduling",
     "claude",
-    "model-context-protocol",
-    "ai"
+    "ai",
+    "instagram",
+    "facebook",
+    "linkedin",
+    "tiktok",
+    "youtube",
+    "twitter",
+    "pinterest",
+    "bluesky",
+    "threads",
+    "mastodon"
   ],
   "homepage": "https://docs.omnisocials.com",
   "engines": {