posterly-mcp-server 0.43.3 → 0.43.5

package/README.md

@@ -1,10 +1,10 @@
 # posterly MCP Server
 
-Use Posterly from any MCP-compatible AI client.
+Use posterly from any MCP-compatible AI client.
 
 This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP clients a `stdio` server that can:
 
-- start paid Posterly signup before an API key exists
+- start paid posterly signup before an API key exists
 - poll signup progress while the user completes checkout and password setup
 - list connected social accounts
 - resolve brands/clients into the right accounts
@@ -34,13 +34,13 @@ name is `io.github.awpthorp/posterly`, matching this package's `mcpName`.
 
 - Node.js `20+`
 - No API key is required for the public setup tools: `get_mcp_status`, `get_agent_signup_info`, `start_signup`, and `get_signup_session`
-- A Posterly account, API add-on, and API key are required for authenticated tools like `whoami`, `list_accounts`, `create_connect_session`, and `create_post`
+- A posterly account, API add-on, and API key are required for authenticated tools like `whoami`, `list_accounts`, `create_connect_session`, and `create_post`
 
 ## Install
 
 Recommended: use it via `npx` in your MCP config so your client runs the current server without a global install.
 
-To let an AI agent start signup before a Posterly API key exists, install the server without `POSTERLY_API_KEY`:
+To let an AI agent start signup before a posterly API key exists, install the server without `POSTERLY_API_KEY`:
 
 ```json
 {
@@ -53,7 +53,7 @@ To let an AI agent start signup before a Posterly API key exists, install the se
 }
 ```
 
-After paid signup is complete and Posterly shows an API key, add `POSTERLY_API_KEY` to unlock the authenticated tools:
+After paid signup is complete and posterly shows an API key, add `POSTERLY_API_KEY` to unlock the authenticated tools:
 
 ```json
 {
@@ -71,16 +71,16 @@ After paid signup is complete and Posterly shows an API key, add `POSTERLY_API_K
 
 ## Quick setup
 
-1. Add the Posterly MCP server to your AI client.
-2. If you do not have Posterly yet, ask the AI to call `start_signup`.
-3. Pay in Stripe Checkout and set your Posterly password in the browser.
-4. When Posterly shows your API key, add it as `POSTERLY_API_KEY`.
+1. Add the posterly MCP server to your AI client.
+2. If you do not have posterly yet, ask the AI to call `start_signup`.
+3. Pay in Stripe Checkout and set your posterly password in the browser.
+4. When posterly shows your API key, add it as `POSTERLY_API_KEY`.
 5. Restart your AI client.
 6. Ask the AI to call `get_mcp_status`, then `whoami`, then continue by connecting your first social account.
 
 The signup and connect tools return user-facing next steps by default, so agents should report progress in plain language instead of showing raw curl, HTTP payloads, or JSON. Pass `debug: true` to `start_signup`, `get_signup_session`, `get_connect_link`, `create_connect_session`, or `get_connect_session` only when troubleshooting.
 
-Post tools return `View in Posterly` dashboard links. After scheduling, listing, reading, or deleting posts, share the returned link with the user. Current-month scheduled posts open in Calendar with the post selected; broader/future post views use Table.
+Post tools return `View in posterly` dashboard links. After scheduling, listing, reading, or deleting posts, share the returned link with the user. Current-month scheduled posts open in Calendar with the post selected; broader/future post views use Table.
 
 ## Example configs
 
