posterly-mcp-server 0.33.2 → 0.34.0

package/dist/tools/get-platform-schema.d.ts

@@ -8,12 +8,12 @@ export declare const getPlatformSchemaTool: {
         platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"]>>;
         include_planned: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        include_planned?: boolean | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        include_planned?: boolean | undefined;
         account_id?: string | undefined;
     }, {
-        include_planned?: boolean | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        include_planned?: boolean | undefined;
         account_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {

package/dist/tools/list-google-business-reviews.d.ts

@@ -9,15 +9,21 @@ export declare const listGoogleBusinessReviewsTool: {
         location_id: z.ZodOptional<z.ZodString>;
         rating: z.ZodOptional<z.ZodNumber>;
         unanswered: z.ZodOptional<z.ZodBoolean>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         workspace_id?: string | undefined;
         account_id?: number | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
         location_id?: string | undefined;
         rating?: number | undefined;
         unanswered?: boolean | undefined;
     }, {
         workspace_id?: string | undefined;
         account_id?: number | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
         location_id?: string | undefined;
         rating?: number | undefined;
         unanswered?: boolean | undefined;
@@ -28,5 +34,7 @@ export declare const listGoogleBusinessReviewsTool: {
         location_id?: string;
         rating?: number;
         unanswered?: boolean;
+        limit?: number;
+        offset?: number;
     }): Promise<string>;
 };

package/dist/tools/list-google-business-reviews.js

@@ -1,28 +1,108 @@
 import { z } from 'zod';
+import { formatDate } from '../lib/format.js';
+/** Matches GOOGLE_BUSINESS_REVIEWS_MAX_LIMIT in lib/api-v1-google-business.ts. */
+const MAX_LIMIT = 1000;
 export const listGoogleBusinessReviewsTool = {
     name: 'list_google_business_reviews',
-    description: 'List Google Business Profile reviews for one location/account or every accessible GBP location. Supports rating and unanswered-only filters.',
+    description: 'List Google Business Profile reviews for one location/account or every accessible GBP location. Pages through all reviews Google has (not just the first 50), returns the full untruncated review text with its date, and reports each location\'s total review count. Supports rating and unanswered-only filters plus limit/offset paging.',
     inputSchema: z.object({
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
         location_id: z.string().optional().describe('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID returned by get_google_business_review_link. Prefer account_id.'),
         rating: z.number().int().min(1).max(5).optional().describe('Filter to a 1-5 star rating.'),
         unanswered: z.boolean().optional().describe('Only return reviews without owner replies.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(MAX_LIMIT)
+            .optional()
+            .describe(`Maximum reviews to return in this call (default 200, max ${MAX_LIMIT}). Every returned review is listed in full.`),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.'),
     }),
     async execute(client, input) {
         const result = await client.listGoogleBusinessReviews(input);
+        const locations = (result.locations || []);
+        const offset = result.offset ?? 0;
         if (result.reviews.length === 0) {
-            return 'No Google Business reviews found matching your filters.';
+            // Distinguish "no reviews exist" from "we couldn't read them" — a silent
+            // zero used to be indistinguishable from a broken connection.
+            const lines = ['No Google Business reviews found matching your filters.'];
+            const locationLines = locations.map((location) => formatLocationLine(location));
+            if (locationLines.length > 0) {
+                lines.push('', 'Locations checked:', ...locationLines);
+            }
+            return lines.join('\n');
         }
-        const lines = [`Google Business reviews (${result.reviews.length} of ${result.total}):`];
-        for (const review of result.reviews.slice(0, 25)) {
+        const header = [`Google Business reviews (showing ${result.reviews.length} of ${result.total} matching`];
+        if (offset > 0)
+            header.push(`, from offset ${offset}`);
+        if (typeof result.total_review_count === 'number') {
+            header.push(`; ${result.total_review_count} total on Google`);
+        }
+        header.push('):');
+        const lines = [header.join('')];
+        for (const location of locations) {
+            if (location.error) {
+                lines.push(`! ${location.business_name || location.name || location.location_id || 'location'}: ${location.error}`);
+            }
+        }
+        lines.push('');
+        for (const review of result.reviews) {
             const name = review.reviewer?.displayName || 'Anonymous';
             const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
             const location = review.businessName || review.locationName || review.locationId || 'location';
-            const text = review.comment ? ` - ${review.comment.replace(/\s+/g, ' ').slice(0, 180)}` : '';
-            const replied = review.reviewReply ? ' replied' : ' unanswered';
-            lines.push(`- ${name} (${rating}, ${location},${replied})${text}`);
+            const date = formatReviewDate(review);
+            const replied = review.reviewReply ? 'replied' : 'unanswered';
+            lines.push(`- ${name} (${rating}, ${date}, ${location}, ${replied})`);
+            // Full review text, no truncation — collapse whitespace only so the
+            // bullet list stays readable for multi-paragraph reviews.
+            if (review.comment) {
+                lines.push(`  ${review.comment.replace(/\s+/g, ' ').trim()}`);
+            }
+        }
+        if (result.has_more) {
+            const nextOffset = offset + result.reviews.length;
+            lines.push('', `More reviews available — call again with offset: ${nextOffset} to continue.`);
         }
+        lines.push('', 'Locations:', ...locations.map((location) => formatLocationLine(location)));
         return lines.join('\n');
     },
 };
+/**
+ * When a review was written, plus when it was last edited if that differs.
+ * The list is ordered by last activity (updateTime), so showing only the
+ * original date would make an edited review look out of order.
+ */
+function formatReviewDate(review) {
+    const created = review.createTime || review.updateTime;
+    const createdLabel = formatDate(created);
+    if (!review.updateTime || !review.createTime)
+        return createdLabel;
+    const updatedLabel = formatDate(review.updateTime);
+    if (updatedLabel === createdLabel)
+        return createdLabel;
+    return `${createdLabel}, edited ${updatedLabel}`;
+}
+function formatLocationLine(location) {
+    const label = location.business_name || location.name || location.location_id || `account ${location.id}`;
+    const parts = [];
+    if (typeof location.total_review_count === 'number') {
+        parts.push(`${location.total_review_count} reviews on Google`);
+    }
+    else if (!location.error) {
+        parts.push('review count not reported by Google');
+    }
+    if (typeof location.average_rating === 'number') {
+        parts.push(`${location.average_rating.toFixed(1)} avg`);
+    }
+    parts.push(`${location.fetched_review_count} fetched`);
+    if (location.error)
+        parts.push(`ERROR: ${location.error}`);
+    return `- ${label} (account_id ${location.id}): ${parts.join(', ')}`;
+}

package/dist/tools/list-posts.d.ts

@@ -10,15 +10,15 @@ export declare const listPostsTool: {
         limit: z.ZodOptional<z.ZodNumber>;
         workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         account_id?: string | undefined;
         limit?: number | undefined;
     }, {
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         account_id?: string | undefined;
         limit?: number | undefined;
     }>;

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

@@ -10,12 +10,12 @@ declare const instagramSettingsSchema: z.ZodObject<{
         username: z.ZodOptional<z.ZodString>;
         handle: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     }, {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     }>]>, "many">>;
     user_tags: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -23,12 +23,12 @@ declare const instagramSettingsSchema: z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
         handle: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     }, {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     }>]>, "many">>;
     first_comment: z.ZodOptional<z.ZodString>;
