posterly-mcp-server 0.20.0 → 0.20.2

package/README.md

@@ -108,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.20.0` exposes 56 tools.
+`posterly-mcp-server@0.20.2` exposes 57 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -139,6 +139,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `list_posts`
 - `get_post`
 - `get_post_missing`
+- `ask_support` (authenticated docs-backed support with read-only account/post diagnostics; human tickets require explicit confirmation)
 - `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
 - `create_posts_batch` (create up to 25 confirmed posts in one API request)
 - `update_post` (also accepts `platform_settings`)
@@ -207,6 +208,7 @@ much more reliable than forcing the agent to guess from raw account handles alon
 - `Post this TikTok with direct-post privacy set to public and stitch disabled`
 - `Schedule these 5 photos as a TikTok` (image posts auto-detect as a photo slideshow of 1 to 35 images, no post type needed)
 - `How did Grassroots perform on Instagram in the last 30 days?`
+- `Ask posterly support why post 3041 failed, but do not raise a human ticket unless I confirm`
 
 ## Pricing
 

package/dist/index.js

@@ -20,6 +20,7 @@ import { listPostsTool } from './tools/list-posts.js';
 import { uploadMediaTool } from './tools/upload-media.js';
 import { getPostTool } from './tools/get-post.js';
 import { getPostMissingTool } from './tools/get-post-missing.js';
+import { askSupportTool } from './tools/ask-support.js';
 import { updatePostTool } from './tools/update-post.js';
 import { updatePostStatusTool } from './tools/update-post-status.js';
 import { updatePostReleaseIdTool } from './tools/update-post-release-id.js';