@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.43.3` exposes 90 tools.
+`posterly-mcp-server@0.43.5` exposes 90 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -196,7 +196,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `list_conversations` (Instagram and Facebook Page inbox DMs; Threads has no DMs)
 - `get_conversation`
 - `send_message` (DM reply after explicit confirmation; honors Meta 24-hour windows)
-- `list_comments` (Instagram, Facebook Page, and Threads inbox comments)
+- `list_comments` (Instagram, Facebook Page, Threads, and LinkedIn Page inbox comments)
 - `get_comment`
 - `reply_to_comment` (comment reply after explicit confirmation)
 - `update_comment` (hide/unhide or mark read; hide is reversible)
@@ -245,19 +245,19 @@ The brand tools let an assistant work at the same level a human does:
 This makes prompts like:
 
 - "How is Grassroots doing on Instagram?"
-- "Write a post for the Posterly brand voice"
+- "Write a post for the posterly brand voice"
 - "Schedule something for our Dubai dental client"
 
 much more reliable than forcing the agent to guess from raw account handles alone.
 
 ## Example prompts
 
-- `What Posterly accounts do I have connected?`
+- `What posterly accounts do I have connected?`
 - `Disconnect the old Instagram account after I confirm the exact account ID`
-- `List my brands in Posterly`
+- `List my brands in posterly`
 - `Show me the brand profile for Grassroots`
 - `Find the next 3 posting slots for my LinkedIn account`
-- `Schedule a post for tomorrow at 9am for the Posterly Instagram account`
+- `Schedule a post for tomorrow at 9am for the posterly Instagram account`
 - `Pause post 971 after I confirm it is the right scheduled post`
 - `Schedule this as an Instagram Story with a first comment and @partner as collaborator`
 - `Schedule this YouTube video as unlisted, add the thumbnail URL, and put it in our launch playlist`
@@ -268,7 +268,7 @@ much more reliable than forcing the agent to guess from raw account handles alon
 
 ## Pricing
 
-This package uses the Posterly API/MCP add-on:
+This package uses the posterly API/MCP add-on:
 
 - `$3/month` add-on
 - `100 create-post requests/hour` per API key, with separate media/read limits
@@ -312,5 +312,5 @@ npm start
 
 The package reads:
 
-- optional `POSTERLY_API_KEY` for authenticated Posterly tools
+- optional `POSTERLY_API_KEY` for authenticated posterly tools
 - optional `POSTERLY_URL` if you need to point at a non-production environment

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

@@ -128,6 +128,15 @@ export interface DismissSuggestionResponse {
     ok: boolean;
     status: string;
 }
+export type ApiPostApprovalStatus = 'none' | 'pending_client' | 'approved' | 'changes_requested' | 'rejected';
+export interface ApiPostApproval {
+    status: ApiPostApprovalStatus;
+    asset_status: ApiPostApprovalStatus;
+    caption_status: ApiPostApprovalStatus;
+    waiting_on: 'client' | 'team' | null;
+    requested_at: string | null;
+    completed_at: string | null;
+}
 export interface Post {
     id: number;
     content: string;
@@ -144,6 +153,9 @@ export interface Post {
     reel_cover_url?: string | null;
     reel_cover_method?: string | null;
     reel_thumb_offset?: number | null;
+    brand_id?: string | null;
+    content_plan_id?: string | null;
+    approval?: ApiPostApproval;
 }
 export interface InstagramPostSettings {
     __type?: 'instagram' | 'instagram-standalone';
@@ -1090,6 +1102,8 @@ export declare class PosterlyClient {
         limit?: number;
         offset?: number;
         workspace_id?: string;
+        approval_status?: string;
+        brand_id?: string;
     }): Promise<{
         posts: Post[];
         total: number;

package/dist/lib/api-client.js

@@ -68,7 +68,7 @@ export class PosterlyClient {
     }
     requireApiKey() {
         if (!this.apiKey) {
-            throw new Error('Posterly access is not installed yet. Use start_signup to begin paid setup, or set POSTERLY_API_KEY after signup.');
+            throw new Error('posterly access is not installed yet. Use start_signup to begin paid setup, or set POSTERLY_API_KEY after signup.');
         }
     }
     async request(method, path, body) {
@@ -257,6 +257,10 @@ export class PosterlyClient {
             searchParams.set('offset', String(params.offset));
         if (params?.workspace_id)
             searchParams.set('workspace_id', params.workspace_id);
+        if (params?.approval_status)
+            searchParams.set('approval_status', params.approval_status);
+        if (params?.brand_id)
+            searchParams.set('brand_id', params.brand_id);
         const qs = searchParams.toString();
         return this.request('GET', `/posts${qs ? `?${qs}` : ''}`);
     }
@@ -742,7 +746,7 @@ export function validatePosterlyBaseUrlForKeyUse(baseUrl) {
     if (!check.trustedPosterlyHost &&
         !check.localDevelopmentHost &&
         !flagEnabled('POSTERLY_ALLOW_CUSTOM_BASE_URL')) {
-        throw new Error(`Refusing to send an API key to custom host ${baseUrl}. Set POSTERLY_ALLOW_CUSTOM_BASE_URL=true only for a trusted Posterly deployment.`);
+        throw new Error(`Refusing to send an API key to custom host ${baseUrl}. Set POSTERLY_ALLOW_CUSTOM_BASE_URL=true only for a trusted posterly deployment.`);
     }
 }
 function parseJson(text) {

package/dist/lib/format.js

@@ -85,7 +85,7 @@ export function mdSuccess(title, rows, nextStep) {
 }
 export function mdError(message) {
     return [
-        mdTitle('⚠️ Posterly tool error'),
+        mdTitle('⚠️ posterly tool error'),
         `**Message:** ${message}`,
     ].join('\n');
 }

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.43.3";
+export declare const POSTERLY_MCP_VERSION = "0.43.5";

package/dist/lib/version.js

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.43.3';
+export const POSTERLY_MCP_VERSION = '0.43.5';

package/dist/tools/ask-support.js

@@ -17,7 +17,7 @@ function formatSupportAnswer(result) {
         supportAccess.ticket_created && result.ticket?.id ? `Ticket: ${result.ticket.id} (${result.ticket.status})` : '',
     ].filter(Boolean);
     return [
-        mdTitle('Posterly Support'),
+        mdTitle('posterly Support'),
         mdQuote(result.message?.content || 'No support answer returned.'),
         sources.length ? mdSection('Sources', mdBullets(sources)) : '',
         mdSection('Status', mdBullets(status)),
@@ -27,7 +27,7 @@ const supportInputSchema = 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.'),
+    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.'),
@@ -42,7 +42,7 @@ async function executeSupport(client, input) {
 }
 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.',
+    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: supportInputSchema,
     execute: executeSupport,
 };

package/dist/tools/create-api-key.js

@@ -20,7 +20,7 @@ function formatCreatedApiKey(result) {
 }
 export const createApiKeyTool = {
     name: 'create_api_key',
-    description: 'Create a new Posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys.',
+    description: 'Create a new posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys.',
     inputSchema: z.object({
         name: z.string().trim().min(1).max(120).optional().describe('Human-readable key name.'),
         scopes: z.array(scopeSchema).min(1).max(8).optional().describe('Scopes for the new key. Omit to copy the calling key scopes. Cannot exceed the calling key scopes. billing:read and billing:write allow managing the posterly subscription (cancel/pause/resume/downgrade).'),

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

@@ -3,7 +3,7 @@ import { DASHBOARD_CONNECT_URL, formatConnectedAccounts, formatLocalDateTime } f
 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. 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.',
+    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)
@@ -30,7 +30,7 @@ export const createConnectSessionTool = {
 function formatConnectSession(session, includeRaw) {
     const connected = session.connected_count ?? session.connected_accounts?.length ?? 0;
     return [
-        `Posterly connect session created: ${session.id}`,
+        `posterly connect session created: ${session.id}`,
         `Platform: ${session.platform}`,
         `Status: ${session.status}`,
         `Message: ${session.status_message}`,
@@ -41,7 +41,7 @@ function formatConnectSession(session, includeRaw) {
         `Expires: ${formatLocalDateTime(session.expires_at)}`,
         `Dashboard connect page: ${DASHBOARD_CONNECT_URL}`,
         '',
-        '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.',
+        '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.js

@@ -136,11 +136,11 @@ export const createPostPayloadInputSchema = z.object({
         .string()
         .optional()
         .describe('ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.'),
-    media_url: z.string().optional().describe('Media URL to attach. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into Posterly storage before the post is saved. Short-lived signed URLs must still be live when this tool runs. For threads, attaches to the lead post only.'),
+    media_url: z.string().optional().describe('Media URL to attach. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved. Short-lived signed URLs must still be live when this tool runs. For threads, attaches to the lead post only.'),
     media_urls: z
         .array(z.string())
         .optional()
-        .describe('Multiple media URLs for carousel or multi-image posts. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into Posterly storage before the post is saved. For TikTok, 2 or more images auto-create a photo slideshow (up to 35 images) and every image is posted.'),
+        .describe('Multiple media URLs for carousel or multi-image posts. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved. For TikTok, 2 or more images auto-create a photo slideshow (up to 35 images) and every image is posted.'),
     post_type: z
         .string()
         .optional()
@@ -216,9 +216,9 @@ 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' +
+        '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' +
-        'MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into Posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media_from_url` first if you want to upload once and reuse the returned Posterly URL across posts.\n\n' +
+        'MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media_from_url` first if you want to upload once and reuse the returned posterly URL across posts.\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/brandPartner, LinkedIn document titles/mentions/polls/content_call_to_action_label (including BUY_NOW and SHOP_NOW), TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/title/link/product_tags, GBP event/offer/CTA/recurrence, X reply settings/polls/paid_partnership, Threads reply controls/text attachments/ghost posts/spoilers/reply approvals/GIPHY, Telegram polls/buttons/video cover/live photo, Slack markdown/blocks, Mastodon visibility/quote/poll (media+poll allowed), and Instagram feed/story/reel/carousel/native media tags/collaborators/first comments/trial Reels/is_ai_generated/audio_id. For Instagram, @username in caption is only a caption mention; `user_tags` creates native media tags and `collaborators` sends co-author invitations only when the selected Meta-linked account reports those capabilities. Call `get_platform_schema` with the account ID first. `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.',
@@ -242,7 +242,7 @@ export const createPostTool = {
             `• Type: ${p.post_type}`,
             `• Status: ${p.status}`,
             `• Scheduled: ${when}`,
-            `• View in Posterly: ${dashboardUrl}`,
+            `• View in posterly: ${dashboardUrl}`,
         ];
         if (thread_posts) {
             lines.push(`• Thread: ${thread_posts.length} posts`);
@@ -259,7 +259,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.');
+        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

@@ -8,7 +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' +
+        '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
@@ -32,7 +32,7 @@ export const createPostsBatchTool = {
             `• Created: ${result.created}`,
             `• Replayed: ${result.replayed}`,
             `• Failed: ${result.failed}`,
-            `• View in Posterly: ${dashboardUrl}`,
+            `• View in posterly: ${dashboardUrl}`,
         ];
         for (const item of result.posts.slice(0, 25)) {
             const post = item.post;

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

@@ -5,7 +5,7 @@ export declare const createWebhookTool: {
     description: string;
     inputSchema: z.ZodObject<{
         url: z.ZodString;
-        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced"]>, "many">>;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced", "approval.requested", "approval.approved", "approval.changes_requested", "approval.rejected", "approval.commented"]>, "many">>;
         workspace_id: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         is_active: z.ZodOptional<z.ZodBoolean>;
@@ -15,14 +15,14 @@ export declare const createWebhookTool: {
         confirm: true;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }, {
         url: string;
         confirm: true;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }>;
     execute(client: PosterlyClient, input: {

package/dist/tools/delete-api-key.js

@@ -14,7 +14,7 @@ function formatDeletedApiKey(result) {
 }
 export const deleteApiKeyTool = {
     name: 'delete_api_key',
-    description: 'Revoke a Posterly API key owned by the authenticated user. DESTRUCTIVE: call whoami or use a known key ID, show the user the exact key ID/prefix/name if available, and get explicit confirmation before calling. Cannot revoke the key currently authenticating this request, OAuth-issued keys, or managed assistant keys.',
+    description: 'Revoke a posterly API key owned by the authenticated user. DESTRUCTIVE: call whoami or use a known key ID, show the user the exact key ID/prefix/name if available, and get explicit confirmation before calling. Cannot revoke the key currently authenticating this request, OAuth-issued keys, or managed assistant keys.',
     inputSchema: z.object({
         key_id: z.string().uuid().describe('API key ID to revoke. This is the API key resource ID, not the secret pst_live_ value.'),
         confirm: z.literal(true).describe('Must be true after the user explicitly confirms API key revocation.'),

package/dist/tools/delete-post.js

@@ -15,8 +15,8 @@ export const deletePostTool = {
         const result = await client.deletePost(input.post_id);
         return [
             `Post #${result.id} deleted successfully.`,
-            'It has been removed from the Posterly queue.',
-            `View queue in Posterly: ${dashboardUrlForPosts()}`,
+            'It has been removed from the posterly queue.',
+            `View queue in posterly: ${dashboardUrlForPosts()}`,
             '',
             'Next step for the AI agent: tell the user the post is gone and offer to create, reschedule, or review the next post.',
         ].join('\n');

package/dist/tools/generate-captions.js

@@ -38,7 +38,7 @@ export const generateCaptionsTool = {
         preserve_call_to_action: z.boolean().default(true).optional(),
         social_account_id: z.string().optional().describe('Optional connected account ID for brand voice and workspace billing context.'),
         workspace_id: z.string().optional(),
-        manual_brand_voice: manualBrandVoiceSchema.optional().describe('Use when Posterly asks for brand voice input.'),
+        manual_brand_voice: manualBrandVoiceSchema.optional().describe('Use when posterly asks for brand voice input.'),
     }),
     async execute(client, input) {
         if (input.mode === 'adapt' && !input.source_caption?.trim()) {

package/dist/tools/generate-image.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { mdKeyValue, mdTitle } from '../lib/format.js';
 export const generateImageTool = {
     name: 'generate_image',
-    description: 'Queue an AI image job via Posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll get_image_job until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price.\n\n' +
+    description: 'Queue an AI image job via posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll get_image_job until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price.\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, quality/thinking, resolution) 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' +

package/dist/tools/get-agent-signup-info.js

@@ -1,14 +1,14 @@
 import { z } from 'zod';
 export const getAgentSignupInfoTool = {
     name: 'get_agent_signup_info',
-    description: 'Explain how to use Posterly MCP for agent-led signup before an API key exists, including the safe human-in-the-browser boundaries.',
+    description: 'Explain how to use posterly MCP for agent-led signup before an API key exists, including the safe human-in-the-browser boundaries.',
     inputSchema: z.object({}),
     async execute(client) {
         const authState = client.hasApiKey()
-            ? 'Posterly API key is installed. Authenticated scheduling and connect tools are available.'
-            : 'No Posterly API key is installed. Only public setup tools are available until the user completes paid setup and gives this AI Posterly access.';
+            ? 'posterly API key is installed. Authenticated scheduling and connect tools are available.'
+            : 'No posterly API key is installed. Only public setup tools are available until the user completes paid setup and gives this AI posterly access.';
         return [
-            'Posterly agent signup info',
+            'posterly agent signup info',
             '',
             authState,
             '',
@@ -17,7 +17,7 @@ export const getAgentSignupInfoTool = {
             '- start_signup: starts paid signup and returns a signup poll URL, a browser Checkout fallback, and, when enabled, a prepaid PaymentIntent for a Link virtual card (credential_type: card).',
             '- get_signup_session: polls payment, password, and agent-access status.',
             '',
-            'After Posterly access is installed, onboard the user IN THIS chat (do not send them to /onboarding-v2):',
+            'After posterly access is installed, onboard the user IN THIS chat (do not send them to /onboarding-v2):',
             '- whoami: confirm the paid account and read onboarding.next_step.',
             '- About you: confirm name and IANA timezone.',
             '- create_connect_session / get_connect_session: first social account in the browser.',
@@ -26,17 +26,17 @@ export const getAgentSignupInfoTool = {
             '',
             'Conversation style:',
             '- Keep the user updated in plain language: checkout pending, payment confirmed, password setup needed, account connected, post scheduled.',
-            '- Prefer the Posterly dashboard links returned by tools when the user wants to inspect posts.',
+            '- Prefer the posterly dashboard links returned by tools when the user wants to inspect posts.',
             '- Do not narrate raw curl, HTTP, JSON, API keys, or implementation details unless the user explicitly asks for debugging.',
             '',
             'Boundaries:',
             '- Payment happens on Stripe Checkout, either by the user in their browser or by the agent with its own approved payment credential (for example a Link agent wallet); never card details in chat.',
             '- Where enabled, payment can instead be a one-time Link Agent Wallet virtual card (credential_type: card) on a prepaid PaymentIntent.',
             '- Never send card numbers to posterly. Confirm the PaymentIntent with Stripe, or send checkout_redirect_url.',
-            '- The user sets their Posterly password in their browser.',
+            '- The user sets their posterly password in their browser.',
             '- The user approves social OAuth in their browser.',
             '- Publish approval stays with the user.',
-            '- The AI should never ask for card details, Posterly passwords, social passwords, or OAuth codes.',
+            '- The AI should never ask for card details, posterly passwords, social passwords, or OAuth codes.',
         ].join('\n');
     },
 };

package/dist/tools/get-comment.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { formatLocalDateTime } from '../lib/format.js';
 export const getCommentTool = {
     name: 'get_comment',
-    description: 'Get one social inbox comment and its replies. Instagram, Facebook Page, and Threads comments. Requires a Pro plan or higher plus posts:read.',
+    description: 'Get one social inbox comment and its replies. Instagram, Facebook Page, Threads, and LinkedIn Page comments. Requires a Pro plan or higher plus posts:read.',
     inputSchema: z.object({
         comment_id: z.string().min(1).describe('Comment ID from list_comments.'),
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),

package/dist/tools/get-connect-link.js

@@ -29,7 +29,7 @@ export const getConnectLinkTool = {
         }
         const options = result.connect_options || [];
         const lines = options.map((option) => formatConnectOption(option, false));
-        return `Posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
+        return `posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
     },
 };
 function formatConnectOption(option, includeRaw) {

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { DASHBOARD_CONNECT_URL, formatConnectedAccounts, formatLocalDateTime } from '../lib/format.js';
 export const getConnectSessionTool = {
     name: 'get_connect_session',
-    description: 'Poll a Posterly connect session. Use the returned status and next-step guidance to keep the user updated in plain language. Stop when status is connected, failed, cancelled, or expired.',
+    description: 'Poll a posterly connect session. Use the returned status and next-step guidance to keep the user updated in plain language. Stop when status is connected, failed, cancelled, or expired.',
     inputSchema: z.object({
         session_id: z.string().describe('Connect session ID returned by create_connect_session.'),
         debug: z
@@ -18,7 +18,7 @@ export const getConnectSessionTool = {
 function formatConnectSession(session, includeRaw) {
     const connected = session.connected_count ?? session.connected_accounts?.length ?? 0;
     return [
-        `Posterly connect session: ${session.id}`,
+        `posterly connect session: ${session.id}`,
         `Platform: ${session.platform}`,
         `Status: ${session.status}`,
         `Message: ${session.status_message}`,
@@ -37,9 +37,9 @@ function guidanceForStatus(session) {
         case 'created':
         case 'opened':
         case 'awaiting_provider':
-            return 'Next step for the AI agent: tell the user Posterly is waiting for browser approval, then keep polling this session. Do not ask for social passwords or OAuth codes.';
+            return 'Next step for the AI agent: tell the user posterly is waiting for browser approval, then keep polling this session. Do not ask for social passwords or OAuth codes.';
         case 'awaiting_credentials':
-            return 'Next step for the AI agent: tell the user Posterly needs them to finish the browser credential step, then keep polling. Do not ask the user to paste credentials into chat.';
+            return 'Next step for the AI agent: tell the user posterly needs them to finish the browser credential step, then keep polling. Do not ask the user to paste credentials into chat.';
         case 'connected':
             return `Next step for the AI agent: tell the user ${formatConnectedAccounts(session.connected_accounts)} is connected, then ask what they want to schedule first or offer to create a test post.`;
         case 'failed':

package/dist/tools/get-mcp-status.js

@@ -5,7 +5,7 @@ import { code, mdKeyValue, mdTitle } from '../lib/format.js';
 const NPM_LATEST_URL = 'https://registry.npmjs.org/posterly-mcp-server/latest';
 export const getMcpStatusTool = {
     name: 'get_mcp_status',
-    description: 'Report the Posterly MCP server version, latest npm version, MCP endpoint health, API key health, and update guidance. Safe to call before POSTERLY_API_KEY is configured.',
+    description: 'Report the posterly MCP server version, latest npm version, MCP endpoint health, API key health, and update guidance. Safe to call before POSTERLY_API_KEY is configured.',
     inputSchema: z.object({}),
     async execute(client) {
         const apiOrigin = client.getBaseUrl();
@@ -21,7 +21,7 @@ export const getMcpStatusTool = {
             ['Current server version', POSTERLY_MCP_VERSION],
             ['Latest npm version', latest.version || 'unknown'],
             ['Update status', updateStatus],
-            ['Posterly API origin', code(apiOrigin)],
+            ['posterly API origin', code(apiOrigin)],
             ['MCP endpoint health', formatApiProbe(apiProbe)],
             ['Hosted MCP version', apiProbe.version || 'unknown'],
             ['Version match', versionMatch],
@@ -32,7 +32,7 @@ export const getMcpStatusTool = {
             rows.push(['User', authProbe.whoami.user.email || code(authProbe.whoami.user.id)], ['Default workspace', `${authProbe.whoami.default_workspace.name} (${code(authProbe.whoami.default_workspace.id)})`], ['API scopes', authProbe.whoami.api_key.scopes.join(', ') || 'none']);
         }
         return [
-            mdTitle('Posterly MCP status'),
+            mdTitle('posterly MCP status'),
             mdKeyValue(rows),
             latest.error ? `**Latest check:** ${latest.error}` : '',
             apiProbe.error ? `**MCP endpoint check:** ${apiProbe.error}` : '',
@@ -142,7 +142,7 @@ function nextStep(input) {
         return '**Next step:** Add `POSTERLY_API_KEY` after activating API and MCP access, then call `whoami`.';
     }
     if (authProbe && !authProbe.ok) {
-        return '**Next step:** Create or reinstall a valid Posterly API key, then restart the MCP client and call `get_mcp_status` again.';
+        return '**Next step:** Create or reinstall a valid posterly API key, then restart the MCP client and call `get_mcp_status` again.';
     }
     return '**Next step:** Call `whoami` to confirm the user, workspace, and scopes before scheduling posts.';
 }

package/dist/tools/get-post.js

@@ -15,7 +15,7 @@ export const getPostTool = {
             `• Caption: ${p.content || '(empty)'}`,
             `• Type: ${p.post_type || 'unknown'}`,
             `• Scheduled: ${formatLocalDateTime(p.scheduled_at)}`,
-            `• View in Posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`,
+            `• View in posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`,
         ];
         if (p.platform_post_url)
             lines.push(`• Published URL: ${p.platform_post_url}`);

package/dist/tools/get-signup-session.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const getSignupSessionTool = {
     name: 'get_signup_session',
-    description: 'Poll a public Posterly signup session created by start_signup. Use this to narrate payment (Link virtual card or browser Checkout), password setup, and agent access status before a Posterly API key is installed. Keep updates user-facing; do not narrate raw HTTP, curl, or API plumbing.',
+    description: 'Poll a public posterly signup session created by start_signup. Use this to narrate payment (Link virtual card or browser Checkout), password setup, and agent access status before a posterly API key is installed. Keep updates user-facing; do not narrate raw HTTP, curl, or API plumbing.',
     inputSchema: z.object({
         session_id: z
             .string()
@@ -26,7 +26,7 @@ function formatSignupSession(session, includeRaw) {
     const agentPay = session.agent_pay;
     const payment = session.payment;
     const lines = [
-        `Posterly signup session: ${session.id}`,
+        `posterly signup session: ${session.id}`,
         `Status: ${session.status}`,
         session.status_message ? `Message: ${session.status_message}` : '',
         nextAction?.label ? `Next action: ${nextAction.label}` : '',
@@ -72,15 +72,15 @@ function guidanceForStatus(status, agentPayAvailable = false, requiresTosAccepta
         case 'checkout_expired':
             return 'Tell the user checkout expired and offer to call start_signup again.';
         case 'payment_confirmed':
-            return 'Tell the user payment is confirmed and Posterly is preparing access. Keep polling.';
+            return 'Tell the user payment is confirmed and posterly is preparing access. Keep polling.';
         case 'password_required':
-            return 'Tell the user Posterly has sent a password setup email. They need to open that email and set a password in the browser.';
+            return 'Tell the user posterly has sent a password setup email. They need to open that email and set a password in the browser.';
         case 'authorize_agent':
-            return 'Tell the user Posterly is ready for agent authorization. Send them the provided authorization or completion link if one is present.';
+            return 'Tell the user posterly is ready for agent authorization. Send them the provided authorization or completion link if one is present.';
         case 'agent_access_required':
-            return 'Tell the user API access is active, but this AI still needs Posterly access. Ask them to paste the Posterly MCP/API setup instructions here or install the Posterly MCP server. Then onboard them IN THIS chat: about you, connect, brand voice, first post. Do not send them to /onboarding-v2.';
+            return 'Tell the user API access is active, but this AI still needs posterly access. Ask them to paste the posterly MCP/API setup instructions here or install the posterly MCP server. Then onboard them IN THIS chat: about you, connect, brand voice, first post. Do not send them to /onboarding-v2.';
         case 'api_access_active':
-            return 'Posterly API access is active. Call whoami, then onboard them IN THIS chat: about you (name and timezone), connect the first account, brand voice, first post. Do not send them to /onboarding-v2.';
+            return 'posterly API access is active. Call whoami, then onboard them IN THIS chat: about you (name and timezone), connect the first account, brand voice, first post. Do not send them to /onboarding-v2.';
         default:
             return 'Explain the current status to the user and keep polling unless the session is terminal.';
     }

package/dist/tools/list-accounts.js

@@ -14,7 +14,7 @@ export const listAccountsTool = {
         if (accounts.length === 0) {
             return input.workspace_id
                 ? mdEmpty('connected accounts', 'This workspace does not have any social accounts connected yet.')
-                : mdEmpty('connected accounts', 'Posterly does not see any connected social accounts yet.', 'Connect accounts in the Posterly dashboard, then run this again.');
+                : mdEmpty('connected accounts', 'posterly does not see any connected social accounts yet.', 'Connect accounts in the posterly dashboard, then run this again.');
         }
         const hasInstagram = accounts.some((account) => account.platform === 'instagram');
         return [