@@ -45,13 +45,13 @@ declare const instagramSettingsSchema: z.ZodObject<{
     is_trial_reel?: boolean | undefined;
     graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
     collaborators?: (string | {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     })[] | undefined;
     user_tags?: (string | {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     })[] | undefined;
     first_comment?: string | undefined;
@@ -65,13 +65,13 @@ declare const instagramSettingsSchema: z.ZodObject<{
     is_trial_reel?: boolean | undefined;
     graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
     collaborators?: (string | {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     })[] | undefined;
     user_tags?: (string | {
-        label?: string | undefined;
         username?: string | undefined;
+        label?: string | undefined;
         handle?: string | undefined;
     })[] | undefined;
     first_comment?: string | undefined;
@@ -332,12 +332,12 @@ export declare const updatePostTool: {
                 username: z.ZodOptional<z.ZodString>;
                 handle: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }>]>, "many">>;
             user_tags: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -345,12 +345,12 @@ export declare const updatePostTool: {
                 label: z.ZodOptional<z.ZodString>;
                 handle: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }>]>, "many">>;
             first_comment: z.ZodOptional<z.ZodString>;
@@ -367,13 +367,13 @@ export declare const updatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -387,13 +387,13 @@ export declare const updatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -652,13 +652,13 @@ export declare const updatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -762,13 +762,13 @@ export declare const updatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;

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

@@ -20,12 +20,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
             username: import("zod").ZodOptional<import("zod").ZodString>;
             handle: import("zod").ZodOptional<import("zod").ZodString>;
         }, "strip", import("zod").ZodTypeAny, {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         }, {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         }>]>, "many">>;
         user_tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodObject<{
@@ -33,12 +33,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
             label: import("zod").ZodOptional<import("zod").ZodString>;
             handle: import("zod").ZodOptional<import("zod").ZodString>;
         }, "strip", import("zod").ZodTypeAny, {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         }, {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         }>]>, "many">>;
         first_comment: import("zod").ZodOptional<import("zod").ZodString>;
