@omnisocials/mcp-server 1.50.0 → 1.51.1

package/README.md

@@ -157,6 +157,17 @@ OmniSocials accepts the following channel IDs in `create_post`, `create_and_publ
 | `update_hashtag_set` | Rename a set and/or replace its tags |
 | `delete_hashtag_set` | Delete a set (existing posts keep their hashtags) |
 
+### Tags (6 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_tags` | List the workspace's post tags |
+| `create_tag` | Create a tag ("Question hook", "Talking head") |
+| `update_tag` | Rename or recolour a tag |
+| `delete_tag` | Delete a tag (it comes off every post; the posts stay) |
+| `tag_posts` | Add, remove or replace the tags of up to 500 posts at once, published posts included |
+| `get_tag_analytics` | Compare tags: posts, median impressions, engagement rate and how far above or below your normal, per channel |
+
 Apply a set when creating a post: `create_post` / `create_and_publish_post` accept `hashtag_set` (the set name), `hashtag_placement` (`caption_append` default, or `first_comment` to keep tags out of the caption where supported), and `hashtag_platforms` (subset of channels).
 
 ### Accounts (2 tools)
@@ -245,6 +256,10 @@ Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
 ## Changelog
 
+### 1.51.0 (2026-11-02)
+
+- **Added: post tags.** `list_tags`, `create_tag`, `update_tag`, `delete_tag`, `tag_posts` and `get_tag_analytics` (how each tag did against your normal, per channel). `tags` on `create_post`, `create_and_publish_post` and `update_post`, `tag` on `list_posts` and `get_analytics_overview`. `get_post` and `list_posts` show tags and mark Instagram trial reels.
+
 ### 1.50.0 (2026-10-27)
 
 - **Added: `like_inbox_comment`.** Like (or unlike with `like: false`) a Facebook, LinkedIn Page or TikTok comment as the connected account. Facebook allows a Like only. Inbox messages carry `liked`.

package/build/client.d.ts

