@omnisocials/mcp-server 1.20.1 → 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

@@ -100,6 +100,17 @@ export interface MastodonPostOptions {
 export interface MastodonPostOptionsUpdate {
     thread_parts?: MastodonThreadPartInput[] | null;
 }
+/** Non-sponsored LinkedIn poll: question + 2-4 options + duration. */
+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).
@@ -130,6 +141,7 @@ export interface CreatePostInput {
     facebook?: Record<string, unknown>;
     linkedin?: Record<string, unknown>;
     linkedin_page?: Record<string, unknown>;
+    linkedin_poll?: LinkedInPollInput | null;
     tiktok?: Record<string, unknown>;
     x?: XPostOptions;
     bluesky?: BlueskyPostOptions;
@@ -183,6 +195,7 @@ export declare class OmniSocialsClient {
         facebook?: Record<string, unknown>;
         linkedin?: Record<string, unknown>;
         linkedin_page?: Record<string, unknown>;
+        linkedin_poll?: LinkedInPollInput | null;
         tiktok?: Record<string, unknown>;
         x?: XPostOptionsUpdate;
         bluesky?: BlueskyPostOptionsUpdate;

package/build/index.js

@@ -29,7 +29,7 @@ const sessionState = { activeIndex: 0 };
 const getActiveClient = () => workspaceClients[sessionState.activeIndex].client;
 const server = new McpServer({
     name: "OmniSocials",
-    version: "1.20.0",
+    version: "1.21.0",
 });
 // Register all tools - pass getter function so tools always use the active workspace's client
 registerPostTools(server, getActiveClient);

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,6 +83,29 @@ const LINKEDIN_PAGE_OPTIONS = z
 })
     .optional()
     .describe("LinkedIn Company Page options");
+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))
+        .min(2)
+        .max(4)
+        .describe("2-4 answer options (max 30 characters each)."),
+    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(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,
@@ -259,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`. 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);
@@ -392,6 +415,21 @@ export function registerPostTools(server, getClient) {
                 md += `\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`;
+            }
+            md += `\n_Duration: ${poll.duration}_\n`;
+        }
         const publishedUrls = (p.published_urls && typeof p.published_urls === "object" && !Array.isArray(p.published_urls))
             ? p.published_urls
             : {};
@@ -559,6 +597,7 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
         facebook: FACEBOOK_OPTIONS,
         linkedin: LINKEDIN_OPTIONS,
         linkedin_page: LINKEDIN_PAGE_OPTIONS,
+        linkedin_poll: LINKEDIN_POLL_OPTIONS,
         tiktok: TIKTOK_OPTIONS,
         x: z.object({
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
@@ -698,6 +737,7 @@ Do NOT call without required media — it will fail.`, {
         facebook: FACEBOOK_OPTIONS,
         linkedin: LINKEDIN_OPTIONS,
         linkedin_page: LINKEDIN_PAGE_OPTIONS,
+        linkedin_poll: LINKEDIN_POLL_OPTIONS,
         tiktok: TIKTOK_OPTIONS,
         x: z.object({
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
@@ -803,6 +843,7 @@ Do NOT call without required media — it will fail.`, {
         facebook: FACEBOOK_OPTIONS,
         linkedin: LINKEDIN_OPTIONS,
         linkedin_page: LINKEDIN_PAGE_OPTIONS,
+        linkedin_poll: LINKEDIN_POLL_OPTIONS,
         tiktok: TIKTOK_OPTIONS,
         x: z.object({
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),

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,6 +152,19 @@ export interface ApiPost {
     facebook?: ApiPlatformOptionsOut;
     linkedin?: ApiPlatformOptionsOut;
     linkedin_page?: ApiPlatformOptionsOut;
+    /** Non-sponsored LinkedIn poll(s), independent per channel — echoed back after create/update/publish. */
+    linkedin_poll?: {
+        linkedin?: {
+            question: string;
+            options: string[];
+            duration: string;
+        } | null;
+        linkedin_page?: {
+            question: string;
+            options: string[];
+            duration: string;
+        } | null;
+    } | null;
     tiktok?: ApiPlatformOptionsOut;
     google_business?: ApiPlatformOptionsOut;
     x?: ApiPlatformOptionsOut;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.20.1",
+  "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",