@@ -53,13 +53,13 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         user_tags?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         first_comment?: string | undefined;
@@ -72,13 +72,13 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         user_tags?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         first_comment?: string | undefined;
@@ -318,14 +318,14 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
     }, import("zod").ZodTypeAny, "passthrough">>>;
     workspace_id: import("zod").ZodOptional<import("zod").ZodString>;
 }, "strip", import("zod").ZodTypeAny, {
-    workspace_id?: string | undefined;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    username?: string | undefined;
+    workspace_id?: string | undefined;
     account_id?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    username?: string | undefined;
     caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
@@ -336,13 +336,13 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         user_tags?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         first_comment?: string | undefined;
@@ -427,14 +427,14 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         ai_generated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     }, import("zod").ZodTypeAny, "passthrough"> | undefined;
 }, {
-    workspace_id?: string | undefined;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    username?: string | undefined;
+    workspace_id?: string | undefined;
     account_id?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    username?: string | undefined;
     caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
@@ -445,13 +445,13 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         user_tags?: (string | {
-            label?: string | undefined;
             username?: string | undefined;
+            label?: string | undefined;
             handle?: string | undefined;
         })[] | undefined;
         first_comment?: string | undefined;
@@ -560,12 +560,12 @@ export declare const validatePostTool: {
                 username: import("zod").ZodOptional<import("zod").ZodString>;
                 handle: import("zod").ZodOptional<import("zod").ZodString>;
             }, "strip", import("zod").ZodTypeAny, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }>]>, "many">>;
             user_tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodObject<{
@@ -573,12 +573,12 @@ export declare const validatePostTool: {
                 label: import("zod").ZodOptional<import("zod").ZodString>;
                 handle: import("zod").ZodOptional<import("zod").ZodString>;
             }, "strip", import("zod").ZodTypeAny, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }, {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             }>]>, "many">>;
             first_comment: import("zod").ZodOptional<import("zod").ZodString>;
@@ -593,13 +593,13 @@ export declare const validatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -612,13 +612,13 @@ export declare const validatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -858,14 +858,14 @@ export declare const validatePostTool: {
         }, import("zod").ZodTypeAny, "passthrough">>>;
         workspace_id: import("zod").ZodOptional<import("zod").ZodString>;
     }, "strip", import("zod").ZodTypeAny, {
-        workspace_id?: string | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        username?: string | undefined;
+        workspace_id?: string | undefined;
         account_id?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        username?: string | undefined;
         caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
@@ -876,13 +876,13 @@ export declare const validatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;
@@ -967,14 +967,14 @@ export declare const validatePostTool: {
             ai_generated: import("zod").ZodOptional<import("zod").ZodBoolean>;
         }, import("zod").ZodTypeAny, "passthrough"> | undefined;
     }, {
-        workspace_id?: string | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        username?: string | undefined;
+        workspace_id?: string | undefined;
         account_id?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        username?: string | undefined;
         caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
@@ -985,13 +985,13 @@ export declare const validatePostTool: {
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             user_tags?: (string | {
-                label?: string | undefined;
                 username?: string | undefined;
+                label?: string | undefined;
                 handle?: string | undefined;
             })[] | undefined;
             first_comment?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.33.2",
+  "version": "0.34.0",
   "mcpName": "io.github.awpthorp/posterly",
   "description": "MCP server for posterly: schedule and publish social media posts across 18 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.awpthorp/posterly",
   "title": "posterly",
   "description": "Validate, schedule, publish, and analyze social content across 18 platforms with posterly.",
-  "version": "0.33.2",
+  "version": "0.34.0",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly",
@@ -14,7 +14,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.33.2",
+      "version": "0.34.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -68,6 +68,7 @@ import { getXPostingQuotaTool } from './tools/get-x-posting-quota.js';
 import { createSignedUploadTool } from './tools/create-signed-upload.js';
 import { uploadMediaFromUrlTool } from './tools/upload-media-from-url.js';
 import { getConnectLinkTool } from './tools/get-connect-link.js';
+import { connectAccountTool } from './tools/connect-account.js';
 import { createConnectSessionTool } from './tools/create-connect-session.js';
 import { getConnectSessionTool } from './tools/get-connect-session.js';
 import { createApiKeyTool } from './tools/create-api-key.js';
@@ -211,6 +212,21 @@ server.tool(
   }
 );
 
+server.tool(
+  connectAccountTool.name,
+  connectAccountTool.description,
+  connectAccountTool.inputSchema.shape,
+  getToolAnnotations(connectAccountTool.name),
+  async (input) => {
+    try {
+      const text = await connectAccountTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 server.tool(
   createConnectSessionTool.name,
   createConnectSessionTool.description,