posterly-mcp-server 0.6.0 → 0.7.0

package/README.md

@@ -93,7 +93,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.6.0` exposes 16 tools:
+`posterly-mcp-server@0.7.0` exposes 16 tools:
 
 - `whoami`
 - `list_accounts`
@@ -145,9 +145,12 @@ much more reliable than forcing the agent to guess from raw account handles alon
 This package uses the Posterly API/MCP add-on:
 
 - `$3/month` add-on
-- `100 requests/hour` per API key
+- `30 requests/hour` per API key
+- user-created API keys per plan: Starter 1, Pro 2, Power User 3, Agency 4
 - works across all 11 supported platforms
 
+Each API call counts as one request, so you can still schedule multiple posts in a single request to maximize throughput.
+
 Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
 
 ## Links

package/dist/index.js

@@ -20,7 +20,7 @@ import { getAccountAnalyticsTool } from './tools/get-account-analytics.js';
 import { getPostAnalyticsTool } from './tools/get-post-analytics.js';
 const server = new McpServer({
     name: 'posterly',
-    version: '0.6.0',
+    version: '0.7.0',
 });
 let client;
 try {

package/dist/tools/create-post.d.ts

@@ -7,42 +7,46 @@ export declare const createPostTool: {
         account_id: z.ZodOptional<z.ZodString>;
         username: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodString>;
-        caption: z.ZodString;
+        caption: z.ZodOptional<z.ZodString>;
         scheduled_at: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
         media_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         post_type: z.ZodOptional<z.ZodString>;
+        thread_posts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        caption: string;
         workspace_id?: string | undefined;
         platform?: string | undefined;
         account_id?: string | undefined;
         username?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
+        thread_posts?: string[] | undefined;
     }, {
-        caption: string;
         workspace_id?: string | undefined;
         platform?: string | undefined;
         account_id?: string | undefined;
         username?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
+        thread_posts?: string[] | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         account_id?: string;
         username?: string;
         platform?: string;
-        caption: string;
+        caption?: string;
         scheduled_at?: string;
         media_url?: string;
         media_urls?: string[];
         post_type?: string;
+        thread_posts?: string[];
         workspace_id?: string;
     }): Promise<string>;
 };

package/dist/tools/create-post.js

@@ -7,7 +7,8 @@ export const createPostTool = {
         '2. Show the user a preview containing ALL of: account(s) and platform(s), final caption text, scheduled time (in the user\'s timezone), media attached (if any), and workspace name.\n' +
         '3. Get explicit confirmation from the user (e.g. "post it", "yes schedule that", "looks good") BEFORE calling this tool. Do NOT infer consent from earlier instructions like "post about X every Monday" — confirm each individual post or the entire batch.\n' +
         '4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole before calling create_post repeatedly.\n\n' +
-        'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.',
+        'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.\n\n' +
+        'THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Meta). The first entry is the lead post; the rest are published as replies in the same chain. X entries are capped at 280 characters each (4000 for verified, 25000 for organization accounts); Threads entries are capped at 500 characters each. When `thread_posts` is set, `caption` is ignored.',
     inputSchema: z.object({
         account_id: z.string().optional().describe('Social account ID (from list_accounts)'),
         username: z.string().optional().describe('Account username (alternative to account_id)'),
@@ -15,12 +16,12 @@ export const createPostTool = {
             .string()
             .optional()
             .describe('Platform name (required with username): instagram, twitter, linkedin, facebook, tiktok, threads, youtube, pinterest, google_business'),
-        caption: z.string().describe('The post caption/text content'),
+        caption: z.string().optional().describe('The post caption/text content. Ignored when `thread_posts` is provided.'),
         scheduled_at: z
             .string()
             .optional()
             .describe('ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.'),
-        media_url: z.string().optional().describe('URL of media to attach (image or video)'),
+        media_url: z.string().optional().describe('URL of media to attach (image or video). For threads, attaches to the lead post only.'),
         media_urls: z
             .array(z.string())
             .optional()
@@ -28,14 +29,49 @@ export const createPostTool = {
         post_type: z
             .string()
             .optional()
-            .describe('Post type: text, image, video, carousel, reel, story'),
+            .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided.'),
+        thread_posts: z
+            .array(z.string())
+            .optional()
+            .describe('For X or Threads only: array of 2+ strings, one per post in the thread. The first entry leads, the rest reply in order. When set, the platform must be twitter or threads.'),
         workspace_id: z
             .string()
             .optional()
             .describe('Workspace ID to assign the post to (from whoami). If omitted, uses the account\'s workspace or the caller\'s default workspace.'),
     }),
     async execute(client, input) {
-        const result = await client.createPost(input);
+        const { thread_posts, caption, post_type, ...rest } = input;
+        let payload;
+        if (thread_posts && thread_posts.length > 0) {
+            if (thread_posts.length < 2) {
+                throw new Error('thread_posts must contain at least 2 entries');
+            }
+            const platformHint = (input.platform || '').toLowerCase();
+            const isTwitter = platformHint === 'twitter' || platformHint === 'x';
+            const isThreads = platformHint === 'threads';
+            if (!isTwitter && !isThreads && !input.account_id) {
+                throw new Error('thread_posts requires `platform` to be "twitter" or "threads", or pass `account_id` for an X/Threads account.');
+            }
+            const arrayKey = isThreads ? 'threads_thread_posts' : 'x_thread_tweets';
+            const totalKey = isThreads ? 'threads_thread_total' : 'x_thread_total';
+            payload = {
+                ...rest,
+                platform: isTwitter ? 'twitter' : isThreads ? 'threads' : input.platform,
+                caption: thread_posts[0],
+                post_type: isThreads ? 'threads_thread' : 'x_thread',
+                metadata: {
+                    [arrayKey]: thread_posts,
+                    [totalKey]: thread_posts.length,
+                },
+            };
+        }
+        else {
+            if (!caption) {
+                throw new Error('caption is required (or pass `thread_posts` for an X/Threads thread)');
+            }
+            payload = { ...rest, caption, post_type };
+        }
+        const result = await client.createPost(payload);
         const p = result.post;
         const ws = result.workspace;
         const when = p.scheduled_at
@@ -49,6 +85,9 @@ export const createPostTool = {
             `• Status: ${p.status}`,
             `• Scheduled: ${when}`,
         ];
+        if (thread_posts) {
+            lines.push(`• Thread: ${thread_posts.length} posts`);
+        }
         if (ws) {
             lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",

package/src/index.ts

@@ -22,7 +22,7 @@ import { getPostAnalyticsTool } from './tools/get-post-analytics.js';
 
 const server = new McpServer({
   name: 'posterly',
-  version: '0.6.0',
+  version: '0.7.0',
 });
 
 let client: PosterlyClient;

package/src/tools/create-post.ts

@@ -10,7 +10,8 @@ export const createPostTool = {
     '2. Show the user a preview containing ALL of: account(s) and platform(s), final caption text, scheduled time (in the user\'s timezone), media attached (if any), and workspace name.\n' +
     '3. Get explicit confirmation from the user (e.g. "post it", "yes schedule that", "looks good") BEFORE calling this tool. Do NOT infer consent from earlier instructions like "post about X every Monday" — confirm each individual post or the entire batch.\n' +
     '4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole before calling create_post repeatedly.\n\n' +
-    'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.',
+    'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.\n\n' +
+    'THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Meta). The first entry is the lead post; the rest are published as replies in the same chain. X entries are capped at 280 characters each (4000 for verified, 25000 for organization accounts); Threads entries are capped at 500 characters each. When `thread_posts` is set, `caption` is ignored.',
   inputSchema: z.object({
     account_id: z.string().optional().describe('Social account ID (from list_accounts)'),
     username: z.string().optional().describe('Account username (alternative to account_id)'),
@@ -18,12 +19,12 @@ export const createPostTool = {
       .string()
       .optional()
       .describe('Platform name (required with username): instagram, twitter, linkedin, facebook, tiktok, threads, youtube, pinterest, google_business'),
-    caption: z.string().describe('The post caption/text content'),
+    caption: z.string().optional().describe('The post caption/text content. Ignored when `thread_posts` is provided.'),
     scheduled_at: z
       .string()
       .optional()
       .describe('ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.'),
-    media_url: z.string().optional().describe('URL of media to attach (image or video)'),
+    media_url: z.string().optional().describe('URL of media to attach (image or video). For threads, attaches to the lead post only.'),
     media_urls: z
       .array(z.string())
       .optional()
@@ -31,7 +32,11 @@ export const createPostTool = {
     post_type: z
       .string()
       .optional()
-      .describe('Post type: text, image, video, carousel, reel, story'),
+      .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided.'),
+    thread_posts: z
+      .array(z.string())
+      .optional()
+      .describe('For X or Threads only: array of 2+ strings, one per post in the thread. The first entry leads, the rest reply in order. When set, the platform must be twitter or threads.'),
     workspace_id: z
       .string()
       .optional()
@@ -44,15 +49,50 @@ export const createPostTool = {
       account_id?: string;
       username?: string;
       platform?: string;
-      caption: string;
+      caption?: string;
       scheduled_at?: string;
       media_url?: string;
       media_urls?: string[];
       post_type?: string;
+      thread_posts?: string[];
       workspace_id?: string;
     }
   ) {
-    const result = await client.createPost(input);
+    const { thread_posts, caption, post_type, ...rest } = input;
+    let payload: Parameters<typeof client.createPost>[0];
+
+    if (thread_posts && thread_posts.length > 0) {
+      if (thread_posts.length < 2) {
+        throw new Error('thread_posts must contain at least 2 entries');
+      }
+      const platformHint = (input.platform || '').toLowerCase();
+      const isTwitter = platformHint === 'twitter' || platformHint === 'x';
+      const isThreads = platformHint === 'threads';
+      if (!isTwitter && !isThreads && !input.account_id) {
+        throw new Error(
+          'thread_posts requires `platform` to be "twitter" or "threads", or pass `account_id` for an X/Threads account.',
+        );
+      }
+      const arrayKey = isThreads ? 'threads_thread_posts' : 'x_thread_tweets';
+      const totalKey = isThreads ? 'threads_thread_total' : 'x_thread_total';
+      payload = {
+        ...rest,
+        platform: isTwitter ? 'twitter' : isThreads ? 'threads' : input.platform,
+        caption: thread_posts[0],
+        post_type: isThreads ? 'threads_thread' : 'x_thread',
+        metadata: {
+          [arrayKey]: thread_posts,
+          [totalKey]: thread_posts.length,
+        },
+      };
+    } else {
+      if (!caption) {
+        throw new Error('caption is required (or pass `thread_posts` for an X/Threads thread)');
+      }
+      payload = { ...rest, caption, post_type };
+    }
+
+    const result = await client.createPost(payload);
     const p = result.post as Record<string, any>;
     const ws = result.workspace;
 
@@ -68,6 +108,9 @@ export const createPostTool = {
       `• Status: ${p.status}`,
       `• Scheduled: ${when}`,
     ];
+    if (thread_posts) {
+      lines.push(`• Thread: ${thread_posts.length} posts`);
+    }
     if (ws) {
       lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
     }