@omnisocials/mcp-server 1.0.2 → 1.0.4

package/build/tools/accounts.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerAccountTools(server, client) {
-    server.tool("list_accounts", "List all connected social media accounts in the workspace.", {}, 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). Call this to help users pick which platforms to post to.", {}, async () => {
         const result = await client.listAccounts();
         return {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],

package/build/tools/media.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerMediaTools(server, client) {
-    server.tool("list_media", "List all media files in the workspace.", {
+    server.tool("list_media", "List all media files in the workspace. Returns each file's ID, URL, type (image/video), and size. Use this to help users pick media for posts, stories, or reels. Media IDs or URLs from this list can be passed to create_post.", {
         limit: z.string().optional().describe("Max results to return"),
         offset: z.string().optional().describe("Offset for pagination"),
     }, async (params) => {

package/build/tools/posts.js

@@ -18,7 +18,26 @@ export function registerPostTools(server, client) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     });
-    server.tool("create_post", "Create a new social media post, story, or reel. Specify content, target channels, type, and optional platform-specific options.", {
+    server.tool("create_post", `Create a new social media post, story, or reel.
+
+IMPORTANT — Before calling this tool, make sure you have all required information from the user. If anything is missing, ASK the user before calling:
+
+1. **Content/caption**: What text should the post have?
+2. **Channels**: Which platforms to post to? Use list_accounts to show available options if needed.
+3. **Schedule**: When should it be published? (Or save as draft?)
+4. **Media** (REQUIRED for some types):
+   - Stories: ALWAYS require an image or video. Ask the user which image/video to use. Use list_media to show their uploaded media, or ask for an external URL.
+   - Reels: ALWAYS require a video. Ask the user which video to use. Use list_media to find available videos.
+   - 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.
+5. **Platform-specific options** (ask only when relevant):
+   - Pinterest: Which board? Any link to attach?
+   - YouTube: Title, privacy status, tags?
+   - TikTok: Privacy level?
+
+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"),
         scheduled_at: z.string().optional().describe("ISO 8601 date for scheduled publishing"),
@@ -68,7 +87,20 @@ export function registerPostTools(server, client) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     });
-    server.tool("create_and_publish_post", "Create a new post and publish it immediately to all selected platforms. No scheduling needed.", {
+    server.tool("create_and_publish_post", `Create a new post and publish it immediately (no scheduling).
+
+IMPORTANT — Before calling this tool, make sure you have all required information. If anything is missing, ASK the user first:
+
+1. **Content/caption**: What text?
+2. **Channels**: Which platforms? Use list_accounts if needed.
+3. **Media** (REQUIRED for some types — same rules as create_post):
+   - Stories: ALWAYS need an image or video.
+   - Reels: ALWAYS need a video.
+   - Instagram/TikTok posts: ALWAYS need at least one image or video.
+   - Pinterest: ALWAYS need an image + board_id.
+   - Ask the user which media to use. Use list_media to show options.
+
+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"),
         media_ids: z.union([
@@ -126,7 +158,9 @@ export function registerPostTools(server, client) {
             content: [{ type: "text", text: result.error ? JSON.stringify(result.error) : "Post deleted successfully." }],
         };
     });
-    server.tool("publish_post", "Publish a draft or scheduled post immediately. The post will be queued for immediate publishing.", {
+    server.tool("publish_post", `Publish a draft or scheduled post immediately. The post will be queued for publishing.
+
+IMPORTANT: Before publishing, verify the post has all required media. If publishing a story or reel, ensure media was attached when the post was created/updated. If it's missing, use update_post to add media first, or inform the user.`, {
         id: z.string().describe("The post ID to publish"),
     }, async ({ id }) => {
         const result = await client.publishPost(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
   "main": "build/index.js",
@@ -8,7 +8,8 @@
     "omnisocials-mcp": "build/index.js"
   },
   "files": [
-    "build/"
+    "build/",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",