@omnisocials/mcp-server 1.1.0 → 1.2.0

package/README.md

@@ -75,6 +75,24 @@ Add to your `~/.codeium/windsurf/mcp_config.json`:
 }
 ```
 
+## Supported Channels
+
+OmniSocials accepts the following channel IDs in `create_post`, `create_and_publish_post`, and related tools. Use `list_accounts` to see which channels a workspace currently has connected.
+
+| Channel ID | Platform | Notes |
+|------------|----------|-------|
+| `instagram` | Instagram | Posts, stories, reels |
+| `facebook` | Facebook | Posts, stories, reels |
+| `linkedin` | LinkedIn Profile | Personal profile posts |
+| `linkedin_page` | LinkedIn Page | Company page posts. Independent from `linkedin`; a workspace can have both connected at once |
+| `youtube` | YouTube | Shorts |
+| `tiktok` | TikTok | Posts and reels |
+| `pinterest` | Pinterest | Pins (requires `board_id`) |
+| `x` | X (Twitter) | Posts |
+| `threads` | Threads | Posts |
+| `bluesky` | Bluesky | Posts |
+| `mastodon` | Mastodon | Posts |
+
 ## Available Tools
 
 ### Posts (7 tools)

package/build/client.d.ts

@@ -27,6 +27,7 @@ export declare class OmniSocialsClient {
         media_ids?: string[] | Record<string, string[]>;
         media_urls?: string[] | Record<string, string[]>;
         type?: string;
+        source?: string;
         pinterest?: Record<string, unknown>;
         youtube?: Record<string, unknown>;
         instagram?: Record<string, unknown>;
@@ -39,6 +40,7 @@ export declare class OmniSocialsClient {
         media_ids?: string[] | Record<string, string[]>;
         media_urls?: string[] | Record<string, string[]>;
         type?: string;
+        source?: string;
         pinterest?: Record<string, unknown>;
         youtube?: Record<string, unknown>;
         instagram?: Record<string, unknown>;

package/build/tools/accounts.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { fetchImageAsBase64, capitalize } from "../client.js";
 export function registerAccountTools(server, client) {
-    server.tool("list_accounts", "List all connected social media accounts in the workspace. Each account includes its platform, display name, channel ID (used for create_post), and supported content_types (post, story, reel). Pinterest accounts also include a `boards` array with `{id, name}` — use the board `id` as `board_id` when creating Pinterest posts. X accounts with Premium include `platform_details` with `subscription_type` (e.g. \"Premium\", \"PremiumPlus\"). Call this to help users pick which platforms to post to.", {}, async () => {
+    server.tool("list_accounts", "List all connected social media accounts in the workspace. Each account includes its platform, display name, channel ID (used for create_post), and supported content_types (post, story, reel). Pinterest accounts also include a `boards` array with `{id, name}` — use the board `id` as `board_id` when creating Pinterest posts. X accounts with Premium include `platform_details` with `subscription_type` (e.g. \"Premium\", \"PremiumPlus\"). LinkedIn appears as two independent platforms: `linkedin` for a personal profile and `linkedin_page` for a company page. A workspace can have both connected at the same time and post to each separately. Call this to help users pick which platforms to post to.", {}, async () => {
         const result = await client.listAccounts();
         if (result.error) {
             return {

package/build/tools/posts.js

@@ -86,7 +86,7 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - Instagram posts: ALWAYS require at least one image or video.
    - TikTok posts: ALWAYS require at least one image or video.
    - Pinterest posts: ALWAYS require an image AND a board_id.
-   - Other platforms (LinkedIn, X, Bluesky, etc.): Media is optional.
+   - Other platforms (LinkedIn, LinkedIn Page, X, Bluesky, etc.): Media is optional.
 5. **Platform-specific options** (ask only when relevant):
    - Pinterest: Which board? Any link to attach?
    - YouTube: Title, privacy status, tags?
@@ -94,7 +94,7 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
 
 Do NOT call this tool without media when creating stories, reels, Instagram posts, TikTok posts, or Pinterest posts — it will fail.`, {
         content: z.string().describe("The post content/caption text"),
-        channels: z.array(z.string()).optional().describe("Array of channel IDs to post to"),
+        channels: z.array(z.string()).optional().describe("Array of channel IDs to post to. Get the available channel IDs from list_accounts. Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels. A workspace can have both connected and post to each separately."),
         scheduled_at: z.string().optional().describe("ISO 8601 date for scheduled publishing"),
         media_ids: z.union([
             z.array(z.string()),
@@ -137,7 +137,7 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             reply_settings: z.enum(["", "following", "mentionedUsers"]).optional(),
         }).optional().describe("X (Twitter) options"),
     }, async (params) => {
-        const result = await client.createPost(params);
+        const result = await client.createPost({ ...params, source: "mcp" });
         if (result.error) {
             return {
                 content: [{ type: "text", text: `Error: ${result.error.message}` }],
@@ -173,7 +173,7 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
 
 Do NOT call without required media — it will fail.`, {
         content: z.string().describe("The post content/caption text"),
-        channels: z.array(z.string()).optional().describe("Array of channel IDs to post to"),
+        channels: z.array(z.string()).optional().describe("Array of channel IDs to post to. Get the available channel IDs from list_accounts. Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels. A workspace can have both connected and post to each separately."),
         media_ids: z.union([
             z.array(z.string()),
             z.record(z.string(), z.array(z.string())),
@@ -197,7 +197,7 @@ Do NOT call without required media — it will fail.`, {
             privacy_level: z.enum(["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY"]).optional(),
         }).optional().describe("TikTok options"),
     }, async (params) => {
-        const result = await client.createAndPublishPost(params);
+        const result = await client.createAndPublishPost({ ...params, source: "mcp" });
         if (result.error) {
             return {
                 content: [{ type: "text", text: `Error: ${result.error.message}` }],
@@ -220,7 +220,7 @@ Do NOT call without required media — it will fail.`, {
         id: z.string().describe("The post ID to update"),
         content: z.string().optional().describe("Updated post content"),
         scheduled_at: z.string().optional().describe("Updated scheduled date (ISO 8601)"),
-        channels: z.array(z.string()).optional().describe("Updated channel IDs"),
+        channels: z.array(z.string()).optional().describe("Updated channel IDs. Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels."),
         media_ids: z.union([
             z.array(z.string()),
             z.record(z.string(), z.array(z.string())),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
   "main": "build/index.js",