@omnisocials/mcp-server 1.21.0 → 1.22.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,
@@ -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`;

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.22.0",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
   "main": "build/index.js",