posterly-mcp-server 0.20.2 → 0.20.4

package/README.md

@@ -108,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.20.2` exposes 57 tools.
+`posterly-mcp-server@0.20.4` exposes 58 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -140,6 +140,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `get_post`
 - `get_post_missing`
 - `ask_support` (authenticated docs-backed support with read-only account/post diagnostics; human tickets require explicit confirmation)
+- `get_support` (alias for `ask_support` for agents that look for get-style support tools)
 - `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`)

package/dist/index.js

@@ -20,7 +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 { askSupportTool, getSupportTool } 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';
@@ -399,6 +399,15 @@ server.tool(askSupportTool.name, askSupportTool.description, askSupportTool.inpu
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(getSupportTool.name, getSupportTool.description, getSupportTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await getSupportTool.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/version.d.ts

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

package/dist/lib/version.js

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

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { AskSupportPayload, PosterlyClient } from '../lib/api-client.js';
+declare function executeSupport(client: PosterlyClient, input: AskSupportPayload): Promise<string>;
 export declare const askSupportTool: {
     name: string;
     description: string;
@@ -31,5 +32,39 @@ export declare const askSupportTool: {
         request_human?: boolean | undefined;
         confirm_escalation?: boolean | undefined;
     }>;
-    execute(client: PosterlyClient, input: AskSupportPayload): Promise<string>;
+    execute: typeof executeSupport;
 };
+export declare const getSupportTool: {
+    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: typeof executeSupport;
+};
+export {};

package/dist/tools/ask-support.js

@@ -23,24 +23,32 @@ function formatSupportAnswer(result) {
         mdSection('Status', mdBullets(status)),
     ].filter(Boolean).join('\n\n');
 }
+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.'),
+    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 function executeSupport(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);
+}
 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);
-    },
+    inputSchema: supportInputSchema,
+    execute: executeSupport,
+};
+export const getSupportTool = {
+    name: 'get_support',
+    description: 'Alias for ask_support. Ask Posterly Support AI an authenticated question using Posterly docs plus read-only account/post diagnostics. Human tickets require request_human=true and confirm_escalation=true after explicit user confirmation.',
+    inputSchema: supportInputSchema,
+    execute: executeSupport,
 };

package/package.json

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

package/src/index.ts

@@ -21,7 +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 { askSupportTool, getSupportTool } 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';
@@ -588,6 +588,20 @@ server.tool(
   }
 );
 
+server.tool(
+  getSupportTool.name,
+  getSupportTool.description,
+  getSupportTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await getSupportTool.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/version.ts

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

package/src/tools/ask-support.ts

@@ -27,26 +27,37 @@ function formatSupportAnswer(result: AskSupportResponse): string {
   ].filter(Boolean).join('\n\n');
 }
 
+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.'),
+  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 function executeSupport(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);
+}
+
 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.'),
-  }),
+  inputSchema: supportInputSchema,
+  execute: executeSupport,
+};
 
-  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);
-  },
+export const getSupportTool = {
+  name: 'get_support',
+  description:
+    'Alias for ask_support. Ask Posterly Support AI an authenticated question using Posterly docs plus read-only account/post diagnostics. Human tickets require request_human=true and confirm_escalation=true after explicit user confirmation.',
+  inputSchema: supportInputSchema,
+  execute: executeSupport,
 };