posterly-mcp-server 0.43.4 → 0.43.6

package/dist/tools/list-brands.js

@@ -14,7 +14,7 @@ export const listBrandsTool = {
         if (brands.length === 0) {
             return input.workspace_id
                 ? mdEmpty('brands', 'This workspace does not have any brands or clients yet.')
-                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the Posterly dashboard, then run this again.');
+                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the posterly dashboard, then run this again.');
         }
         return [
             mdTitle(`Brands (${brands.length})`),

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

@@ -6,13 +6,13 @@ export declare const listCommentsTool: {
     inputSchema: z.ZodObject<{
         workspace_id: z.ZodOptional<z.ZodString>;
         account_id: z.ZodOptional<z.ZodNumber>;
-        platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads"]>>;
+        platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads", "linkedin"]>>;
         filter: z.ZodOptional<z.ZodEnum<["all", "unread", "flagged"]>>;
         search: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        platform?: "instagram" | "facebook" | "threads" | undefined;
+        platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         limit?: number | undefined;
@@ -20,7 +20,7 @@ export declare const listCommentsTool: {
         filter?: "all" | "unread" | "flagged" | undefined;
         search?: string | undefined;
     }, {
-        platform?: "instagram" | "facebook" | "threads" | undefined;
+        platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         limit?: number | undefined;
@@ -31,7 +31,7 @@ export declare const listCommentsTool: {
     execute(client: PosterlyClient, input: {
         workspace_id?: string;
         account_id?: number;
-        platform?: "instagram" | "facebook" | "threads";
+        platform?: "instagram" | "facebook" | "threads" | "linkedin";
         filter?: "all" | "unread" | "flagged";
         search?: string;
         limit?: number;

package/dist/tools/list-comments.js

@@ -1,13 +1,13 @@
 import { z } from 'zod';
 import { truncateText } from '../lib/format.js';
-const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads'];
+const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads', 'linkedin'];
 export const listCommentsTool = {
     name: 'list_comments',
-    description: 'List social inbox comments and replies for Instagram, Facebook Pages, and Threads. Filter by account, platform, unread/flagged, or search. Requires a Pro plan or higher plus posts:read.',
+    description: 'List social inbox comments and replies for Instagram, Facebook Pages, Threads, and LinkedIn Pages. Filter by account, platform, unread/flagged, or search. Requires a Pro plan or higher plus posts:read.',
     inputSchema: z.object({
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Social account ID from list_accounts.'),
-        platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram, facebook, or threads.'),
+        platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram, facebook, threads, or linkedin.'),
         filter: z.enum(['all', 'unread', 'flagged']).optional().describe('Comment filter. Defaults to all.'),
         search: z.string().optional().describe('Search comment content or author username.'),
         limit: z.number().int().min(1).max(100).optional().describe('Number of comments to return. Default 50, max 100.'),

package/dist/tools/list-platforms.js

@@ -15,6 +15,6 @@ export const listPlatformsTool = {
             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 `Posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
+        return `posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
     },
 };

package/dist/tools/list-posts.js

@@ -42,7 +42,7 @@ export const listPostsTool = {
             limit: input.limit || 20,
         });
         if (posts.length === 0) {
-            return 'No posts found matching your criteria.\n\nNext step for the AI agent: tell the user their Posterly queue is clear for that filter, then ask what they want to schedule next.';
+            return 'No posts found matching your criteria.\n\nNext step for the AI agent: tell the user their posterly queue is clear for that filter, then ask what they want to schedule next.';
         }
         const lines = posts.map((p) => {
             const date = formatLocalDateTime(p.scheduled_at);
@@ -64,8 +64,8 @@ export const listPostsTool = {
             `Posts (${posts.length} of ${total}):`,
             ...lines,
             '',
-            `View in Posterly: ${dashboardUrlForPostList(posts)}`,
-            'Next step for the AI agent: summarize the queue in plain language and use the dashboard link above if the user wants to inspect it in Posterly.',
+            `View in posterly: ${dashboardUrlForPostList(posts)}`,
+            'Next step for the AI agent: summarize the queue in plain language and use the dashboard link above if the user wants to inspect it in posterly.',
         ].join('\n');
     },
 };

package/dist/tools/reply-to-comment.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const replyToCommentTool = {
     name: 'reply_to_comment',
-    description: 'Reply to an Instagram, Facebook Page, or Threads inbox comment. WRITE: posts to the social network. Facebook has no private comment replies. Threads has no DMs, so only public replies. Instagram supports public or private. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
+    description: 'Reply to an Instagram, Facebook Page, Threads, or LinkedIn Page inbox comment. WRITE: posts to the social network. Facebook has no private comment replies. Threads has no DMs, so only public replies. Instagram supports public or private. LinkedIn Page comments are public replies only. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
     inputSchema: z.object({
         comment_id: z.string().min(1).describe('Comment ID from list_comments.'),
         content: z.string().min(1).describe('Reply text to post.'),

package/dist/tools/start-signup.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 const DEFAULT_RETURN_PATH = '/dashboard/api?api_signup=success';
 export const startSignupTool = {
     name: 'start_signup',
-    description: 'Start the public Posterly paid signup flow for a user before Posterly API access exists. Returns a signup poll URL, a browser Checkout fallback URL, and, when enabled, a prepaid PaymentIntent the agent can pay with a Link Agent Wallet virtual card (credential_type: card). The user still sets a password and approves social OAuth in the browser. Never ask for card numbers, a Posterly password, or social passwords in chat.',
+    description: 'Start the public posterly paid signup flow for a user before posterly API access exists. Returns a signup poll URL, a browser Checkout fallback URL, and, when enabled, a prepaid PaymentIntent the agent can pay with a Link Agent Wallet virtual card (credential_type: card). The user still sets a password and approves social OAuth in the browser. Never ask for card numbers, a posterly password, or social passwords in chat.',
     inputSchema: z.object({
         email: z
             .string()
@@ -11,11 +11,11 @@ export const startSignupTool = {
         name: z
             .string()
             .optional()
-            .describe('Optional user or workspace name to pass into Posterly signup.'),
+            .describe('Optional user or workspace name to pass into posterly signup.'),
         tier: z
             .enum(['starter', 'pro', 'power_user', 'agency'])
             .default('starter')
-            .describe('Posterly plan to start. Use starter unless the user explicitly chooses another plan.'),
+            .describe('posterly plan to start. Use starter unless the user explicitly chooses another plan.'),
         interval: z
             .enum(['month'])
             .default('month')
@@ -27,7 +27,7 @@ export const startSignupTool = {
         return_path: z
             .string()
             .default(DEFAULT_RETURN_PATH)
-            .describe('Where Posterly should continue after checkout and password setup.'),
+            .describe('Where posterly should continue after checkout and password setup.'),
         source: z
             .string()
             .default('posterly_mcp_pre_auth_signup')
@@ -72,7 +72,7 @@ function formatSignupStart(response, includeRaw) {
     const agentPay = response.agent_pay || session?.agent_pay;
     const payment = response.payment || session?.payment;
     const lines = [
-        'Posterly signup started.',
+        'posterly signup started.',
         sessionId ? `Signup session: ${sessionId}` : '',
         `Status: ${status}`,
         message ? `Message: ${message}` : '',
@@ -109,17 +109,17 @@ function formatSignupStart(response, includeRaw) {
                     '1. Prefer agent_pay: confirm the PaymentIntent with a one-time Link Agent Wallet virtual card (credential_type: card). Never paste card numbers into chat or send them to posterly.',
                     '2. If the user would rather pay on the website, send them the Checkout handoff URL instead.',
                     '3. Call get_signup_session with the signup session ID until the status changes.',
-                    '4. Tell the user when Posterly sends the password setup email. Password, social OAuth, and publish approval stay in the browser.',
-                    '5. If status becomes agent_access_required, ask the user to install or paste the Posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
-                    '6. Do not ask for card details, the Posterly password, social passwords, or OAuth codes.',
+                    '4. Tell the user when posterly sends the password setup email. Password, social OAuth, and publish approval stay in the browser.',
+                    '5. If status becomes agent_access_required, ask the user to install or paste the posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
+                    '6. Do not ask for card details, the posterly password, social passwords, or OAuth codes.',
                 ]
                 : [
                     '1. If you hold an approved payment credential such as a Link agent wallet, you can pay the Checkout handoff URL yourself: create a spend request for the amount and merchant above, get the user\'s approval in the wallet, then complete the Checkout page with that credential. Never paste card numbers into chat or send them to posterly.',
                     '2. Otherwise, send the Checkout handoff URL to the user so they can pay securely in their browser. Use the raw Stripe checkout URL only if you preserve the full URL including any fragment. posterly does not email this link, so do not tell the user to check their inbox at this stage.',
                     '3. Call get_signup_session with the signup session ID until the status changes.',
-                    '4. Tell the user when Posterly sends the password setup email.',
-                    '5. If status becomes agent_access_required, ask the user to install or paste the Posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
-                    '6. Do not ask for card details, the Posterly password, social passwords, or OAuth codes.',
+                    '4. Tell the user when posterly sends the password setup email.',
+                    '5. If status becomes agent_access_required, ask the user to install or paste the posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
+                    '6. Do not ask for card details, the posterly password, social passwords, or OAuth codes.',
                 ]),
         includeRaw ? `\nRaw signup response:\n${JSON.stringify(response, null, 2)}` : '',
     ];

package/dist/tools/sync-inbox.js

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 export const syncInboxTool = {
     name: 'sync_inbox',
-    description: 'Pull the latest Instagram, Facebook Page, or Threads inbox data for one connected account. Honors a 30-second cooldown. Threads syncs replies only (no DMs). Requires a Pro plan or higher plus posts:write.',
+    description: 'Pull the latest Instagram, Facebook Page, Threads, or LinkedIn inbox data for one connected account. Honors a 30-second cooldown (60 seconds for LinkedIn). Threads and LinkedIn sync comments only (no DMs). Requires a Pro plan or higher plus posts:write.',
     inputSchema: z.object({
         account_id: z.number().int().positive().describe('Social account ID from list_accounts.'),
-        sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('What to sync. Defaults to all. Threads is comments-only.'),
+        sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('What to sync. Defaults to all. Threads and LinkedIn are comments-only.'),
         workspace_id: z.string().optional().describe('Workspace ID from whoami.'),
     }),
     async execute(client, input) {

package/dist/tools/update-post.js

@@ -116,8 +116,8 @@ export const updatePostTool = {
             .string()
             .optional()
             .describe('New scheduled time (ISO 8601, e.g. 2026-03-10T09:00:00Z)'),
-        media_url: z.string().optional().describe('New media URL. 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.'),
-        media_urls: z.array(z.string()).optional().describe('New media URLs for carousel. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into Posterly storage before the post is saved.'),
+        media_url: z.string().optional().describe('New media URL. 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.'),
+        media_urls: z.array(z.string()).optional().describe('New media URLs for carousel. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved.'),
         post_type: z
             .string()
             .optional()

package/dist/tools/upload-media-from-url.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const uploadMediaFromUrlTool = {
     name: 'upload_media_from_url',
-    description: 'Fetch an image or video from a public HTTPS URL into Posterly storage. Returns a URL that can be used with create_post. You can also pass public HTTP(S) media URLs directly to create_post/update_post; use this tool when you want to upload once and reuse the returned Posterly URL.',
+    description: 'Fetch an image or video from a public HTTPS URL into posterly storage. Returns a URL that can be used with create_post. You can also pass public HTTP(S) media URLs directly to create_post/update_post; use this tool when you want to upload once and reuse the returned posterly URL.',
     inputSchema: z.object({
         url: z.string().url().describe('Public HTTPS URL for the image or video. Local/private network URLs are blocked.'),
         filename: z.string().optional().describe('Optional filename override.'),

package/dist/tools/whoami.js

@@ -7,7 +7,7 @@ export const whoamiTool = {
     async execute(client) {
         const info = await client.whoami();
         return [
-            mdTitle('Posterly identity'),
+            mdTitle('posterly identity'),
             mdKeyValue([
                 ['User', info.user.email || code(info.user.id)],
                 ['API scopes', info.api_key.scopes.join(', ') || 'none'],

package/package.json

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

package/server.json

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

package/src/lib/api-client.ts

@@ -1109,7 +1109,7 @@ export class PosterlyClient {
   private requireApiKey(): void {
     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.'
+        'posterly access is not installed yet. Use start_signup to begin paid setup, or set POSTERLY_API_KEY after signup.'
       );
     }
   }
@@ -2155,7 +2155,7 @@ export function validatePosterlyBaseUrlForKeyUse(baseUrl: string): void {
     !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.`
+      `Refusing to send an API key to custom host ${baseUrl}. Set POSTERLY_ALLOW_CUSTOM_BASE_URL=true only for a trusted posterly deployment.`
     );
   }
 }

package/src/lib/format.ts

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

package/src/lib/version.ts

@@ -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.4';
+export const POSTERLY_MCP_VERSION = '0.43.6';

package/src/tools/ask-support.ts

@@ -20,7 +20,7 @@ function formatSupportAnswer(result: AskSupportResponse): string {
   ].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)),
@@ -31,7 +31,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.'),
@@ -49,7 +49,7 @@ async function executeSupport(client: PosterlyClient, input: AskSupportPayload)
 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.',
+    '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/src/tools/cancel-subscription.ts

@@ -28,11 +28,11 @@ function formatCanceled(result: CancelSubscriptionResponse): string {
 export const cancelSubscriptionTool = {
   name: 'cancel_subscription',
   description:
-    "Cancel the authenticated user's posterly subscription. DESTRUCTIVE billing action; requires the billing:write scope. ALWAYS ask the user why they are cancelling FIRST and pass their answer as `reason` (one of the allowed values). By default the subscription is set to cancel at the end of the current period; pass immediate=true only if the user explicitly wants it cancelled right now. Only call after the user explicitly confirms.",
+    "Cancel the authenticated user's posterly subscription. DESTRUCTIVE billing action; requires the billing:write scope. ALWAYS ask the user why they are cancelling FIRST and pass their answer as `reason` (one of the allowed values). By default an active or trialing plan is set to cancel at the end of the current period. A past_due or unpaid plan always ends now, even when immediate is false: the unpaid renewal is dropped and payment retries stop. Pass immediate=true only when the user explicitly wants an active plan cancelled right now. Only call after the user explicitly confirms.",
   inputSchema: z.object({
     reason: z.enum(CANCELLATION_REASONS).describe('Why the user is cancelling. Ask the user before calling; do not guess.'),
     feedback: z.string().max(2000).optional().describe('Optional free-text detail the user gave about why they are cancelling.'),
-    immediate: z.boolean().optional().describe('Cancel immediately instead of at period end. Defaults to false (cancel at period end).'),
+    immediate: z.boolean().optional().describe('Cancel immediately instead of at period end. Defaults to false. Ignored for past_due and unpaid plans, which always end now.'),
     confirm: z.literal(true).describe('Must be true after the user explicitly confirms the cancellation.'),
   }),
 

package/src/tools/create-api-key.ts

@@ -25,7 +25,7 @@ function formatCreatedApiKey(result: CreateApiKeyResponse): string {
 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.',
+    '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/src/tools/create-connect-session.ts

@@ -6,7 +6,7 @@ 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.',
+    '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)
@@ -38,7 +38,7 @@ export const createConnectSessionTool = {
 function formatConnectSession(session: ConnectSession, includeRaw: boolean): string {
   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}`,
@@ -49,7 +49,7 @@ function formatConnectSession(session: ConnectSession, includeRaw: boolean): str
     `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/src/tools/create-post.ts

@@ -141,11 +141,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()
@@ -235,9 +235,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.',
@@ -268,7 +268,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`);
@@ -287,7 +287,7 @@ export const createPostTool = {
     }
     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.',
+      '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/src/tools/create-posts-batch.ts

@@ -11,7 +11,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
@@ -37,7 +37,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)) {

package/src/tools/delete-api-key.ts

@@ -18,7 +18,7 @@ function formatDeletedApiKey(result: DeleteApiKeyResponse): string {
 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.',
+    '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/src/tools/delete-post.ts

@@ -22,8 +22,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/src/tools/generate-captions.ts

@@ -43,7 +43,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: PosterlyClient, input: GenerateCaptionsPayload) {

package/src/tools/generate-image.ts

@@ -5,7 +5,7 @@ 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' +
+    '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/src/tools/get-agent-signup-info.ts

@@ -4,16 +4,16 @@ import type { PosterlyClient } from '../lib/api-client.js';
 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.',
+    '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: PosterlyClient) {
     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,
       '',
@@ -22,7 +22,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.',
@@ -31,17 +31,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/src/tools/get-comment.ts

@@ -5,7 +5,7 @@ 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.',
+    '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/src/tools/get-connect-link.ts

@@ -37,7 +37,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')}`;
   },
 };
 

package/src/tools/get-connect-session.ts

@@ -5,7 +5,7 @@ import { DASHBOARD_CONNECT_URL, formatConnectedAccounts, formatLocalDateTime } f
 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.',
+    '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
@@ -26,7 +26,7 @@ export const getConnectSessionTool = {
 function formatConnectSession(session: ConnectSession, includeRaw: boolean): string {
   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}`,
@@ -46,9 +46,9 @@ function guidanceForStatus(session: ConnectSession): string {
     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':