@omnisocials/mcp-server 1.48.0 → 1.49.0

package/README.md

@@ -109,7 +109,7 @@ OmniSocials accepts the following channel IDs in `create_post`, `create_and_publ
 | `tiktok` | TikTok | Posts and reels |
 | `pinterest` | Pinterest | Pins (requires `board_id`) |
 | `x` | X (Twitter) | Posts, chained threads via `x.thread_parts` |
-| `threads` | Threads | Posts, chained threads via `threads.thread_parts`, location tagging via `threads.location_id` (rolling out) |
+| `threads` | Threads | Posts, chained threads via `threads.thread_parts`, a topic via `threads.topic_tag`, polls via `threads.poll`, location tagging via `threads.location_id` (rolling out) |
 | `bluesky` | Bluesky | Posts, chained threads via `bluesky.thread_parts` |
 | `mastodon` | Mastodon | Posts, chained threads via `mastodon.thread_parts` |
 | `telegram` | Telegram | A channel or group the OmniSocials bot posts to: text, photos, videos, GIFs, albums of up to 10, native polls and link buttons via `telegram` |
@@ -244,6 +244,10 @@ Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
 ## Changelog
 
+### 1.49.0 (2026-10-27)
+
+- **Added: the Threads topic.** `threads.topic_tag` on `create_post`, `create_and_publish_post` and `update_post` (one topic per post, 1 to 50 characters, spaces allowed, no period or ampersand; `null` removes it on update). `get_post` shows it.
+
 ### 1.48.0 (2026-10-26)
 
 - **Added: video retention in `get_post_analytics`:** a `3-second hold (%)` row (`hold_rate_3s`: TikTok videos with TikTok comments enabled, Facebook Reels, Instagram Reels as 100 minus `skip_rate`) and a `Still watching` row that sums up the retention curve of TikTok videos and Facebook Reels and videos (1, 3, 5, 10, 15, 30 seconds and each quarter). Instagram and YouTube give no curve through their APIs.

package/build/client.d.ts

@@ -246,6 +246,9 @@ export interface ThreadsPostOptions {
      * the tag goes on the first post. Needs the threads_location_tagging
      * permission on the Threads connection. */
     location_id?: string | null;
+    /** The topic of the post on Threads (1 to 50 characters, no period and
+     * no ampersand; spaces allowed). On a thread it goes on the first post. */
+    topic_tag?: string | null;
 }
 /**
  * Update-side variant: `thread_parts: null` clears the thread (revert to a
@@ -257,6 +260,8 @@ export interface ThreadsPostOptionsUpdate {
     /** New Threads location id, or null to remove the tag. Omit to leave the
      * existing tag untouched. */
     location_id?: string | null;
+    /** New Threads topic, or null to remove it. Omit to leave it untouched. */
+    topic_tag?: string | null;
 }
 /** Non-sponsored LinkedIn poll: question + 2-4 options + duration. */
 export interface LinkedInPollFields {

package/build/index.js

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

package/build/tools/posts.js

@@ -207,6 +207,13 @@ const THREADS_POLL_OPTIONS = z
     .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.");
+// The Threads topic (2026-10-26): `threads.topic_tag`, one per post.
+const THREADS_TOPIC_TAG = z
+    .string()
+    .max(50)
+    .nullable()
+    .optional()
+    .describe("The topic of the post on Threads, one per post, e.g. \"Build in public\". Unlike a #tag in the text it can hold spaces. 1 to 50 characters, no period (.) and no ampersand (&); a leading # is dropped. On a multi-post thread the topic goes on the first post. On update_post, pass null to remove 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)."),
@@ -568,6 +575,10 @@ export function registerPostTools(server, getClient) {
             const locBits = [threadsLoc.name, threadsLoc.city, threadsLoc.country].filter(Boolean).join(", ");
             md += `| **Threads location** | ${locBits ? `${locBits} ` : ""}\`${threadsLoc.id}\` |\n`;
         }
+        const threadsTopic = p.threads?.topic_tag;
+        if (typeof threadsTopic === "string" && threadsTopic) {
+            md += `| **Threads topic** | ${threadsTopic} |\n`;
+        }
         if (Array.isArray(p.collaborators) && p.collaborators.length) {
             md += `| **IG collaborators** | ${p.collaborators.map((c) => `@${c}`).join(", ")} |\n`;
         }
@@ -1073,9 +1084,10 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
         }).optional().describe("Mastodon options"),
         threads: z.object({
             poll: THREADS_POLL_OPTIONS,
+            topic_tag: THREADS_TOPIC_TAG,
             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`."),
+        }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`, a poll via `poll`, the topic via `topic_tag`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
         telegram: TELEGRAM_OPTIONS,
         discord: DISCORD_OPTIONS,
@@ -1249,9 +1261,10 @@ Do NOT call without required media — it will fail.`, {
         }).optional().describe("Mastodon options"),
         threads: z.object({
             poll: THREADS_POLL_OPTIONS,
+            topic_tag: THREADS_TOPIC_TAG,
             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`."),
+        }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`, a poll via `poll`, the topic via `topic_tag`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
         telegram: TELEGRAM_OPTIONS,
         discord: DISCORD_OPTIONS,
@@ -1372,9 +1385,10 @@ Do NOT call without required media — it will fail.`, {
         }).optional().describe("Mastodon options"),
         threads: z.object({
             poll: THREADS_POLL_OPTIONS,
+            topic_tag: THREADS_TOPIC_TAG,
             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`."),
+        }).optional().describe("Threads (Meta) options: thread mode via `thread_parts`, location tag via `location_id`, a poll via `poll`, the topic via `topic_tag`."),
         google_business: GOOGLE_BUSINESS_OPTIONS,
         telegram: TELEGRAM_OPTIONS,
         discord: DISCORD_OPTIONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.48.0",
+  "version": "1.49.0",
   "mcpName": "io.github.omnisocials/mcp-server",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",