posterly-mcp-server 0.30.0 → 0.32.0

package/README.md

@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.30.0` exposes 76 tools.
+`posterly-mcp-server@0.32.0` exposes 77 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -165,6 +165,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
 - `validate_post` (checks and normalizes a post without creating it; call before requesting confirmation for `create_post`)
 - `submit_agent_feedback` (writes bounded private operational telemetry after a real workflow outcome; never include secrets, prompts, captions, media URLs, or personal data)
+- `submit_product_feedback` (files a product bug/idea/feedback on the public dashboard board after explicit user confirmation; not for tool failures)
 - `create_posts_batch` (create up to 25 confirmed posts in one API request)
 - `update_post` (also accepts `platform_settings`)
 - `update_post_status` (pause, resume, schedule, or draft a post after confirmation)

package/dist/index.js

@@ -22,6 +22,7 @@ import { dismissSuggestionTool } from './tools/dismiss-suggestion.js';
 import { createPostTool } from './tools/create-post.js';
 import { validatePostTool } from './tools/validate-post.js';
 import { submitAgentFeedbackTool } from './tools/submit-agent-feedback.js';
+import { submitProductFeedbackTool } from './tools/submit-product-feedback.js';
 import { createPostsBatchTool } from './tools/create-posts-batch.js';
 import { findSlotTool } from './tools/find-slot.js';
 import { listPostsTool } from './tools/list-posts.js';
@@ -401,6 +402,15 @@ server.tool(submitAgentFeedbackTool.name, submitAgentFeedbackTool.description, s
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(submitProductFeedbackTool.name, submitProductFeedbackTool.description, submitProductFeedbackTool.inputSchema.shape, getToolAnnotations(submitProductFeedbackTool.name), async (input) => {
+    try {
+        const text = await submitProductFeedbackTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(validatePostTool.name, validatePostTool.description, validatePostTool.inputSchema.shape, getToolAnnotations(validatePostTool.name), async (input) => {
     try {
         const text = await validatePostTool.execute(client, input);

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

@@ -219,6 +219,24 @@ export type AgentFeedbackResponse = {
     feedback_id: string;
     request_id: string;
 };
+export type ProductFeedbackPayload = {
+    category: 'bug' | 'idea' | 'feedback';
+    title: string;
+    description?: string;
+    client?: string;
+    confirm: true;
+    source?: 'mcp' | 'cli' | 'rest' | 'skill';
+    context?: {
+        request_id?: string;
+        related_tool?: string;
+    };
+};
+export type ProductFeedbackResponse = {
+    accepted: true;
+    feedback_id: number;
+    board_url: string;
+    request_id: string;
+};
 export type BatchCreatePostsResponse = {
     posts: Array<CreatePostResponse & {
         index: number;
@@ -908,6 +926,7 @@ export declare class PosterlyClient {
     createPost(data: CreatePostPayload): Promise<CreatePostResponse>;
     validatePost(data: CreatePostPayload): Promise<ValidatePostResponse>;
     submitAgentFeedback(data: AgentFeedbackPayload): Promise<AgentFeedbackResponse>;
+    submitProductFeedback(data: ProductFeedbackPayload): Promise<ProductFeedbackResponse>;
     createPostsBatch(data: {
         posts: CreatePostPayload[];
     }): Promise<BatchCreatePostsResponse>;

package/dist/lib/api-client.js

@@ -259,6 +259,9 @@ export class PosterlyClient {
     async submitAgentFeedback(data) {
         return this.request('POST', '/agent-feedback', data);
     }
+    async submitProductFeedback(data) {
+        return this.request('POST', '/feedback', data);
+    }
     async createPostsBatch(data) {
         return this.request('POST', '/posts/batch', data);
     }

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.30.0";
+export declare const POSTERLY_MCP_VERSION = "0.32.0";

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.30.0';
+export const POSTERLY_MCP_VERSION = '0.32.0';

package/dist/tools/add-google-business-media.d.ts

@@ -14,16 +14,16 @@ export declare const addGoogleBusinessMediaTool: {
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
-        source_url: string;
         category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
+        source_url: string;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         location_id?: string | undefined;
         media_format?: "PHOTO" | "VIDEO" | undefined;
     }, {
         confirm: true;
-        source_url: string;
         category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
+        source_url: string;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         location_id?: string | undefined;

package/dist/tools/submit-product-feedback.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const submitProductFeedbackInputSchema: z.ZodObject<{
+    category: z.ZodEnum<["bug", "idea", "feedback"]>;
+    title: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    description: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    client: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    confirm: z.ZodLiteral<true>;
+    source: z.ZodOptional<z.ZodEnum<["mcp", "cli", "rest", "skill"]>>;
+    context: z.ZodOptional<z.ZodObject<{
+        request_id: z.ZodOptional<z.ZodString>;
+        related_tool: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        request_id?: string | undefined;
+        related_tool?: string | undefined;
+    }, {
+        request_id?: string | undefined;
+        related_tool?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    confirm: true;
+    category: "bug" | "idea" | "feedback";
+    description?: string | undefined;
+    source?: "mcp" | "cli" | "rest" | "skill" | undefined;
+    client?: string | undefined;
+    context?: {
+        request_id?: string | undefined;
+        related_tool?: string | undefined;
+    } | undefined;
+}, {
+    title: string;
+    confirm: true;
+    category: "bug" | "idea" | "feedback";
+    description?: string | undefined;
+    source?: "mcp" | "cli" | "rest" | "skill" | undefined;
+    client?: string | undefined;
+    context?: {
+        request_id?: string | undefined;
+        related_tool?: string | undefined;
+    } | undefined;
+}>;
+export type SubmitProductFeedbackInput = z.infer<typeof submitProductFeedbackInputSchema>;
+export declare const submitProductFeedbackTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        category: z.ZodEnum<["bug", "idea", "feedback"]>;
+        title: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        description: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        client: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        confirm: z.ZodLiteral<true>;
+        source: z.ZodOptional<z.ZodEnum<["mcp", "cli", "rest", "skill"]>>;
+        context: z.ZodOptional<z.ZodObject<{
+            request_id: z.ZodOptional<z.ZodString>;
+            related_tool: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            request_id?: string | undefined;
+            related_tool?: string | undefined;
+        }, {
+            request_id?: string | undefined;
+            related_tool?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        confirm: true;
+        category: "bug" | "idea" | "feedback";
+        description?: string | undefined;
+        source?: "mcp" | "cli" | "rest" | "skill" | undefined;
+        client?: string | undefined;
+        context?: {
+            request_id?: string | undefined;
+            related_tool?: string | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        confirm: true;
+        category: "bug" | "idea" | "feedback";
+        description?: string | undefined;
+        source?: "mcp" | "cli" | "rest" | "skill" | undefined;
+        client?: string | undefined;
+        context?: {
+            request_id?: string | undefined;
+            related_tool?: string | undefined;
+        } | undefined;
+    }>;
+    execute(client: PosterlyClient, input: SubmitProductFeedbackInput): Promise<string>;
+};

package/dist/tools/submit-product-feedback.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+const tokenSchema = z.string().regex(/^[a-z0-9][a-z0-9_.:-]{0,63}$/);
+const printableSchema = (maxLength) => z.string().trim().min(1).max(maxLength).refine((value) => !/[\u0000-\u001f\u007f]/.test(value), 'Control characters are not allowed');
+const secretFreeSchema = (maxLength) => printableSchema(maxLength).refine((value) => !/(?:pst_(?:live|test)_|sk-[a-z0-9_-]{12,})/i.test(value), 'Must not contain secrets');
+export const submitProductFeedbackInputSchema = z.object({
+    category: z.enum(['bug', 'idea', 'feedback']),
+    title: secretFreeSchema(120).refine((value) => value.length >= 3, 'Title must be at least 3 characters'),
+    description: secretFreeSchema(4000).optional(),
+    client: printableSchema(80).optional(),
+    confirm: z.literal(true),
+    source: z.enum(['mcp', 'cli', 'rest', 'skill']).optional(),
+    context: z
+        .object({
+        request_id: z.string().regex(/^[a-zA-Z0-9_.:-]{8,80}$/).optional(),
+        related_tool: tokenSchema.optional(),
+    })
+        .strict()
+        .optional(),
+}).strict();
+export const submitProductFeedbackTool = {
+    name: 'submit_product_feedback',
+    description: 'File a product bug, idea, or general feedback on the public posterly feedback board (same board users see in the dashboard). Only call this when the human explicitly asks to report a bug, suggest a feature, or send feedback to posterly. Require confirm=true after they approve the title and category. Never use this for tool failures or retries - use submit_agent_feedback for private operational telemetry. Never include API keys, secrets, captions, media URLs, or personal data about third parties.',
+    inputSchema: submitProductFeedbackInputSchema,
+    async execute(client, input) {
+        if (input.confirm !== true) {
+            return 'Refusing to file product feedback without confirm=true after explicit user approval of the title and category.';
+        }
+        const result = await client.submitProductFeedback({
+            ...input,
+            source: input.source || 'mcp',
+        });
+        return [
+            'Product feedback filed on the public board.',
+            `• Feedback ID: ${result.feedback_id}`,
+            `• Board: ${result.board_url}`,
+            `• Request ID: ${result.request_id}`,
+        ].join('\n');
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "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.30.0",
+  "version": "0.32.0",
   "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.30.0",
+      "version": "0.32.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -23,6 +23,7 @@ import { dismissSuggestionTool } from './tools/dismiss-suggestion.js';
 import { createPostTool } from './tools/create-post.js';
 import { validatePostTool } from './tools/validate-post.js';
 import { submitAgentFeedbackTool } from './tools/submit-agent-feedback.js';
+import { submitProductFeedbackTool } from './tools/submit-product-feedback.js';
 import { createPostsBatchTool } from './tools/create-posts-batch.js';
 import { findSlotTool } from './tools/find-slot.js';
 import { listPostsTool } from './tools/list-posts.js';
@@ -615,6 +616,21 @@ server.tool(
   }
 );
 
+server.tool(
+  submitProductFeedbackTool.name,
+  submitProductFeedbackTool.description,
+  submitProductFeedbackTool.inputSchema.shape,
+  getToolAnnotations(submitProductFeedbackTool.name),
+  async (input) => {
+    try {
+      const text = await submitProductFeedbackTool.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(
   validatePostTool.name,
   validatePostTool.description,

package/src/lib/api-client.ts

@@ -223,6 +223,26 @@ export type AgentFeedbackResponse = {
   request_id: string;
 };
 
+export type ProductFeedbackPayload = {
+  category: 'bug' | 'idea' | 'feedback';
+  title: string;
+  description?: string;
+  client?: string;
+  confirm: true;
+  source?: 'mcp' | 'cli' | 'rest' | 'skill';
+  context?: {
+    request_id?: string;
+    related_tool?: string;
+  };
+};
+
+export type ProductFeedbackResponse = {
+  accepted: true;
+  feedback_id: number;
+  board_url: string;
+  request_id: string;
+};
+
 export type BatchCreatePostsResponse = {
   posts: Array<CreatePostResponse & { index: number; replayed: boolean }>;
   errors: Array<{ index: number; status: number; error: string; validation_errors?: unknown }>;
@@ -1168,6 +1188,10 @@ export class PosterlyClient {
     return this.request('POST', '/agent-feedback', data);
   }
 
+  async submitProductFeedback(data: ProductFeedbackPayload): Promise<ProductFeedbackResponse> {
+    return this.request('POST', '/feedback', data);
+  }
+
   async createPostsBatch(data: { posts: CreatePostPayload[] }): Promise<BatchCreatePostsResponse> {
     return this.request('POST', '/posts/batch', data);
   }

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.30.0';
+export const POSTERLY_MCP_VERSION = '0.32.0';

package/src/tools/submit-product-feedback.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+const tokenSchema = z.string().regex(/^[a-z0-9][a-z0-9_.:-]{0,63}$/);
+const printableSchema = (maxLength: number) =>
+  z.string().trim().min(1).max(maxLength).refine(
+      (value) => !/[\u0000-\u001f\u007f]/.test(value),
+      'Control characters are not allowed',
+    );
+
+const secretFreeSchema = (maxLength: number) =>
+  printableSchema(maxLength).refine(
+    (value) => !/(?:pst_(?:live|test)_|sk-[a-z0-9_-]{12,})/i.test(value),
+    'Must not contain secrets',
+  );
+
+export const submitProductFeedbackInputSchema = z.object({
+  category: z.enum(['bug', 'idea', 'feedback']),
+  title: secretFreeSchema(120).refine((value) => value.length >= 3, 'Title must be at least 3 characters'),
+  description: secretFreeSchema(4000).optional(),
+  client: printableSchema(80).optional(),
+  confirm: z.literal(true),
+  source: z.enum(['mcp', 'cli', 'rest', 'skill']).optional(),
+  context: z
+    .object({
+      request_id: z.string().regex(/^[a-zA-Z0-9_.:-]{8,80}$/).optional(),
+      related_tool: tokenSchema.optional(),
+    })
+    .strict()
+    .optional(),
+}).strict();
+
+export type SubmitProductFeedbackInput = z.infer<typeof submitProductFeedbackInputSchema>;
+
+export const submitProductFeedbackTool = {
+  name: 'submit_product_feedback',
+  description:
+    'File a product bug, idea, or general feedback on the public posterly feedback board (same board users see in the dashboard). Only call this when the human explicitly asks to report a bug, suggest a feature, or send feedback to posterly. Require confirm=true after they approve the title and category. Never use this for tool failures or retries - use submit_agent_feedback for private operational telemetry. Never include API keys, secrets, captions, media URLs, or personal data about third parties.',
+  inputSchema: submitProductFeedbackInputSchema,
+
+  async execute(client: PosterlyClient, input: SubmitProductFeedbackInput) {
+    if (input.confirm !== true) {
+      return 'Refusing to file product feedback without confirm=true after explicit user approval of the title and category.';
+    }
+    const result = await client.submitProductFeedback({
+      ...input,
+      source: input.source || 'mcp',
+    });
+    return [
+      'Product feedback filed on the public board.',
+      `• Feedback ID: ${result.feedback_id}`,
+      `• Board: ${result.board_url}`,
+      `• Request ID: ${result.request_id}`,
+    ].join('\n');
+  },
+};

package/tool-annotations.json

@@ -35,6 +35,7 @@
     "list_post_suggestions",
     "dismiss_suggestion",
     "submit_agent_feedback",
+    "submit_product_feedback",
     "validate_post",
     "create_post",
     "create_posts_batch",