posterly-mcp-server 0.19.6 → 0.19.7

package/README.md

@@ -103,7 +103,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.19.6` exposes 54 tools.
+`posterly-mcp-server@0.19.7` exposes 54 tools.
 
 Public signup tools work before `POSTERLY_API_KEY` exists:
 

package/dist/index.js

@@ -58,7 +58,7 @@ import { updateOAuthClientTool } from './tools/update-oauth-client.js';
 import { deleteOAuthClientTool } from './tools/delete-oauth-client.js';
 const server = new McpServer({
     name: 'posterly',
-    version: '0.19.6',
+    version: '0.19.7',
 });
 const client = new PosterlyClient();
 // Register tools

package/dist/lib/format.d.ts

@@ -0,0 +1,11 @@
+import type { Account, Post } from './api-client.js';
+export declare const DASHBOARD_CALENDAR_URL: string;
+export declare const DASHBOARD_TABLE_URL: string;
+export declare const DASHBOARD_CONNECT_URL: string;
+export declare function formatLocalDateTime(value?: string | null): string;
+export declare function dashboardUrlForPost(post: Pick<Post, 'id' | 'scheduled_at'>): string;
+export declare function dashboardUrlForPosts(): string;
+export declare function dashboardUrlForPostList(posts: Array<Pick<Post, 'scheduled_at'>>): string;
+export declare function truncateText(value: string | null | undefined, max?: number): string;
+export declare function formatAccountLabel(account: Account): string;
+export declare function formatConnectedAccounts(accounts?: Account[]): string;

package/dist/lib/format.js

@@ -0,0 +1,51 @@
+const POSTERLY_APP_URL = (process.env.POSTERLY_URL || 'https://www.poster.ly').replace(/\/$/, '');
+export const DASHBOARD_CALENDAR_URL = `${POSTERLY_APP_URL}/dashboard/calendar`;
+export const DASHBOARD_TABLE_URL = `${POSTERLY_APP_URL}/dashboard/table`;
+export const DASHBOARD_CONNECT_URL = `${POSTERLY_APP_URL}/dashboard/connect`;
+export function formatLocalDateTime(value) {
+    if (!value)
+        return 'N/A';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toLocaleString();
+}
+export function dashboardUrlForPost(post) {
+    const baseUrl = isInCurrentMonth(post.scheduled_at) ? DASHBOARD_CALENDAR_URL : DASHBOARD_TABLE_URL;
+    const url = new URL(baseUrl);
+    url.searchParams.set('post_id', String(post.id));
+    return url.toString();
+}
+export function dashboardUrlForPosts() {
+    return DASHBOARD_TABLE_URL;
+}
+export function dashboardUrlForPostList(posts) {
+    if (posts.length > 0 && posts.every((post) => isInCurrentMonth(post.scheduled_at))) {
+        return DASHBOARD_CALENDAR_URL;
+    }
+    return DASHBOARD_TABLE_URL;
+}
+export function truncateText(value, max = 80) {
+    const text = value?.trim() || '';
+    if (!text)
+        return '(empty)';
+    return text.length > max ? `${text.slice(0, max - 1)}...` : text;
+}
+export function formatAccountLabel(account) {
+    const username = account.username ? `@${account.username}` : `account ${account.id}`;
+    return `${account.platform} ${username}`;
+}
+export function formatConnectedAccounts(accounts) {
+    if (!accounts?.length)
+        return 'none yet';
+    return accounts.map(formatAccountLabel).join(', ');
+}
+function isInCurrentMonth(value) {
+    if (!value)
+        return false;
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return false;
+    const now = new Date();
+    return date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth();
+}

package/dist/tools/create-connect-session.d.ts

@@ -7,18 +7,22 @@ export declare const createConnectSessionTool: {
         platform: z.ZodEnum<["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"]>;
         workspace_id: z.ZodOptional<z.ZodString>;
         auto_start: z.ZodOptional<z.ZodBoolean>;
+        debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
+        debug?: boolean | undefined;
     }, {
         platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
+        debug?: boolean | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         platform: string;
         workspace_id?: string;
         auto_start?: boolean;
+        debug?: boolean;
     }): Promise<string>;
 };

package/dist/tools/create-connect-session.js

@@ -1,8 +1,9 @@
 import { z } from 'zod';
+import { DASHBOARD_CONNECT_URL, formatConnectedAccounts, formatLocalDateTime } from '../lib/format.js';
 import { CONNECT_INPUTS } from '../generated/platform-manifest.js';
 export const createConnectSessionTool = {
     name: 'create_connect_session',
-    description: 'Create a short-lived Posterly dashboard handoff session for connecting a social account. Open connect_session.connect_url for the user, then poll get_connect_session to narrate progress.',
+    description: 'Create a short-lived Posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll get_connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; Posterly handles those browser steps.',
     inputSchema: z.object({
         platform: z
             .enum(CONNECT_INPUTS)
@@ -15,24 +16,32 @@ export const createConnectSessionTool = {
             .boolean()
             .optional()
             .describe('When true, the dashboard starts the provider flow after the user opens the URL. Defaults to true.'),
+        debug: z
+            .boolean()
+            .optional()
+            .describe('When true, include the raw connect session JSON for debugging. Keep false for normal user-facing agent flows.'),
     }),
     async execute(client, input) {
-        const result = await client.createConnectSession(input);
-        return formatConnectSession(result.connect_session, true);
+        const { debug, ...payload } = input;
+        const result = await client.createConnectSession(payload);
+        return formatConnectSession(result.connect_session, Boolean(debug));
     },
 };
 function formatConnectSession(session, includeRaw) {
+    const connected = session.connected_count ?? session.connected_accounts?.length ?? 0;
     return [
-        `Posterly connect session: ${session.id}`,
+        `Posterly connect session created: ${session.id}`,
         `Platform: ${session.platform}`,
         `Status: ${session.status}`,
         `Message: ${session.status_message}`,
-        `Connection URL: ${session.connect_url}`,
+        `Secure connection URL: ${session.connect_url}`,
         `Poll URL: ${session.poll_url}`,
-        `Connected accounts: ${session.connected_count ?? session.connected_accounts?.length ?? 0}`,
-        `Expires: ${session.expires_at}`,
+        `Connected accounts: ${connected}`,
+        `Accounts: ${formatConnectedAccounts(session.connected_accounts)}`,
+        `Expires: ${formatLocalDateTime(session.expires_at)}`,
+        `Dashboard connect page: ${DASHBOARD_CONNECT_URL}`,
         '',
-        'Next step: Open the connection URL for the user, then call get_connect_session with this session ID until the status is terminal.',
+        'Next step for the AI agent: send the secure connection URL to the user, explain that Posterly will handle the browser OAuth step, then poll get_connect_session until the account is connected or the session ends.',
         includeRaw ? `\nRaw connect session:\n${JSON.stringify(session, null, 2)}` : '',
     ].filter(Boolean).join('\n');
 }

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

@@ -36,8 +36,10 @@ export declare const instagramSettingsSchema: z.ZodObject<{
     reel_cover_url: z.ZodOptional<z.ZodString>;
     reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    __type?: "instagram" | "instagram-standalone" | undefined;
     post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+    reel_cover_url?: string | undefined;
+    reel_thumb_offset?: number | undefined;
+    __type?: "instagram" | "instagram-standalone" | undefined;
     is_trial_reel?: boolean | undefined;
     graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
     collaborators?: (string | {
@@ -52,11 +54,11 @@ export declare const instagramSettingsSchema: z.ZodObject<{
     })[] | undefined;
     first_comment?: string | undefined;
     media_alt_texts?: Record<string, string> | undefined;
+}, {
+    post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
     reel_cover_url?: string | undefined;
     reel_thumb_offset?: number | undefined;
-}, {
     __type?: "instagram" | "instagram-standalone" | undefined;
-    post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
     is_trial_reel?: boolean | undefined;
     graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
     collaborators?: (string | {
@@ -71,8 +73,6 @@ export declare const instagramSettingsSchema: z.ZodObject<{
     })[] | undefined;
     first_comment?: string | undefined;
     media_alt_texts?: Record<string, string> | undefined;
-    reel_cover_url?: string | undefined;
-    reel_thumb_offset?: number | undefined;
 }>;
 export declare const platformSettingsSchema: z.ZodObject<{
     __type: z.ZodOptional<z.ZodString>;
@@ -265,8 +265,10 @@ export declare const createPostInputSchema: z.ZodObject<{
         reel_cover_url: z.ZodOptional<z.ZodString>;
         reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        __type?: "instagram" | "instagram-standalone" | undefined;
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+        __type?: "instagram" | "instagram-standalone" | undefined;
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
@@ -281,11 +283,11 @@ export declare const createPostInputSchema: z.ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
+    }, {
+        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
         reel_cover_url?: string | undefined;
         reel_thumb_offset?: number | undefined;
-    }, {
         __type?: "instagram" | "instagram-standalone" | undefined;
-        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
@@ -300,8 +302,6 @@ export declare const createPostInputSchema: z.ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
-        reel_cover_url?: string | undefined;
-        reel_thumb_offset?: number | undefined;
     }>>;
     platform_settings: z.ZodOptional<z.ZodObject<{
         __type: z.ZodOptional<z.ZodString>;
@@ -453,16 +453,18 @@ export declare const createPostInputSchema: z.ZodObject<{
     workspace_id?: string | undefined;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
-    post_type?: string | undefined;
-    username?: string | undefined;
-    caption?: 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?: {
-        __type?: "instagram" | "instagram-standalone" | undefined;
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+        __type?: "instagram" | "instagram-standalone" | undefined;
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
@@ -477,8 +479,6 @@ export declare const createPostInputSchema: z.ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
-        reel_cover_url?: string | undefined;
-        reel_thumb_offset?: number | undefined;
     } | undefined;
     platform_settings?: z.objectOutputType<{
         __type: z.ZodOptional<z.ZodString>;
@@ -533,16 +533,18 @@ export declare const createPostInputSchema: z.ZodObject<{
     workspace_id?: string | undefined;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
-    post_type?: string | undefined;
-    username?: string | undefined;
-    caption?: 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?: {
-        __type?: "instagram" | "instagram-standalone" | undefined;
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+        __type?: "instagram" | "instagram-standalone" | undefined;
         is_trial_reel?: boolean | undefined;
         graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
         collaborators?: (string | {
@@ -557,8 +559,6 @@ export declare const createPostInputSchema: z.ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
-        reel_cover_url?: string | undefined;
-        reel_thumb_offset?: number | undefined;
     } | undefined;
     platform_settings?: z.objectInputType<{
         __type: z.ZodOptional<z.ZodString>;
@@ -661,8 +661,10 @@ export declare const createPostTool: {
             reel_cover_url: z.ZodOptional<z.ZodString>;
             reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            __type?: "instagram" | "instagram-standalone" | undefined;
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+            reel_cover_url?: string | undefined;
+            reel_thumb_offset?: number | undefined;
+            __type?: "instagram" | "instagram-standalone" | undefined;
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
@@ -677,11 +679,11 @@ export declare const createPostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
+        }, {
+            post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
             reel_cover_url?: string | undefined;
             reel_thumb_offset?: number | undefined;
-        }, {
             __type?: "instagram" | "instagram-standalone" | undefined;
-            post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
@@ -696,8 +698,6 @@ export declare const createPostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
-            reel_cover_url?: string | undefined;
-            reel_thumb_offset?: number | undefined;
         }>>;
         platform_settings: z.ZodOptional<z.ZodObject<{
             __type: z.ZodOptional<z.ZodString>;
@@ -849,16 +849,18 @@ export declare const createPostTool: {
         workspace_id?: string | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
-        post_type?: string | undefined;
-        username?: string | undefined;
-        caption?: 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?: {
-            __type?: "instagram" | "instagram-standalone" | undefined;
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+            reel_cover_url?: string | undefined;
+            reel_thumb_offset?: number | undefined;
+            __type?: "instagram" | "instagram-standalone" | undefined;
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
@@ -873,8 +875,6 @@ export declare const createPostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
-            reel_cover_url?: string | undefined;
-            reel_thumb_offset?: number | undefined;
         } | undefined;
         platform_settings?: z.objectOutputType<{
             __type: z.ZodOptional<z.ZodString>;
@@ -929,16 +929,18 @@ export declare const createPostTool: {
         workspace_id?: string | undefined;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
-        post_type?: string | undefined;
-        username?: string | undefined;
-        caption?: 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?: {
-            __type?: "instagram" | "instagram-standalone" | undefined;
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+            reel_cover_url?: string | undefined;
+            reel_thumb_offset?: number | undefined;
+            __type?: "instagram" | "instagram-standalone" | undefined;
             is_trial_reel?: boolean | undefined;
             graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
             collaborators?: (string | {
@@ -953,8 +955,6 @@ export declare const createPostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
-            reel_cover_url?: string | undefined;
-            reel_thumb_offset?: number | undefined;
         } | undefined;
         platform_settings?: z.objectInputType<{
             __type: z.ZodOptional<z.ZodString>;

package/dist/tools/create-post.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { dashboardUrlForPost, formatLocalDateTime } from '../lib/format.js';
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
 export const instagramSettingsSchema = z.object({
     __type: z.enum(['instagram', 'instagram-standalone']).optional(),
@@ -149,6 +150,7 @@ 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, then prefer `create_posts_batch` so they are created in one API request.\n\n' +
+        'AFTER CALLING: Tell the user the post was created, include the Posterly dashboard link returned by the tool, and offer the next natural action. Do not narrate raw HTTP, curl, or API plumbing.\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.\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.\n\n' +
         'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest post_type (image/video/carousel), board (from pinterest.boards helper), title, link, and cover_image_url (video Pins), GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `instagram_settings` remains as a backwards-compatible alias.',
@@ -159,16 +161,17 @@ export const createPostTool = {
         const result = await client.createPost(payload);
         const p = result.post;
         const ws = result.workspace;
-        const when = p.scheduled_at
-            ? new Date(p.scheduled_at).toLocaleString()
-            : 'now';
+        const when = p.scheduled_at ? formatLocalDateTime(p.scheduled_at) : 'now';
+        const dashboardUrl = dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at });
+        const createdLine = p.scheduled_at ? 'Post scheduled successfully.' : 'Post created successfully.';
         const lines = [
-            'Post created successfully!',
+            createdLine,
             `• ID: ${p.id}`,
             `• Platform: ${p.platform || input.platform || 'unknown'}`,
             `• Type: ${p.post_type}`,
             `• Status: ${p.status}`,
             `• Scheduled: ${when}`,
+            `• View in Posterly: ${dashboardUrl}`,
         ];
         if (thread_posts) {
             lines.push(`• Thread: ${thread_posts.length} posts`);
@@ -185,6 +188,7 @@ export const createPostTool = {
         if (ws) {
             lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
         }
+        lines.push('', 'Next step for the AI agent: tell the user the post is in Posterly, share the dashboard link above, then ask whether they want to create another post, adjust this one, or connect another account.');
         return lines.join('\n');
     },
 };

package/dist/tools/create-posts-batch.d.ts

@@ -51,8 +51,10 @@ export declare const createPostsBatchTool: {
                 reel_cover_url: z.ZodOptional<z.ZodString>;
                 reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
-                __type?: "instagram" | "instagram-standalone" | undefined;
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+                reel_cover_url?: string | undefined;
+                reel_thumb_offset?: number | undefined;
+                __type?: "instagram" | "instagram-standalone" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -67,11 +69,11 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
+            }, {
+                post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
                 reel_cover_url?: string | undefined;
                 reel_thumb_offset?: number | undefined;
-            }, {
                 __type?: "instagram" | "instagram-standalone" | undefined;
-                post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -86,8 +88,6 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
-                reel_cover_url?: string | undefined;
-                reel_thumb_offset?: number | undefined;
             }>>;
             platform_settings: z.ZodOptional<z.ZodObject<{
                 __type: z.ZodOptional<z.ZodString>;
@@ -239,16 +239,18 @@ export declare const createPostsBatchTool: {
             workspace_id?: string | undefined;
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
-            post_type?: string | undefined;
-            username?: string | undefined;
-            caption?: 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?: {
-                __type?: "instagram" | "instagram-standalone" | undefined;
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+                reel_cover_url?: string | undefined;
+                reel_thumb_offset?: number | undefined;
+                __type?: "instagram" | "instagram-standalone" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -263,8 +265,6 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
-                reel_cover_url?: string | undefined;
-                reel_thumb_offset?: number | undefined;
             } | undefined;
             platform_settings?: z.objectOutputType<{
                 __type: z.ZodOptional<z.ZodString>;
@@ -319,16 +319,18 @@ export declare const createPostsBatchTool: {
             workspace_id?: string | undefined;
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
-            post_type?: string | undefined;
-            username?: string | undefined;
-            caption?: 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?: {
-                __type?: "instagram" | "instagram-standalone" | undefined;
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+                reel_cover_url?: string | undefined;
+                reel_thumb_offset?: number | undefined;
+                __type?: "instagram" | "instagram-standalone" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -343,8 +345,6 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
-                reel_cover_url?: string | undefined;
-                reel_thumb_offset?: number | undefined;
             } | undefined;
             platform_settings?: z.objectInputType<{
                 __type: z.ZodOptional<z.ZodString>;
@@ -401,16 +401,18 @@ export declare const createPostsBatchTool: {
             workspace_id?: string | undefined;
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
-            post_type?: string | undefined;
-            username?: string | undefined;
-            caption?: 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?: {
-                __type?: "instagram" | "instagram-standalone" | undefined;
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+                reel_cover_url?: string | undefined;
+                reel_thumb_offset?: number | undefined;
+                __type?: "instagram" | "instagram-standalone" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -425,8 +427,6 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
-                reel_cover_url?: string | undefined;
-                reel_thumb_offset?: number | undefined;
             } | undefined;
             platform_settings?: z.objectOutputType<{
                 __type: z.ZodOptional<z.ZodString>;
@@ -483,16 +483,18 @@ export declare const createPostsBatchTool: {
             workspace_id?: string | undefined;
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
-            post_type?: string | undefined;
-            username?: string | undefined;
-            caption?: 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?: {
-                __type?: "instagram" | "instagram-standalone" | undefined;
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+                reel_cover_url?: string | undefined;
+                reel_thumb_offset?: number | undefined;
+                __type?: "instagram" | "instagram-standalone" | undefined;
                 is_trial_reel?: boolean | undefined;
                 graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
                 collaborators?: (string | {
@@ -507,8 +509,6 @@ export declare const createPostsBatchTool: {
                 })[] | undefined;
                 first_comment?: string | undefined;
                 media_alt_texts?: Record<string, string> | undefined;
-                reel_cover_url?: string | undefined;
-                reel_thumb_offset?: number | undefined;
             } | undefined;
             platform_settings?: z.objectInputType<{
                 __type: z.ZodOptional<z.ZodString>;

package/dist/tools/create-posts-batch.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { dashboardUrlForPostList, formatLocalDateTime } from '../lib/format.js';
 import { buildCreatePostPayload, createPostInputSchema } from './create-post.js';
 export const createPostsBatchTool = {
     name: 'create_posts_batch',
@@ -7,6 +8,7 @@ export const createPostsBatchTool = {
         '1. Call `whoami` at the start of any new session to confirm which workspace and user you are acting for.\n' +
         '2. Show the user a preview of EVERY post: account/platform, final caption or thread text, scheduled time in their timezone, media, platform settings, and workspace.\n' +
         '3. Get explicit confirmation for the whole batch before calling. Do not infer consent from an earlier content plan.\n\n' +
+        'AFTER CALLING: Summarize the batch result in natural language, include the Posterly dashboard link returned by the tool, and avoid narrating raw HTTP, curl, or API plumbing.\n\n' +
         'Each item accepts the same fields as `create_post`, including `thread_posts`, `platform_settings`, `instagram_settings`, media URLs, and workspace_id. The endpoint may partially succeed; failed items are returned with their index.',
     inputSchema: z.object({
         posts: z
@@ -18,21 +20,25 @@ export const createPostsBatchTool = {
     async execute(client, input) {
         const payloads = input.posts.map((post) => buildCreatePostPayload(post));
         const result = await client.createPostsBatch({ posts: payloads });
+        const createdPosts = result.posts.map((item) => item.post);
+        const dashboardUrl = dashboardUrlForPostList(createdPosts);
         const lines = [
             'Batch create completed.',
             `• Total: ${result.total}`,
             `• Created: ${result.created}`,
             `• Replayed: ${result.replayed}`,
             `• Failed: ${result.failed}`,
+            `• View in Posterly: ${dashboardUrl}`,
         ];
         for (const item of result.posts.slice(0, 25)) {
             const post = item.post;
-            const when = post.scheduled_at ? new Date(post.scheduled_at).toLocaleString() : 'now';
+            const when = post.scheduled_at ? formatLocalDateTime(post.scheduled_at) : 'now';
             lines.push(`• [${item.index}] ID ${post.id} ${post.platform || 'unknown'} ${post.post_type || 'post'} ${post.status || 'created'} at ${when}${item.replayed ? ' (replayed)' : ''}`);
         }
         for (const error of result.errors.slice(0, 25)) {
             lines.push(`• [${error.index}] ERROR ${error.status}: ${error.error}`);
         }
+        lines.push('', 'Next step for the AI agent: tell the user which posts were created, share the dashboard link above, and ask whether they want to review the queue, adjust anything, or create the next post.');
         return lines.join('\n');
     },
 };