@@ -1,4 +1,4 @@
-import type { Account, AnalyticsOverview, AccountAnalyticsEntry, ApiPost, ApiResponse, ApiVideoCover, AudioSearchResult, Automation, AutomationEvent, AutomationEventOutcome, AutomationEventsResult, AutomationInput, AutomationPlatform, BestTimesResult, CommentDmAutomationInput, HashtagSet, LocationSearchResult, PinterestProductCheck, PinterestProductsResult, MediaCheckResult, MediaCompatibility, MediaFolder, MediaItem, PdfUploadResult, PostAnalytics, PublishPostResult, RecentPlatformPost, RetryPostResult, ApprovePostResult, RejectPostResult, PostApproval, InboxConversation, InboxDeleteResult, InboxMessage, InboxNextUnanswered, Webhook } from "./types.js";
+import type { Account, AnalyticsOverview, AccountAnalyticsEntry, ApiPost, ApiResponse, ApiVideoCover, AudioSearchResult, Automation, AutomationEvent, AutomationEventOutcome, AutomationEventsResult, AutomationInput, AutomationPlatform, BestTimesResult, CommentDmAutomationInput, HashtagSet, Tag, TagAnalytics, TagApplyResult, LocationSearchResult, PinterestProductCheck, PinterestProductsResult, MediaCheckResult, MediaCompatibility, MediaFolder, MediaItem, PdfUploadResult, PostAnalytics, PublishPostResult, RecentPlatformPost, RetryPostResult, ApprovePostResult, RejectPostResult, PostApproval, InboxConversation, InboxDeleteResult, InboxMessage, InboxNextUnanswered, Webhook } from "./types.js";
 export declare function fetchImageAsBase64(url: string): Promise<{
     data: string;
     mimeType: string;
@@ -8,6 +8,8 @@ export declare function formatBytes(bytes: number): string;
 export declare function formatDate(iso: string | null): string;
 export declare function formatDateTime(iso: string | null): string;
 export declare function truncate(value: unknown, len: number): string;
+export declare function cutText(value: unknown, max: number): string;
+export declare function wellFormed<T>(value: T): T;
 export declare function capitalize(str: string): string;
 /** Rates, averages and lengths: shown per platform, never added up across
  * platforms (two 60% hold rates are not 120%). Mirrors
@@ -355,6 +357,7 @@ export declare class OmniSocialsClient {
         status?: string;
         limit?: string;
         offset?: string;
+        tag?: string;
     }): Promise<ApiResponse<ApiPost[]>>;
     getPost(id: string): Promise<ApiResponse<ApiPost>>;
     getRecentPlatformPosts(params?: {
@@ -476,6 +479,31 @@ export declare class OmniSocialsClient {
         parent_id?: string;
     }): Promise<ApiResponse<MediaFolder>>;
     listApprovalWorkflows(): Promise<ApiResponse<ApprovalWorkflow[]>>;
+    listTags(): Promise<ApiResponse<Tag[]>>;
+    createTag(data: {
+        name: string;
+        color?: string;
+    }): Promise<ApiResponse<Tag>>;
+    updateTag(id: string, data: {
+        name?: string;
+        color?: string;
+    }): Promise<ApiResponse<Tag>>;
+    deleteTag(id: string): Promise<ApiResponse<{
+        tag: Tag;
+        posts_untagged: number;
+    }>>;
+    applyTags(data: {
+        post_ids: string[];
+        add?: string[];
+        remove?: string[];
+        set?: string[];
+    }): Promise<ApiResponse<TagApplyResult>>;
+    getTagAnalytics(params?: {
+        start_date?: string;
+        end_date?: string;
+        platform?: string;
+        min_posts?: string;
+    }): Promise<ApiResponse<TagAnalytics>>;
     listHashtagSets(): Promise<ApiResponse<HashtagSet[]>>;
     createHashtagSet(data: {
         name: string;
@@ -512,6 +540,7 @@ export declare class OmniSocialsClient {
         period?: string;
         start_date?: string;
         end_date?: string;
+        tag?: string;
     }): Promise<ApiResponse<AnalyticsOverview> & {
         period?: string;
         start_date?: string;

package/build/client.js

@@ -84,7 +84,37 @@ export function truncate(value, len) {
     if (!str)
         return "";
     const clean = str.replace(/\n/g, " ");
-    return clean.length > len ? clean.slice(0, len - 1) + "…" : clean;
+    // Count and cut on code points: a UTF-16 slice can split an emoji.
+    const chars = Array.from(clean);
+    return chars.length > len ? chars.slice(0, len - 1).join("") + "…" : clean;
+}
+// Text this server sends must be well-formed UTF-16. Half an emoji (a lone
+// surrogate) is legal in a JS string and JSON.stringify writes it as
+// "\ud83c", but strict JSON readers (Rust serde_json, Python clients that
+// validate with pydantic) refuse it and drop the connection: "Transport
+// closed" instead of an answer (2026-11-03, a drafts list cut a preview
+// through an emoji). cutText cuts on code points; wellFormed turns any lone
+// surrogate left in a tool result into U+FFFD (a regex: Node 18 has no
+// String.prototype.toWellFormed).
+const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
+export function cutText(value, max) {
+    if (typeof value !== "string")
+        return "";
+    const chars = Array.from(value);
+    return chars.length > max ? chars.slice(0, max).join("") : value;
+}
+export function wellFormed(value) {
+    if (typeof value === "string")
+        return value.replace(LONE_SURROGATE, "\uFFFD");
+    if (Array.isArray(value))
+        return value.map(wellFormed);
+    if (value && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype) {
+        const out = {};
+        for (const [key, item] of Object.entries(value))
+            out[key] = wellFormed(item);
+        return out;
+    }
+    return value;
 }
 export function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
@@ -466,6 +496,25 @@ export class OmniSocialsClient {
         return this.request("GET", "/approval-workflows");
     }
     // Hashtag Sets
+    // Post tags (2026-11-02)
+    async listTags() {
+        return this.request("GET", "/tags");
+    }
+    async createTag(data) {
+        return this.request("POST", "/tags", data);
+    }
+    async updateTag(id, data) {
+        return this.request("PATCH", `/tags/${id}`, data);
+    }
+    async deleteTag(id) {
+        return this.request("DELETE", `/tags/${id}`);
+    }
+    async applyTags(data) {
+        return this.request("POST", "/tags/apply", data);
+    }
+    async getTagAnalytics(params) {
+        return this.request("GET", "/analytics/tags", undefined, params);
+    }
     async listHashtagSets() {
         return this.request("GET", "/hashtag-sets");
     }

package/build/index.js

@@ -2,13 +2,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { OmniSocialsClient } from "./client.js";
+import { OmniSocialsClient, wellFormed } from "./client.js";
 import { registerPostTools } from "./tools/posts.js";
 import { registerMediaTools } from "./tools/media.js";
 import { registerAccountTools } from "./tools/accounts.js";
 import { registerAnalyticsTools } from "./tools/analytics.js";
 import { registerWebhookTools } from "./tools/webhooks.js";
 import { registerHashtagSetTools } from "./tools/hashtag-sets.js";
+import { registerTagTools } from "./tools/tags.js";
 import { registerAutomationTools } from "./tools/automations.js";
 import { registerInboxTools } from "./tools/inbox.js";
 import { registerWorkspaceTools } from "./tools/workspaces.js";
@@ -30,8 +31,16 @@ const sessionState = { activeIndex: 0 };
 const getActiveClient = () => workspaceClients[sessionState.activeIndex].client;
 const server = new McpServer({
     name: "OmniSocials",
-    version: "1.50.0",
+    version: "1.51.1",
 });
+const rawTool = server.tool.bind(server);
+server.tool = (...args) => {
+    const cb = args[args.length - 1];
+    if (typeof cb === "function") {
+        args[args.length - 1] = async (...a) => wellFormed(await cb(...a));
+    }
+    return rawTool(...args);
+};
 // Register all tools - pass getter function so tools always use the active workspace's client
 registerPostTools(server, getActiveClient);
 registerMediaTools(server, getActiveClient);
@@ -39,6 +48,7 @@ registerAccountTools(server, getActiveClient);
 registerAnalyticsTools(server, getActiveClient);
 registerWebhookTools(server, getActiveClient);
 registerHashtagSetTools(server, getActiveClient);
+registerTagTools(server, getActiveClient);
 registerAutomationTools(server, getActiveClient);
 registerInboxTools(server, getActiveClient);
 registerWorkspaceTools(server, workspaceClients, sessionState);

package/build/tools/analytics.js

@@ -181,6 +181,7 @@ export function registerAnalyticsTools(server, getClient) {
         period: z.string().optional().describe("Rolling window: 7d, 30d, 90d (default: 30d). Ignored if start_date/end_date are provided."),
         start_date: z.string().optional().describe('Custom start date. Accepts "YYYY-MM-DD" (e.g. "2026-04-01") or "YYYY-MM" month-shorthand (e.g. "2026-04" → first of the month).'),
         end_date: z.string().optional().describe('Custom end date. Same formats as start_date; "YYYY-MM" expands to the last day of the month.'),
+        tag: z.string().optional().describe("Post numbers of the posts with this tag only (a tag name or id; comma separate several). Account numbers stay the whole account's. To compare tags with each other, use get_tag_analytics."),
     }, { title: "Get Analytics Overview", readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (params) => {
         const result = await getClient().getAnalyticsOverview(params);
         if (result.error) {

package/build/tools/hashtag-sets.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { cutText } from "../client.js";
 export function registerHashtagSetTools(server, getClient) {
     server.tool("list_hashtag_sets", "List the saved hashtag sets in this workspace. Apply one to a new post by passing its name via create_post (hashtag_set) — the tags are appended to the captions or, with hashtag_placement='first_comment', posted as the auto first comment.", {}, { title: "List Hashtag Sets", readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async () => {
         const result = await getClient().listHashtagSets();
@@ -17,7 +18,7 @@ export function registerHashtagSetTools(server, getClient) {
         md += `| Set ID | Name | Tags | Preview |\n`;
         md += `|--------|------|------|---------|\n`;
         for (const s of sets) {
-            const preview = (s.preview || "").length > 80 ? `${s.preview.slice(0, 77)}…` : s.preview || "";
+            const preview = Array.from(s.preview || "").length > 80 ? `${cutText(s.preview, 77)}…` : s.preview || "";
             md += `| \`${s.id}\` | ${s.name} | ${s.hashtag_count} | ${preview} |\n`;
         }
         md += `\nApply a set with create_post (hashtag_set="<name>"). Edit with update_hashtag_set.`;

package/build/tools/inbox.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { formatDateTime } from "../client.js";
+import { cutText, formatDateTime } from "../client.js";
 const PLATFORM_EMOJI = {
     instagram: "📸",
     facebook: "📘",
@@ -41,7 +41,7 @@ function renderInboxPost(post) {
     }
     md += `\n`;
     if (post.caption) {
-        md += `> ${post.caption.replace(/\s*\n+\s*/g, " ").slice(0, 600)}\n`;
+        md += `> ${cutText(post.caption.replace(/\s*\n+\s*/g, " "), 600)}\n`;
     }
     if (post.url)
         md += `🔗 ${post.url}\n`;
@@ -148,7 +148,7 @@ export function registerInboxTools(server, getClient) {
         md += `|----------|------|------|--------|----------------|----------------|\n`;
         for (const c of convos) {
             const who = c.participant?.name || c.participant?.username || "Unknown";
-            const text = (c.last_message?.text || "").replace(/\n/g, " ").slice(0, 40);
+            const text = cutText((c.last_message?.text || "").replace(/\n/g, " "), 40);
             md += `| ${PLATFORM_EMOJI[c.platform] || ""} ${c.platform} | ${c.type} | ${who} | ${c.unread_count || 0} | ${text} | \`${c.conversation_id}\` |\n`;
         }
         if (result.pagination?.next_cursor) {

package/build/tools/posts.js

@@ -22,6 +22,10 @@ const COMMENT_DM_AUTOMATION = z.object({
         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.");
+// Post tags (2026-11-02): the workspace's own labels to compare posts.
+const POST_TAGS = z.array(z.string()).max(20).describe("Tags for this post: tag names or ids, e.g. [\"Question hook\", \"Talking head\"]; a name that does not exist yet becomes a new tag. Tags are the workspace's own labels (a hook style, a format, a campaign) to filter and compare posts in Analytics (get_tag_analytics); nothing goes to a platform. Use list_tags to see the existing ones and reuse their exact names.");
+const tagLabel = (t) => t.name;
+const tagsLine = (p) => Array.isArray(p.tags) && p.tags.length ? `| **Tags** | ${p.tags.map(tagLabel).join(", ")} |\n` : "";
 const commentDmLine = (p) => {
     const a = p.comment_dm_automation;
     if (!a)
@@ -457,6 +461,7 @@ export function registerPostTools(server, getClient) {
         status: z.string().optional().describe("Filter by status: draft, in_approval, scheduled, posting, published, failed, warning. in_approval = waiting for a reviewer in an approval workflow."),
         limit: z.string().optional().describe("Max results to return (default: 20)"),
         offset: z.string().optional().describe("Offset for pagination"),
+        tag: z.string().optional().describe("Only posts with this tag: a tag name or id; comma separate several for any of them. See list_tags."),
     }, { title: "List Posts", readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (params) => {
         const result = await getClient().listPosts(params);
         if (result.error) {
@@ -510,6 +515,10 @@ export function registerPostTools(server, getClient) {
             const channels = selectedChannels(p).join(", ") || "—";
             const status = capitalize(p.status || "—");
             const date = formatDateTime(displayDate(p));
+            if (Array.isArray(p.tags) && p.tags.length)
+                content += ` *[${p.tags.map(tagLabel).join(", ")}]*`;
+            if (p.trial_reel)
+                content += " *(IG trial reel)*";
             md += `| ${i + 1} | ${content} | ${channels} | ${status} | ${date} | \`${p.id}\` |\n`;
         }
         return {
@@ -936,6 +945,9 @@ export function registerPostTools(server, getClient) {
         // Trial Reel state: nested under the instagram options object by the
         // API. Only rendered when enabled, so batch-scheduled Trial Reels can be
         // verified without opening the dashboard.
+        if (Array.isArray(p.tags) && p.tags.length) {
+            md += `\n\n**Tags:** ${p.tags.map(tagLabel).join(", ")}\n`;
+        }
         const igOpts = p.instagram;
         if (igOpts && typeof igOpts === "object" && igOpts.is_trial_reel === true) {
             const strategy = igOpts.trial_graduation_strategy === "SS_PERFORMANCE"
@@ -1093,6 +1105,7 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
         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(),
+        tags: POST_TAGS.optional(),
     }, { title: "Create Post", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async (params) => {
         const result = await getClient().createPost({ ...params, source: "mcp" });
         if (result.error) {
@@ -1135,6 +1148,7 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             if (channels.length)
                 md += `| **Channels** | ${channels.join(", ")} |\n`;
             md += commentDmLine(p);
+            md += tagsLine(p);
             if (appUrl)
                 md += `| **Open in OmniSocials** | ${appUrl} |\n`;
             md += `\n**Content:** ${truncate(p.content, 100)}\n\n`;
@@ -1269,6 +1283,7 @@ Do NOT call without required media — it will fail.`, {
         telegram: TELEGRAM_OPTIONS,
         discord: DISCORD_OPTIONS,
         comment_dm_automation: COMMENT_DM_AUTOMATION.optional(),
+        tags: POST_TAGS.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) {
@@ -1393,6 +1408,7 @@ Do NOT call without required media — it will fail.`, {
         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."),
+        tags: POST_TAGS.nullable().optional().describe("Replaces the post's tags (names or ids; a new name becomes a tag); null or [] removes them all. An update with only tags works on every post, published ones included. To add or remove a tag on many posts at once, use tag_posts."),
     }, { title: "Update Post", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async ({ id, ...data }) => {
         const result = await getClient().updatePost(id, data);
         if (result.error) {
@@ -1415,6 +1431,7 @@ Do NOT call without required media — it will fail.`, {
         md += `| **Status** | ${capitalize(p.status || "—")} |\n`;
         if (schedAt)
             md += `| **${p.status === "draft" ? "Planned for" : "Scheduled"}** | ${formatDateTime(schedAt)} |\n`;
+        md += tagsLine(p);
         if (appUrl)
             md += `| **Open in OmniSocials** | ${appUrl} |\n`;
         if (p.status === "draft" && schedAt) {

package/build/tools/tags.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OmniSocialsClient } from "../client.js";
+export declare function registerTagTools(server: McpServer, getClient: () => OmniSocialsClient): void;

package/build/tools/tags.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { capitalize, formatNumber } from "../client.js";
+// Post tags (2026-11-02): the workspace's own labels for its posts, to filter
+// and compare them. Mirrors the hosted server (backend/routes/api/v1/mcp.js).
+const COLORS = ["blue", "green", "orange", "red", "purple", "pink", "teal", "yellow", "brown", "gray"];
+const tagLabel = (t) => t.name;
+const fmtVsNormal = (v) => v === null || v === undefined ? "—" : `${v >= 0 ? "+" : "−"}${Math.round(Math.abs(v) * 100)}%`;
+const errorText = (error) => ({
+    content: [{ type: "text", text: `Error (${error.code}): ${error.message}` }],
+});
+const text = (md) => ({ content: [{ type: "text", text: md }] });
+export function registerTagTools(server, getClient) {
+    server.tool("list_tags", "List the workspace's post tags (the team's own labels for its posts: a hook style, a format, a campaign). Tags filter list_posts (tag) and get_analytics_overview (tag), and get_tag_analytics compares them. Reuse these exact names when tagging so no near-duplicates appear.", {}, { title: "List Tags", readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async () => {
+        const result = await getClient().listTags();
+        if (result.error)
+            return errorText(result.error);
+        const items = Array.isArray(result.data) ? result.data : [];
+        if (!items.length) {
+            return text("No tags yet. Create one with create_tag, or pass tags on create_post / update_post / tag_posts (a new name becomes a tag).");
+        }
+        let md = `## Tags (${items.length})\n\n| Tag ID | Name | Colour |\n|--------|------|--------|\n`;
+        for (const t of items)
+            md += `| \`${t.id}\` | ${t.name} | ${t.color} |\n`;
+        md += `\nTag posts with tag_posts or tags on create_post / update_post. Compare tags with get_tag_analytics.`;
+        return text(md);
+    });
+    server.tool("create_tag", "Create a post tag, e.g. 'Question hook', 'Talking head' or 'Spring campaign'. A name is unique in the workspace (case-insensitive). At most 200 tags per workspace. Tags can also be made on the fly: a new name in tags on create_post / update_post or in tag_posts becomes a tag.", {
+        name: z.string().max(40).describe("Tag name, e.g. 'Question hook'"),
+        color: z.enum(COLORS).optional().describe("Colour in the app; omit for the next colour of the palette"),
+    }, { title: "Create Tag", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async (params) => {
+        const result = await getClient().createTag(params);
+        if (result.error)
+            return errorText(result.error);
+        const t = result.data;
+        return text(`Tag \`${t.id}\` created: ${tagLabel(t)} (${t.color}).`);
+    });
+    server.tool("update_tag", "Rename or recolour a post tag. Posts keep the tag.", {
+        id: z.string().describe("Tag id (from list_tags)"),
+        name: z.string().max(40).optional().describe("New name"),
+        color: z.enum(COLORS).optional(),
+    }, { title: "Update Tag", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async ({ id, ...data }) => {
+        const result = await getClient().updateTag(id, data);
+        if (result.error)
+            return errorText(result.error);
+        const t = result.data;
+        return text(`Tag \`${t.id}\` updated: ${tagLabel(t)} (${t.color}).`);
+    });
+    server.tool("delete_tag", "Delete a post tag. It comes off every post of the workspace; the posts stay. Cannot be undone: confirm with the user first.", { id: z.string().describe("Tag id (from list_tags)") }, { title: "Delete Tag", readOnlyHint: false, destructiveHint: true, openWorldHint: false }, async ({ id }) => {
+        const result = await getClient().deleteTag(id);
+        if (result.error)
+            return errorText(result.error);
+        const d = result.data;
+        return text(`Tag "${d?.tag ? tagLabel(d.tag) : id}" deleted; it came off ${d?.posts_untagged ?? 0} post(s).`);
+    });
+    server.tool("tag_posts", "Add, remove or replace the tags of up to 500 posts at once, published posts included (tags never go to a platform). Use it to tag older posts so get_tag_analytics has enough posts to compare: find them with list_posts, read their captions, then tag them. add / set take tag names or ids (a new name becomes a tag); remove takes names or ids; set replaces a post's tags.", {
+        post_ids: z.array(z.string()).min(1).max(500).describe("OmniSocials post ids (from list_posts)"),
+        add: z.array(z.string()).optional().describe('Tags to add, e.g. ["Question hook"]'),
+        remove: z.array(z.string()).optional().describe("Tags to remove"),
+        set: z.array(z.string()).optional().describe("Replace the posts' tags with exactly these; [] removes all"),
+    }, { title: "Tag Posts", readOnlyHint: false, destructiveHint: false, openWorldHint: false }, async (params) => {
+        const result = await getClient().applyTags(params);
+        if (result.error)
+            return errorText(result.error);
+        const d = result.data;
+        let md = `## Posts tagged (${d?.updated ?? 0} changed)\n\n| Post ID | Tags now |\n|---------|----------|\n`;
+        for (const p of d?.posts || [])
+            md += `| \`${p.id}\` | ${(p.tags || []).map(tagLabel).join(", ") || "—"} |\n`;
+        if (d?.not_found?.length)
+            md += `\nNot posts of this workspace: ${d.not_found.map((x) => `\`${x}\``).join(", ")}.`;
+        return text(md);
+    });
+    server.tool("get_tag_analytics", "Compare post tags: for each tag, how its published posts did against the user's normal in a period (the Tags tab of Analytics). vs normal is fair across channels: each post is measured against the median impressions of its own channel, so a tag does not win just because its posts went to the channel with the most views. A tag with fewer than min_posts measured posts is marked 'too few posts': say so instead of drawing a conclusion. Default period: the last 90 days.", {
+        start_date: z.string().optional().describe("YYYY-MM-DD or YYYY-MM (default: 90 days ago)"),
+        end_date: z.string().optional().describe("YYYY-MM-DD or YYYY-MM (default: today)"),
+        platform: z.string().optional().describe("Only one channel's numbers, e.g. tiktok"),
+        min_posts: z.string().optional().describe("Posts a tag needs before it counts as comparable (default 5)"),
+    }, { title: "Get Tag Analytics", readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (params) => {
+        const result = await getClient().getTagAnalytics(params);
+        if (result.error)
+            return errorText(result.error);
+        const d = result.data;
+        if (!d)
+            return text("No tag data returned.");
+        const period = d.period ? `${String(d.period.start_date).slice(0, 10)} → ${String(d.period.end_date).slice(0, 10)}` : "";
+        let md = `## Tags compared (${period}${d.platform ? `, ${capitalize(d.platform)}` : ", all channels"})\n\n`;
+        if (!d.tags?.length) {
+            md += "No tags yet. Tag posts with tag_posts first.\n\n";
+        }
+        else {
+            md += `| Tag | Posts | Median impressions | Eng. rate | vs normal | Best on |\n|-----|-------|--------------------|-----------|-----------|---------|\n`;
+            for (const r of d.tags) {
+                const vs = r.enough_posts ? fmtVsNormal(r.vs_normal) : `too few posts (${fmtVsNormal(r.vs_normal)})`;
+                const median = r.median_impressions === null ? "—" : formatNumber(Math.round(r.median_impressions));
+                const rate = r.engagement_rate === null ? "—" : `${r.engagement_rate.toFixed(1)}%`;
+                md += `| ${r.tag.name} | ${r.posts} | ${median} | ${rate} | ${vs} | ${r.best_channel ? capitalize(r.best_channel) : "—"} |\n`;
+            }
+            md += "\n";
+        }
+        md += `Posts without a tag: ${d.untagged?.posts ?? 0}. A tag needs ${d.min_posts ?? 5} measured posts before vs normal counts.`;
+        return text(md);
+    });
+}

package/build/types.d.ts

@@ -195,8 +195,56 @@ export interface ApiStorySlide {
     media_type?: "image" | "video" | string | null;
     published_at?: string | null;
 }
+/** A workspace's own label for its posts (GET /tags, 2026-11-02). */
+export interface Tag {
+    id: number;
+    name: string;
+    color: string;
+    created_at?: string;
+}
+export interface TagSummary {
+    posts: number;
+    measured: number;
+    median_impressions: number | null;
+    /** Percent (5.4 = 5.4%). */
+    engagement_rate: number | null;
+    /** Fraction against the person's normal (0.38 = 38% above). */
+    vs_normal: number | null;
+    best_channel: string | null;
+    enough_posts: boolean;
+}
+/** GET /analytics/tags */
+export interface TagAnalytics {
+    period: {
+        start_date: string;
+        end_date: string;
+    };
+    platform: string | null;
+    min_posts: number;
+    /** Comparable tags first, best first. */
+    tags: (TagSummary & {
+        tag: Tag;
+    })[];
+    untagged: TagSummary;
+    normals: Record<string, number | null>;
+}
+/** POST /tags/apply */
+export interface TagApplyResult {
+    updated: number;
+    posts: {
+        id: string;
+        tags: Tag[];
+    }[];
+    not_found: string[];
+}
 export interface ApiPost {
     id: string;
+    /** The post's tags (2026-11-02). */
+    tags?: Tag[];
+    /** Set when the post is an Instagram Trial Reel. */
+    trial_reel?: {
+        strategy: "MANUAL" | "SS_PERFORMANCE";
+    } | null;
     /** DB "posted" is mapped to "published" by the serializer. */
     status: string;
     /** "post" | "story" | "reel" */

package/package.json

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