@@ -389,6 +390,15 @@ server.tool(getPostMissingTool.name, getPostMissingTool.description, getPostMiss
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(askSupportTool.name, askSupportTool.description, askSupportTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await askSupportTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(updatePostTool.name, updatePostTool.description, updatePostTool.inputSchema.shape, async (input) => {
     try {
         const text = await updatePostTool.execute(client, input);

package/dist/lib/api-client.d.ts

@@ -149,6 +149,44 @@ export type GenerateCaptionsResponse = {
     social_account_id?: number | null;
     usage?: Record<string, unknown>;
 };
+export type AskSupportPayload = {
+    question: string;
+    workspace_id?: string;
+    conversation_id?: string;
+    page_url?: string;
+    post_id?: number;
+    referenced_post_ids?: number[];
+    request_human?: boolean;
+    confirm_escalation?: boolean;
+};
+export type AskSupportResponse = {
+    success: boolean;
+    workspace_id: string;
+    conversation: {
+        id: string;
+        status: string;
+        title: string | null;
+    };
+    message: {
+        id: string;
+        role: string;
+        content: string;
+        citations?: unknown[];
+        created_at: string;
+    };
+    ticket?: {
+        id: string;
+        status: string;
+        priority: string;
+        created: boolean;
+    } | null;
+    support_access?: Record<string, unknown>;
+    confidence?: number;
+    docs_confidence?: string;
+    needs_human?: boolean;
+    escalation_reason?: string | null;
+    model?: Record<string, unknown>;
+};
 export interface Slot {
     time: string;
     local_time: string;
@@ -590,6 +628,7 @@ export declare class PosterlyClient {
         posts: CreatePostPayload[];
     }): Promise<BatchCreatePostsResponse>;
     generateCaptions(data: GenerateCaptionsPayload): Promise<GenerateCaptionsResponse>;
+    askSupport(data: AskSupportPayload): Promise<AskSupportResponse>;
     getPost(id: number): Promise<{
         post: Post;
     }>;

package/dist/lib/api-client.js

@@ -85,7 +85,7 @@ export class PosterlyClient {
         const res = await fetch(url, init);
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || `API error: ${res.status}`);
+            throw new Error(formatApiError(res, err));
         }
         return res.json();
     }
@@ -100,7 +100,7 @@ export class PosterlyClient {
         const res = await fetch(url, init);
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || `API error: ${res.status}`);
+            throw new Error(formatApiError(res, err));
         }
         return res.json();
     }
@@ -199,6 +199,9 @@ export class PosterlyClient {
     async generateCaptions(data) {
         return this.request('POST', '/ai/generate-captions', data);
     }
+    async askSupport(data) {
+        return this.request('POST', '/support/chat', data);
+    }
     async getPost(id) {
         return this.request('GET', `/posts/${id}`);
     }
@@ -470,6 +473,24 @@ function formatProbeError(data, fallback, statusText) {
     }
     return fallback || statusText || 'API request failed';
 }
+function formatApiError(res, data) {
+    const message = data?.error || data?.message || `API error: ${res.status}`;
+    if (res.status !== 429) {
+        return message;
+    }
+    const retryAfter = data?.retry_after || res.headers.get('retry-after');
+    const requestId = data?.request_id || res.headers.get('x-request-id');
+    const limit = data?.limit || res.headers.get('x-ratelimit-limit');
+    const reset = data?.reset || res.headers.get('x-ratelimit-reset');
+    return [
+        'Rate limit reached.',
+        retryAfter ? `Try again in ${retryAfter} seconds.` : '',
+        limit ? `Limit: ${limit}.` : '',
+        reset ? `Reset: ${reset}.` : '',
+        requestId ? `Request ID: ${requestId}.` : '',
+        message && message !== 'Rate limit exceeded' ? `Details: ${message}` : '',
+    ].filter(Boolean).join(' ');
+}
 function guessContentType(filename) {
     const ext = filename.split('.').pop()?.toLowerCase();
     const map = {

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.20.0";
+export declare const POSTERLY_MCP_VERSION = "0.20.2";

package/dist/lib/version.js

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.0';
+export const POSTERLY_MCP_VERSION = '0.20.2';

package/dist/tools/ask-support.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { AskSupportPayload, PosterlyClient } from '../lib/api-client.js';
+export declare const askSupportTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        question: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+        page_url: z.ZodOptional<z.ZodString>;
+        post_id: z.ZodOptional<z.ZodNumber>;
+        referenced_post_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        request_human: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        confirm_escalation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        question: string;
+        workspace_id?: string | undefined;
+        post_id?: number | undefined;
+        conversation_id?: string | undefined;
+        page_url?: string | undefined;
+        referenced_post_ids?: number[] | undefined;
+        request_human?: boolean | undefined;
+        confirm_escalation?: boolean | undefined;
+    }, {
+        question: string;
+        workspace_id?: string | undefined;
+        post_id?: number | undefined;
+        conversation_id?: string | undefined;
+        page_url?: string | undefined;
+        referenced_post_ids?: number[] | undefined;
+        request_human?: boolean | undefined;
+        confirm_escalation?: boolean | undefined;
+    }>;
+    execute(client: PosterlyClient, input: AskSupportPayload): Promise<string>;
+};

package/dist/tools/ask-support.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { mdBullets, mdQuote, mdSection, mdTitle } from '../lib/format.js';
+function formatSupportAnswer(result) {
+    const citations = Array.isArray(result.message?.citations) ? result.message.citations : [];
+    const sources = citations.slice(0, 5).map((citation) => {
+        const label = citation.heading || citation.title || citation.slug || citation.url;
+        const parent = citation.heading && citation.title ? ` (${citation.title})` : '';
+        const url = citation.url ? ` - ${citation.url}` : '';
+        return `${label}${parent}${url}`;
+    });
+    const supportAccess = result.support_access || {};
+    const status = [
+        `Conversation: ${result.conversation.id}`,
+        `Confidence: ${typeof result.confidence === 'number' ? `${Math.round(result.confidence * 100)}%` : 'unknown'}`,
+        `Human recommended: ${result.needs_human ? 'yes' : 'no'}`,
+        supportAccess.confirmation_required ? 'Human ticket not created: confirm_escalation=true is required.' : '',
+        supportAccess.ticket_created && result.ticket?.id ? `Ticket: ${result.ticket.id} (${result.ticket.status})` : '',
+    ].filter(Boolean);
+    return [
+        mdTitle('Posterly Support'),
+        mdQuote(result.message?.content || 'No support answer returned.'),
+        sources.length ? mdSection('Sources', mdBullets(sources)) : '',
+        mdSection('Status', mdBullets(status)),
+    ].filter(Boolean).join('\n\n');
+}
+export const askSupportTool = {
+    name: 'ask_support',
+    description: 'Ask Posterly Support AI an authenticated question using Posterly docs plus read-only account/post diagnostics for the caller workspace. Requires POSTERLY_API_KEY with accounts:read and posts:read scopes. Human ticket creation requires request_human=true and confirm_escalation=true after explicit user confirmation.',
+    inputSchema: z.object({
+        question: z.string().trim().min(1).max(4000),
+        workspace_id: z.string().optional().describe('Workspace to inspect. Omit to use the API-key scoped workspace or personal workspace.'),
+        conversation_id: z.string().optional().describe('Continue a previous support conversation.'),
+        page_url: z.string().max(2000).optional().describe('Optional Posterly page URL for context.'),
+        post_id: z.number().int().positive().optional().describe('Optional post ID to inspect directly.'),
+        referenced_post_ids: z.array(z.number().int().positive()).max(5).optional().describe('Optional post IDs to include in read-only diagnostics.'),
+        request_human: z.boolean().default(false).optional().describe('Ask for human review. Does not create a ticket unless confirm_escalation is also true.'),
+        confirm_escalation: z.boolean().default(false).optional().describe('Must be true after explicit user confirmation before a human support ticket can be created.'),
+    }),
+    async execute(client, input) {
+        if (input.confirm_escalation === true && input.request_human !== true) {
+            throw new Error('confirm_escalation=true only has an effect when request_human=true.');
+        }
+        const result = await client.askSupport(input);
+        return formatSupportAnswer(result);
+    },
+};

package/dist/tools/create-post.js

@@ -148,14 +148,14 @@ export function buildCreatePostPayload(input) {
 }
 export const createPostTool = {
     name: 'create_post',
-    description: 'Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, it will be posted publicly and cannot be un-posted.\n\n' +
+    description: 'Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts - once scheduled_at passes, it will be posted publicly and cannot be un-posted.\n\n' +
         'REQUIRED BEFORE CALLING:\n' +
         '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 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' +
+        '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' +
+        '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.\n\n' +
         'TIKTOK MEDIA: TikTok supports a single video or a photo slideshow of 1 to 35 images, never multiple videos. Image media auto-detects as a slideshow, so you usually do not set post_type or media_type for photos and every image is posted. Pass `platform_settings.media_type: "PHOTO"` to force a slideshow explicitly.',
@@ -194,7 +194,7 @@ export const createPostTool = {
             lines.push('• Platform settings: yes');
         }
         if (ws) {
-            lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
+            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.js

@@ -3,7 +3,7 @@ import { dashboardUrlForPostList, formatLocalDateTime } from '../lib/format.js';
 import { buildCreatePostPayload, createPostPayloadInputSchema } from './create-post.js';
 export const createPostsBatchTool = {
     name: 'create_posts_batch',
-    description: 'Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, posts may go public and cannot be un-posted.\n\n' +
+    description: 'Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts - once scheduled_at passes, posts may go public and cannot be un-posted.\n\n' +
         'REQUIRED BEFORE CALLING:\n' +
         '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' +

package/dist/tools/delete-post.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { dashboardUrlForPosts } from '../lib/format.js';
 export const deletePostTool = {
     name: 'delete_post',
-    description: 'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE — the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
+    description: 'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE - the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
         'REQUIRED BEFORE CALLING: Fetch the post with `get_post` first and show the user what will be deleted (caption, account, scheduled time). Get explicit confirmation ("yes delete it", "remove it") before calling. Never delete multiple posts in a single batch without listing each one and confirming the full list.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to delete'),

package/dist/tools/find-slot.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const findSlotTool = {
     name: 'find_available_slot',
-    description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am–10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly — default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
+    description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
     inputSchema: z.object({
         account_ids: z
             .array(z.string())
@@ -11,7 +11,7 @@ export const findSlotTool = {
         timezone: z
             .string()
             .optional()
-            .describe('IANA timezone (e.g. Asia/Dubai, Europe/London). Defaults to America/New_York — pass the user\'s actual timezone or slots will be wrong.'),
+            .describe('IANA timezone (e.g. Asia/Dubai, Europe/London). Defaults to America/New_York - pass the user\'s actual timezone or slots will be wrong.'),
         count: z
             .number()
             .min(1)

package/dist/tools/generate-image.js

@@ -3,8 +3,8 @@ import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/forma
 export const generateImageTool = {
     name: 'generate_image',
     description: 'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
-        'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively — always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
-        'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim — do not retry.\n\n' +
+        'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
+        'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry.\n\n' +
         'Common aspect ratios by platform:\n' +
         '  • Instagram feed / LinkedIn: 1:1 (square) or 4:5 (portrait)\n' +
         '  • Instagram Story/Reel, TikTok, YouTube Shorts: 9:16\n' +
@@ -15,7 +15,7 @@ export const generateImageTool = {
             .string()
             .min(5)
             .max(4000)
-            .describe('Detailed image description. 5–4000 characters. Describe subject, scene, lighting, mood, and style.'),
+            .describe('Detailed image description. 5-4000 characters. Describe subject, scene, lighting, mood, and style.'),
         aspect_ratio: z
             .enum([
             '1:1', '9:16', '4:5', '3:4', '2:3', '1:4', '1:8',
@@ -36,7 +36,7 @@ export const generateImageTool = {
             .min(1)
             .max(4)
             .optional()
-            .describe('How many variations to generate. Default 1. Each variation costs credits separately — prefer 1 unless the user explicitly wants options.'),
+            .describe('How many variations to generate. Default 1. Each variation costs credits separately - prefer 1 unless the user explicitly wants options.'),
         model: z
             .enum(['flash', 'pro'])
             .optional()

package/dist/tools/get-video-job.js

@@ -20,7 +20,7 @@ export const getVideoJobTool = {
 };
 function formatJob(job, includeRaw) {
     const lines = [
-        `${job.id} — ${job.status}`,
+        `${job.id}: ${job.status}`,
         `Prompt: ${job.prompt}`,
         `Model: ${job.model}; duration: ${job.duration_seconds}s; resolution: ${job.resolution || 'n/a'}; cost: ${job.credit_cost}`,
         job.video_url ? `Video URL: ${job.video_url}` : null,

package/dist/tools/list-platforms.js

@@ -13,7 +13,7 @@ export const listPlatformsTool = {
         const result = await client.listPlatforms(input);
         const lines = result.platforms.map((platform) => {
             const helperCount = platform.helper_tools?.length || 0;
-            return `• ${platform.label} (${platform.id}) — ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
+            return `• ${platform.label} (${platform.id}): ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
         });
         return `Posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
     },

package/dist/tools/list-posts.js

@@ -39,7 +39,7 @@ export const listPostsTool = {
         const lines = posts.map((p) => {
             const date = formatLocalDateTime(p.scheduled_at);
             const caption = truncateText(p.content, 60);
-            return `• [${p.status}] #${p.id} — ${caption} (${date})`;
+            return `• [${p.status}] #${p.id}: ${caption} (${date})`;
         });
         return [
             `Posts (${posts.length} of ${total}):`,

package/dist/tools/update-post.js

@@ -58,8 +58,8 @@ const platformSettingsSchema = z.object({
 }).passthrough();
 export const updatePostTool = {
     name: 'update_post',
-    description: 'Update a scheduled or draft post. DESTRUCTIVE WRITE — overwrites the existing post\'s caption/media/schedule. Cannot edit published or currently publishing posts.\n\n' +
-        'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media) and the PROPOSED changes, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction — each edit needs its own confirmation.',
+    description: 'Update a scheduled or draft post. DESTRUCTIVE WRITE - overwrites the existing post\'s caption/media/schedule. Cannot edit published or currently publishing posts.\n\n' +
+        'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media) and the PROPOSED changes, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each edit needs its own confirmation.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to update'),
         caption: z.string().optional().describe('New caption/text content'),

package/dist/tools/upload-media.js

@@ -3,8 +3,8 @@ import { mdError, mdSuccess } from '../lib/format.js';
 export const uploadMediaTool = {
     name: 'upload_media',
     description: 'Upload an image or video file to posterly storage. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB.\n\n' +
-        'This writes to the user\'s media storage (counts against quota) but does NOT publish the file anywhere. Uploading is safe — it\'s the subsequent `create_post` call that publishes content, and that tool has its own confirmation requirements.\n\n' +
-        'IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path — never guess paths.',
+        'This writes to the user\'s media storage (counts against quota) but does NOT publish the file anywhere. Uploading is safe - it\'s the subsequent `create_post` call that publishes content, and that tool has its own confirmation requirements.\n\n' +
+        'IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path - never guess paths.',
     inputSchema: z.object({
         file_path: z
             .string()
@@ -13,7 +13,7 @@ export const uploadMediaTool = {
         base64_data: z
             .string()
             .optional()
-            .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
+            .describe('Base64-encoded file data. PREFERRED for images shared directly in chat - extract the image data as base64 and pass it here.'),
         filename: z
             .string()
             .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),

package/dist/tools/whoami.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { code, mdKeyValue, mdTable, mdTitle } from '../lib/format.js';
 export const whoamiTool = {
     name: 'whoami',
-    description: 'Return the authenticated user, API key scopes, the default (personal) workspace, and every workspace the caller can post in. ALWAYS call this at the start of a session before creating, listing, or scheduling posts — posts created without an explicit workspace_id land in the default workspace shown here, and confirming with the user first prevents posts from appearing in the wrong workspace.',
+    description: 'Return the authenticated user, API key scopes, the default (personal) workspace, and every workspace the caller can post in. ALWAYS call this at the start of a session before creating, listing, or scheduling posts - posts created without an explicit workspace_id land in the default workspace shown here, and confirming with the user first prevents posts from appearing in the wrong workspace.',
     inputSchema: z.object({}),
     async execute(client) {
         const info = await client.whoami();

package/package.json

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

package/src/index.ts

@@ -21,6 +21,7 @@ import { listPostsTool } from './tools/list-posts.js';
 import { uploadMediaTool } from './tools/upload-media.js';
 import { getPostTool } from './tools/get-post.js';
 import { getPostMissingTool } from './tools/get-post-missing.js';
+import { askSupportTool } from './tools/ask-support.js';
 import { updatePostTool } from './tools/update-post.js';
 import { updatePostStatusTool } from './tools/update-post-status.js';
 import { updatePostReleaseIdTool } from './tools/update-post-release-id.js';
@@ -573,6 +574,20 @@ server.tool(
   }
 );
 
+server.tool(
+  askSupportTool.name,
+  askSupportTool.description,
+  askSupportTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await askSupportTool.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(
   updatePostTool.name,
   updatePostTool.description,

package/src/lib/api-client.ts

@@ -152,6 +152,46 @@ export type GenerateCaptionsResponse = {
   usage?: Record<string, unknown>;
 };
 
+export type AskSupportPayload = {
+  question: string;
+  workspace_id?: string;
+  conversation_id?: string;
+  page_url?: string;
+  post_id?: number;
+  referenced_post_ids?: number[];
+  request_human?: boolean;
+  confirm_escalation?: boolean;
+};
+
+export type AskSupportResponse = {
+  success: boolean;
+  workspace_id: string;
+  conversation: {
+    id: string;
+    status: string;
+    title: string | null;
+  };
+  message: {
+    id: string;
+    role: string;
+    content: string;
+    citations?: unknown[];
+    created_at: string;
+  };
+  ticket?: {
+    id: string;
+    status: string;
+    priority: string;
+    created: boolean;
+  } | null;
+  support_access?: Record<string, unknown>;
+  confidence?: number;
+  docs_confidence?: string;
+  needs_human?: boolean;
+  escalation_reason?: string | null;
+  model?: Record<string, unknown>;
+};
+
 export interface Slot {
   time: string;
   local_time: string;
@@ -611,7 +651,7 @@ export class PosterlyClient {
 
     if (!res.ok) {
       const err = await res.json().catch(() => ({ error: res.statusText }));
-      throw new Error(err.error || `API error: ${res.status}`);
+      throw new Error(formatApiError(res, err));
     }
 
     return res.json() as Promise<T>;
@@ -635,7 +675,7 @@ export class PosterlyClient {
 
     if (!res.ok) {
       const err = await res.json().catch(() => ({ error: res.statusText }));
-      throw new Error(err.error || `API error: ${res.status}`);
+      throw new Error(formatApiError(res, err));
     }
 
     return res.json() as Promise<T>;
@@ -779,6 +819,10 @@ export class PosterlyClient {
     return this.request('POST', '/ai/generate-captions', data);
   }
 
+  async askSupport(data: AskSupportPayload): Promise<AskSupportResponse> {
+    return this.request('POST', '/support/chat', data);
+  }
+
   async getPost(id: number): Promise<{ post: Post }> {
     return this.request('GET', `/posts/${id}`);
   }
@@ -1222,6 +1266,27 @@ function formatProbeError(data: any, fallback: string, statusText: string): stri
   return fallback || statusText || 'API request failed';
 }
 
+function formatApiError(res: Response, data: any): string {
+  const message = data?.error || data?.message || `API error: ${res.status}`;
+  if (res.status !== 429) {
+    return message;
+  }
+
+  const retryAfter = data?.retry_after || res.headers.get('retry-after');
+  const requestId = data?.request_id || res.headers.get('x-request-id');
+  const limit = data?.limit || res.headers.get('x-ratelimit-limit');
+  const reset = data?.reset || res.headers.get('x-ratelimit-reset');
+
+  return [
+    'Rate limit reached.',
+    retryAfter ? `Try again in ${retryAfter} seconds.` : '',
+    limit ? `Limit: ${limit}.` : '',
+    reset ? `Reset: ${reset}.` : '',
+    requestId ? `Request ID: ${requestId}.` : '',
+    message && message !== 'Rate limit exceeded' ? `Details: ${message}` : '',
+  ].filter(Boolean).join(' ');
+}
+
 function guessContentType(filename: string): string {
   const ext = filename.split('.').pop()?.toLowerCase();
   const map: Record<string, string> = {

package/src/lib/version.ts

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.0';
+export const POSTERLY_MCP_VERSION = '0.20.2';

package/src/tools/ask-support.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import type { AskSupportPayload, AskSupportResponse, PosterlyClient } from '../lib/api-client.js';
+import { mdBullets, mdQuote, mdSection, mdTitle } from '../lib/format.js';
+
+function formatSupportAnswer(result: AskSupportResponse): string {
+  const citations = Array.isArray(result.message?.citations) ? result.message.citations : [];
+  const sources = citations.slice(0, 5).map((citation: any) => {
+    const label = citation.heading || citation.title || citation.slug || citation.url;
+    const parent = citation.heading && citation.title ? ` (${citation.title})` : '';
+    const url = citation.url ? ` - ${citation.url}` : '';
+    return `${label}${parent}${url}`;
+  });
+  const supportAccess = result.support_access || {};
+  const status = [
+    `Conversation: ${result.conversation.id}`,
+    `Confidence: ${typeof result.confidence === 'number' ? `${Math.round(result.confidence * 100)}%` : 'unknown'}`,
+    `Human recommended: ${result.needs_human ? 'yes' : 'no'}`,
+    supportAccess.confirmation_required ? 'Human ticket not created: confirm_escalation=true is required.' : '',
+    supportAccess.ticket_created && result.ticket?.id ? `Ticket: ${result.ticket.id} (${result.ticket.status})` : '',
+  ].filter(Boolean);
+
+  return [
+    mdTitle('Posterly Support'),
+    mdQuote(result.message?.content || 'No support answer returned.'),
+    sources.length ? mdSection('Sources', mdBullets(sources)) : '',
+    mdSection('Status', mdBullets(status)),
+  ].filter(Boolean).join('\n\n');
+}
+
+export const askSupportTool = {
+  name: 'ask_support',
+  description:
+    'Ask Posterly Support AI an authenticated question using Posterly docs plus read-only account/post diagnostics for the caller workspace. Requires POSTERLY_API_KEY with accounts:read and posts:read scopes. Human ticket creation requires request_human=true and confirm_escalation=true after explicit user confirmation.',
+  inputSchema: z.object({
+    question: z.string().trim().min(1).max(4000),
+    workspace_id: z.string().optional().describe('Workspace to inspect. Omit to use the API-key scoped workspace or personal workspace.'),
+    conversation_id: z.string().optional().describe('Continue a previous support conversation.'),
+    page_url: z.string().max(2000).optional().describe('Optional Posterly page URL for context.'),
+    post_id: z.number().int().positive().optional().describe('Optional post ID to inspect directly.'),
+    referenced_post_ids: z.array(z.number().int().positive()).max(5).optional().describe('Optional post IDs to include in read-only diagnostics.'),
+    request_human: z.boolean().default(false).optional().describe('Ask for human review. Does not create a ticket unless confirm_escalation is also true.'),
+    confirm_escalation: z.boolean().default(false).optional().describe('Must be true after explicit user confirmation before a human support ticket can be created.'),
+  }),
+
+  async execute(client: PosterlyClient, input: AskSupportPayload) {
+    if (input.confirm_escalation === true && input.request_human !== true) {
+      throw new Error('confirm_escalation=true only has an effect when request_human=true.');
+    }
+    const result = await client.askSupport(input);
+    return formatSupportAnswer(result);
+  },
+};

package/src/tools/create-post.ts

@@ -164,14 +164,14 @@ export function buildCreatePostPayload(input: CreatePostPayloadInput | CreatePos
 export const createPostTool = {
   name: 'create_post',
   description:
-    'Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, it will be posted publicly and cannot be un-posted.\n\n' +
+    'Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts - once scheduled_at passes, it will be posted publicly and cannot be un-posted.\n\n' +
     'REQUIRED BEFORE CALLING:\n' +
     '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 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' +
+    '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' +
+    '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.\n\n' +
     'TIKTOK MEDIA: TikTok supports a single video or a photo slideshow of 1 to 35 images, never multiple videos. Image media auto-detects as a slideshow, so you usually do not set post_type or media_type for photos and every image is posted. Pass `platform_settings.media_type: "PHOTO"` to force a slideshow explicitly.',
@@ -217,7 +217,7 @@ export const createPostTool = {
       lines.push('• Platform settings: yes');
     }
     if (ws) {
-      lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
+      lines.push(`• Workspace: ${ws.name} (${ws.id}) - resolved from ${ws.resolved_from}`);
     }
     lines.push(
       '',

package/src/tools/create-posts-batch.ts

@@ -6,7 +6,7 @@ import { buildCreatePostPayload, createPostPayloadInputSchema, type CreatePostPa
 export const createPostsBatchTool = {
   name: 'create_posts_batch',
   description:
-    'Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, posts may go public and cannot be un-posted.\n\n' +
+    'Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts - once scheduled_at passes, posts may go public and cannot be un-posted.\n\n' +
     'REQUIRED BEFORE CALLING:\n' +
     '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' +

package/src/tools/delete-post.ts

@@ -5,7 +5,7 @@ import { dashboardUrlForPosts } from '../lib/format.js';
 export const deletePostTool = {
   name: 'delete_post',
   description:
-    'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE — the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
+    'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE - the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
     'REQUIRED BEFORE CALLING: Fetch the post with `get_post` first and show the user what will be deleted (caption, account, scheduled time). Get explicit confirmation ("yes delete it", "remove it") before calling. Never delete multiple posts in a single batch without listing each one and confirming the full list.',
   inputSchema: z.object({
     post_id: z.number().describe('The post ID to delete'),

package/src/tools/find-slot.ts

@@ -5,7 +5,7 @@ import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const findSlotTool = {
   name: 'find_available_slot',
   description:
-    'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am–10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly — default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
+    'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
   inputSchema: z.object({
     account_ids: z
       .array(z.string())
@@ -14,7 +14,7 @@ export const findSlotTool = {
     timezone: z
       .string()
       .optional()
-      .describe('IANA timezone (e.g. Asia/Dubai, Europe/London). Defaults to America/New_York — pass the user\'s actual timezone or slots will be wrong.'),
+      .describe('IANA timezone (e.g. Asia/Dubai, Europe/London). Defaults to America/New_York - pass the user\'s actual timezone or slots will be wrong.'),
     count: z
       .number()
       .min(1)

package/src/tools/generate-image.ts

@@ -6,8 +6,8 @@ export const generateImageTool = {
   name: 'generate_image',
   description:
     'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
-    'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively — always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
-    'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim — do not retry.\n\n' +
+    'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
+    'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry.\n\n' +
     'Common aspect ratios by platform:\n' +
     '  • Instagram feed / LinkedIn: 1:1 (square) or 4:5 (portrait)\n' +
     '  • Instagram Story/Reel, TikTok, YouTube Shorts: 9:16\n' +
@@ -18,7 +18,7 @@ export const generateImageTool = {
       .string()
       .min(5)
       .max(4000)
-      .describe('Detailed image description. 5–4000 characters. Describe subject, scene, lighting, mood, and style.'),
+      .describe('Detailed image description. 5-4000 characters. Describe subject, scene, lighting, mood, and style.'),
     aspect_ratio: z
       .enum([
         '1:1', '9:16', '4:5', '3:4', '2:3', '1:4', '1:8',
@@ -39,7 +39,7 @@ export const generateImageTool = {
       .min(1)
       .max(4)
       .optional()
-      .describe('How many variations to generate. Default 1. Each variation costs credits separately — prefer 1 unless the user explicitly wants options.'),
+      .describe('How many variations to generate. Default 1. Each variation costs credits separately - prefer 1 unless the user explicitly wants options.'),
     model: z
       .enum(['flash', 'pro'])
       .optional()

package/src/tools/get-video-job.ts

@@ -25,7 +25,7 @@ export const getVideoJobTool = {
 
 function formatJob(job: VideoJob, includeRaw: boolean): string {
   const lines = [
-    `${job.id} — ${job.status}`,
+    `${job.id}: ${job.status}`,
     `Prompt: ${job.prompt}`,
     `Model: ${job.model}; duration: ${job.duration_seconds}s; resolution: ${job.resolution || 'n/a'}; cost: ${job.credit_cost}`,
     job.video_url ? `Video URL: ${job.video_url}` : null,

package/src/tools/list-platforms.ts

@@ -17,7 +17,7 @@ export const listPlatformsTool = {
     const result = await client.listPlatforms(input);
     const lines = result.platforms.map((platform) => {
       const helperCount = platform.helper_tools?.length || 0;
-      return `• ${platform.label} (${platform.id}) — ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
+      return `• ${platform.label} (${platform.id}): ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
     });
 
     return `Posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;

package/src/tools/list-posts.ts

@@ -54,7 +54,7 @@ export const listPostsTool = {
     const lines = posts.map((p) => {
       const date = formatLocalDateTime(p.scheduled_at);
       const caption = truncateText(p.content, 60);
-      return `• [${p.status}] #${p.id} — ${caption} (${date})`;
+      return `• [${p.status}] #${p.id}: ${caption} (${date})`;
     });
 
     return [

package/src/tools/update-post.ts

@@ -63,8 +63,8 @@ const platformSettingsSchema = z.object({
 export const updatePostTool = {
   name: 'update_post',
   description:
-    'Update a scheduled or draft post. DESTRUCTIVE WRITE — overwrites the existing post\'s caption/media/schedule. Cannot edit published or currently publishing posts.\n\n' +
-    'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media) and the PROPOSED changes, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction — each edit needs its own confirmation.',
+    'Update a scheduled or draft post. DESTRUCTIVE WRITE - overwrites the existing post\'s caption/media/schedule. Cannot edit published or currently publishing posts.\n\n' +
+    'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media) and the PROPOSED changes, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each edit needs its own confirmation.',
   inputSchema: z.object({
     post_id: z.number().describe('The post ID to update'),
     caption: z.string().optional().describe('New caption/text content'),

package/src/tools/upload-media.ts

@@ -6,8 +6,8 @@ export const uploadMediaTool = {
   name: 'upload_media',
   description:
     'Upload an image or video file to posterly storage. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB.\n\n' +
-    'This writes to the user\'s media storage (counts against quota) but does NOT publish the file anywhere. Uploading is safe — it\'s the subsequent `create_post` call that publishes content, and that tool has its own confirmation requirements.\n\n' +
-    'IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path — never guess paths.',
+    'This writes to the user\'s media storage (counts against quota) but does NOT publish the file anywhere. Uploading is safe - it\'s the subsequent `create_post` call that publishes content, and that tool has its own confirmation requirements.\n\n' +
+    'IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path - never guess paths.',
   inputSchema: z.object({
     file_path: z
       .string()
@@ -16,7 +16,7 @@ export const uploadMediaTool = {
     base64_data: z
       .string()
       .optional()
-      .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
+      .describe('Base64-encoded file data. PREFERRED for images shared directly in chat - extract the image data as base64 and pass it here.'),
     filename: z
       .string()
       .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),

package/src/tools/whoami.ts

@@ -5,7 +5,7 @@ import { code, mdKeyValue, mdTable, mdTitle } from '../lib/format.js';
 export const whoamiTool = {
   name: 'whoami',
   description:
-    'Return the authenticated user, API key scopes, the default (personal) workspace, and every workspace the caller can post in. ALWAYS call this at the start of a session before creating, listing, or scheduling posts — posts created without an explicit workspace_id land in the default workspace shown here, and confirming with the user first prevents posts from appearing in the wrong workspace.',
+    'Return the authenticated user, API key scopes, the default (personal) workspace, and every workspace the caller can post in. ALWAYS call this at the start of a session before creating, listing, or scheduling posts - posts created without an explicit workspace_id land in the default workspace shown here, and confirming with the user first prevents posts from appearing in the wrong workspace.',
   inputSchema: z.object({}),
 
   async execute(client: PosterlyClient) {